Share via


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
Msi.dll
IID
IID_IProduct ist definiert als 000C10A0-0000-0000-C000-000000000046

Siehe auch

Product

MsiQueryFeatureStateEx

Von Windows Installer 2.0 und früheren Versionen nicht unterstützt