MsiGetComponentStateA-Funktion (msiquery.h)

Artikel
11/20/2024

Die MsiGetComponentState Funktion ruft den Status einer Komponente ab.

Syntax

UINT MsiGetComponentStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szComponent,
  [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] szComponent

Eine mit Null beendete Zeichenfolge, die den Komponentennamen innerhalb des Produkts angibt.

[out] piInstalled

Empfängt den aktuellen Installationsstatus. Dieser Parameter darf nicht null sein. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
INSTALLSTATE_ABSENT	Die Komponente ist nicht installiert.
INSTALLSTATE_DEFAULT	Die Komponente wird am Standardspeicherort installiert: lokal oder quelle.
INSTALLSTATE_LOCAL	Die Komponente wird auf dem lokalen Laufwerk installiert.
INSTALLSTATE_REMOVED	Die Komponente wird entfernt. Im Aktionszustand und nicht festgelegt.
INSTALLSTATE_SOURCE	Die Komponente wird aus der Quelle, cd-ROM oder dem Netzwerk ausgeführt.
INSTALLSTATE_UNKNOWN	Ein unbekannter Produkt- oder Funktionsname wurde an die Funktion übergeben.

[out] piAction

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

Rückgabewert

Die MsiGetComponentState Funktion gibt die folgenden Werte zurück:

Bemerkungen

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

Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

Anmerkung

Der msiquery.h-Header definiert MsiGetComponentState 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