Methode Product.ComponentState

Die Eigenschaft ComponentState ist der Installationszustand der Komponente für die Instanz dieses Produkts.

Diese Eigenschaft ruft MsiQueryComponentState mit ProductCode, UserSid und Context des Objekts auf. Die Komponenten-ID-GUID wird als Parameter bereitgestellt.

Syntax

Product.ComponentState(
  ID
)

Parameter

ID

Komponentencode-GUID der Komponente, wie sie in der Spalte ComponentID der Tabelle Component gefunden wird.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Wenn der Aufruf erfolgreich ist, enthält die Eigenschaft den Wert als DWORD.

State	Bedeutung
INSTALLSTATE_LOCAL	Die Komponente wird lokal installiert.
INSTALLSTATE_SOURCE	Die Komponente wird installiert, um von der Quelle aus auszuführen.

 

Wenn der Aufruf fehlschlägt, enthält die Eigenschaft einen Fehlercode aus MsiQueryComponentState.

Fehler	Bedeutung
ERROR_ACCESS_DENIED	Der aufrufende Prozess muss über Administratorrechte verfügen, um Informationen für einen anderen Benutzer als den aktuellen Benutzer abzurufen.
ERROR_BAD_CONFIGURATION	Die Konfigurationsdaten sind beschädigt.
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben.
ERROR_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_UNKNOWN_COMPONENT	Die Komponenten-ID identifiziert keine bekannte Komponente.
ERROR_UNKNOWN_PRODUCT	Der Produktcode identifiziert kein bekanntes Produkt.
ERROR_FUNCTION_FAILED	Ein unerwarteter interner Fehler.

 

Anforderungen

Anforderung	Wert
Version	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer 3.0 oder höher unter Windows Server 2003, Windows XP oder Windows 2000
DLL	Msi.dll
IID	IID_IProduct ist definiert als 000C10A0-0000-0000-C000-000000000046

Siehe auch

Produkt

MsiQueryComponentState

In Windows Installer 2.0 und früher nicht unterstützt