Product.FeatureState-Methode
Die FeatureState-Eigenschaft ist der Installationszustand des Features für die Instanz dieses Produkts.
Diese Eigenschaft ruft MsiQueryFeatureStateEx mit ProductCode, UserSid und Context des Objekts auf. Die Feature-ID wird als Parameter bereitgestellt.
Syntax
Product.FeatureState(
FeatureId
)
Parameter
-
FeatureId
-
Die Feature-ID, die in der Spalte „Feature“ der Feature-Tabelle angezeigt 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_ADVERTISED | Das Feature ist angekündigt. |
| INSTALLSTATE_LOCAL | Das Feature wird lokal installiert. |
| INSTALLSTATE_SOURCE | Das Feature ist für die Ausführung aus der Quelle installiert. |
Wenn der Aufruf nicht erfolgreich ausgeführt wird, enthält die Eigenschaft einen Fehlercode von MsiQueryFeatureStateEx.
| Fehler | Bedeutung |
|---|---|
| ERROR_ACCESS_DENIED | Der aufrufende Prozess muss über Administratorrechte verfügen, um Informationen zu einem Produkt abzurufen, das für einen anderen Benutzer oder eine andere Benutzerin als den aktuellen Benutzer bzw. die aktuelle Benutzerin installiert ist. |
| 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 ausgeführt. |
| ERROR_UNKNOWN_FEATURE | Die Feature-ID identifiziert kein bekanntes Feature. |
| 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