MsiGetFeatureStateA-Funktion (msiquery.h)

  • Artikel

Die MsiGetFeatureState-Funktion ruft den angeforderten Status eines Features ab.

Syntax

UINT MsiGetFeatureStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Parameter

[in] hInstall

Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[in] szFeature

Gibt den Featurenamen innerhalb des Produkts an.

[out] piInstalled

Gibt den zurückgegebenen aktuellen installierten Zustand an. Dieser Parameter darf nicht null sein. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
INSTALLSTATE_BADCONFIG
 Die Konfigurationsdaten sind beschädigt.
INSTALLSTATE_INCOMPLETE
 Die Installation wird angehalten oder wird ausgeführt.
INSTALLSTATE_SOURCEABSENT
 Das Feature muss von der Quelle aus ausgeführt werden, und die Quelle ist nicht verfügbar.
INSTALLSTATE_MOREDATA
 Der Rückgabepuffer ist voll.
INSTALLSTATE_INVALIDARG
 Es wurde ein ungültiger Parameter an die Funktion übergeben.
INSTALLSTATE_UNKNOWN
 Ein unbekanntes Produkt oder Feature wurde angegeben.
INSTALLSTATE_BROKEN
 Das Feature ist beschädigt.
INSTALLSTATE_ADVERTISED
 Das angekündigte Feature.
INSTALLSTATE_ABSENT
 Das Feature wurde deinstalliert.
INSTALLSTATE_LOCAL
 Das Feature wurde auf dem lokalen Laufwerk installiert.
INSTALLSTATE_SOURCE
 Das Feature muss über die Quelle, cd-ROM oder das Netzwerk ausgeführt werden.
INSTALLSTATE_DEFAULT
 Das Feature wird am Standardspeicherort installiert: lokal oder quellort.

[out] piAction

Empfängt die aktion, die während der Installationssitzung ausgeführt wurde. Dieser Parameter darf nicht null sein. Rückgabewerte finden Sie unter piInstalled.

Rückgabewert

Die MsiGetFeatureState-Funktion gibt die folgenden Werte zurück:

Hinweise

Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

Hinweis

Der msiquery.h-Header definiert MsiGetFeatureState 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
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
Zielplattform Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Installerauswahlfunktionen

Übergeben von NULL als Argument von Windows Installer Functions