MsiGetFeatureStateA-Funktion (msiquery.h)

Artikel
11/20/2024

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 wird, oder erhalten Sie über MsiOpenPackage, MsiOpenPackageEx-oder MsiOpenProduct-.

[in] szFeature

Gibt den Featurenamen innerhalb des Produkts an.

[out] piInstalled

Gibt den zurückgegebenen aktuellen Installationsstatus an. Dieser Parameter darf nicht null sein. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
INSTALLSTATE_BADCONFIG	Die Konfigurationsdaten sind beschädigt.
INSTALLSTATE_INCOMPLETE	Die Installation wird angehalten oder wird ausgeführt.
INSTALLSTATE_SOURCEABSENT	Das Feature muss aus der Quelle ausgeführt werden, und die Quelle ist nicht verfügbar.
INSTALLSTATE_MOREDATA	Der Rückgabepuffer ist voll.
INSTALLSTATE_INVALIDARG	An die Funktion wurde ein ungültiger Parameter übergeben.
INSTALLSTATE_UNKNOWN	Ein nicht erkanntes Produkt oder Feature wurde angegeben.
INSTALLSTATE_BROKEN	Das Feature ist fehlerhaft.
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 aus der Quelle, cd-ROM oder aus dem Netzwerk ausgeführt werden.
INSTALLSTATE_DEFAULT	Das Feature wird am Standardspeicherort installiert: lokal oder quelle.

[out] piAction

Empfängt die während der Installationssitzung ausgeführte Aktion. Dieser Parameter darf nicht null sein. Informationen zu Rückgabewerten finden Sie unter piInstalled.

Rückgabewert

Die MsiGetFeatureState Funktion gibt die folgenden Werte zurück:

Bemerkungen

Siehe Aufrufen von Datenbankfunktionen aus Programmen.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe MsiGetLastErrorRecordabrufen.

Anmerkung

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

Anforderung	Wert
mindestens unterstützte 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-	Fenster
Header-	msiquery.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

Installationsprogrammauswahlfunktionen

Übergeben von Null als Argument von Windows Installer-Funktionen

Freigeben über