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 |
|
| IID |
IID_IProduct ist definiert als 000C10A0-0000-0000-C000-000000000046 |
Siehe auch