MsiQueryFeatureStateA-Funktion (msi.h)

  • Artikel

Die MsiQueryFeatureState-Funktion gibt den installierten Status für ein Produktfeature zurück.

Syntax

INSTALLSTATE MsiQueryFeatureStateA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature
);

Parameter

[in] szProduct

Gibt den Produktcode für das Produkt an, das das interessante Feature enthält.

[in] szFeature

Identifiziert das gewünschte Feature.

Rückgabewert

Wert Bedeutung
INSTALLSTATE_ABSENT
 Das Feature ist nicht installiert.
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.
INSTALLSTATE_INVALIDARG
 Es wurde ein ungültiger Parameter an die Funktion übergeben.
INSTALLSTATE_UNKNOWN
 Der Produktcode oder die Feature-ID ist unbekannt.
 
 

Hinweise

Die MsiQueryFeatureState-Funktion überprüft nicht, ob auf das Feature tatsächlich zugegriffen werden kann.

Hinweis

Der msi.h-Header definiert MsiQueryFeatureState als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) 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 unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform Windows
Kopfzeile msi.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Systemstatusfunktionen