MsiSetComponentStateA-Funktion (msiquery.h)

  • Artikel

Die MsiSetComponentState-Funktion legt eine Komponente auf den angeforderten Zustand fest.

Syntax

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Parameter

[in] hInstall

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

[in] szComponent

Gibt den Namen der Komponente an.

[in] iState

Gibt den festzulegenden Zustand an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
INSTALLSTATE_ABSENT
 Die Komponente wurde deinstalliert.
INSTALLSTATE_LOCAL
 Die Komponente wurde auf dem lokalen Laufwerk installiert.
INSTALLSTATE_SOURCE
 Die Komponente wird von der Quelle, cd oder aus dem Netzwerk ausgeführt.

Rückgabewert

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

Hinweise

Die MsiSetComponentState-Funktion fordert eine Änderung des Aktionsstatus eines Datensatzes in der Tabelle Component an.

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 MsiSetComponentState als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
Zielplattform Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Installerauswahlfunktionen