MsiQueryComponentStateA-Funktion (msi.h)
Die MsiQueryComponentState-Funktion gibt den installierten Zustand für eine Komponente zurück. Diese Funktion kann eine Komponente eines instance eines Produkts abfragen, das unter anderen Benutzerkonten als dem aktuellen Benutzer installiert ist, vorausgesetzt, das Produkt wird nicht unter dem benutzerspezifischen nicht verwalteten Kontext für ein anderes Benutzerkonto als den aktuellen Benutzer angekündigt. 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.
Syntax
UINT MsiQueryComponentStateA(
[in] LPCSTR szProductCode,
[in] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] LPCSTR szComponentCode,
[out] INSTALLSTATE *pdwState
);
Parameter
[in] szProductCode
Gibt die ProductCode-GUID für das Produkt an, das die Komponente enthält.
[in] szUserSid
Gibt die Sicherheits-ID (SID) des Kontos an, unter dem die instance des abgefragten Produkts vorhanden ist. Wenn dwContext nicht MSIINSTALLCONTEXT_MACHINE ist, gibt NULL den aktuellen Benutzer an.
[in] dwContext
Der Installationskontext des abgefragten Produkts instance.
[in] szComponentCode
Gibt die abgefragte Komponente an. Komponentencode-GUID der Komponente, wie in der Spalte ComponentID der Component-Tabelle zu finden.
[out] pdwState
Installationsstatus der Komponente für das angegebene Produkt instance. Dieser Parameter kann einen der folgenden oder NULL-Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Die Komponente wird lokal installiert. |
|
Die Komponente wird installiert, um von der Quelle aus auszuführen. |
Rückgabewert
Die MsiQueryComponentState-Funktion gibt die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
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. |
|
Die Konfigurationsdaten sind beschädigt. |
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. |
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Die Komponenten-ID identifiziert keine bekannte Komponente. |
|
Der Produktcode identifiziert kein bekanntes Produkt. |
|
Fehler, die keinem Windows-Fehlercode zugeordnet werden können. |
|
Puffer zu klein, um die Benutzer-SID abzurufen. |
Weitere Informationen finden Sie unter Angezeigte Fehlermeldungen.
Hinweise
Hinweis
Der msi.h-Header definiert MsiQueryComponentState 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 |
|---|---|
| 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. Informationen zum minimal 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 |