InstallComponentW-Funktion

Installiert ein Ausnahmepaket.

Syntax

void InstallComponentW(
  _In_           LPCWSTR InfPath,
  _In_opt_ const GUID    *CompGuid,
  _In_           DWORD   Flags,
  _In_opt_       INT     VerMajor,
  _In_opt_       INT     VerMinor,
  _In_opt_       INT     VerBuild,
  _In_opt_       INT     VerQFE,
  _In_opt_       LPCWSTR Name
);

Parameter

InfPath [in]

Der Pfad zur zu verarbeitenden Ausnahme INF.

CompGuid [in, optional]

Die GUID der zu installierenden Ausnahmekomponente.

Flaggen [in]

Die Flags, die zum Steuern des Installationsverhaltens verwendet werden. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
COMP_FLAGS_FORCE 0x00000020	Überspringt die Versionsüberprüfung bei Dateiersetzungen.
COMP_FLAGS_NEEDS_UNINSTALL	Sichern Sie Dateien, die aktualisiert werden, um durch eine Deinstallation der Komponente verwendet zu werden.
COMP_FLAGS_NO_OVERWRITE	Überspringt das Sichern von Dateien, wenn die Version der Ausnahmekomponente mit einer installierten Komponente identisch ist. Dieses Flag wird in einem Neuinstallationsszenario verwendet.
COMP_FLAGS_NOUI 0x00000002	Unterdrückt die gesamte Benutzeroberfläche.
COMP_FLAGS_UPDATE_DLLCACHE	Erzwingt, dass das DLLCACHE-Verzeichnis aktualisiert wird, wenn eine Systemdatei aktualisiert wird.
COMP_FLAGS_USE_SVCPACK_CACHE	Verwendet Dateien, die von einer Windows Service Pack-Installation zwischengespeichert werden, um gesicherte Dateien zu ersetzen.

 

VerMajor [in, optional]

Die Hauptversion der Ausnahmekomponente.

VerMinor [in, optional]

Die Nebenversion der Ausnahmekomponente.

VerBuild [in, optional]

Die Buildversion der Ausnahmekomponente.

VerQFE [in, optional]

Die Hotfixrevision der Exception-Komponente.

Name [in, optional]

Die beschreibende Zeichenfolge der Komponente, die im Dialogfeld Windows-Dateischutz angezeigt wird, wenn das Betriebssystem erkennt, dass eine Windows File Protection-Schutzdatei beschädigt, manipuliert oder beschädigt ist.

Rückgabewert

Diese Funktion gibt einen HRESULT-Wert (S_OK oder einen Fehlercode) zurück. Ein Fehlercode kann anhand des Werts 0x20000100 überprüft werden, um zu bestimmen, ob der Fehler darauf zurückzuführen ist, dass ein Neustart erforderlich ist.

Bemerkungen

Ausnahmepakete sind Windows-Systemdateien, die außerhalb eines vollständigen Windows-Pakets veröffentlicht werden und Betriebssystemdateien aktualisieren. Ausnahmepakete werden nur von Betriebssystemteams erstellt, denen die Autorisierung zum Aktualisieren von Windows-Systemdateien erteilt wurde.

Verwenden Sie die unter Allgemeine Setupfunktionen dokumentierten Funktionen, um Dateien zu installieren und zu deinstallieren, die nicht durch den Windows-Dateischutz geschützt sind. Um Gerätetreiber zu installieren, sollten Händler Funktionen verwenden, die unter Geräteinstallationsfunktionen und PnP Configuration Manager Functions dokumentiert sind.

Diese Funktion verfügt über keine zugeordnete Importbibliothek oder Headerdatei. Sie müssen sie mit den Funktionen LoadLibrary und GetProcAddress aufrufen.

Anforderungen