Freigeben über


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