MsiSetComponentStateW-Funktion (msiquery.h)

Artikel
11/20/2024

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

Syntax

UINT MsiSetComponentStateW(
  [in] MSIHANDLE    hInstall,
  [in] LPCWSTR      szComponent,
  [in] INSTALLSTATE iState
);

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

Gibt den Namen der Komponente an.

[in] iState

Gibt den festzulegenden Zustand an. Dieser Parameter kann einer der folgenden Werte sein:

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 dem Netzwerk ausgeführt.

Rückgabewert

Die funktion MsiSetComponentState gibt die folgenden Werte zurück:

Bemerkungen

Die MsiSetComponentState-funktion fordert eine Änderung des Aktionszustands eines Datensatzes in der Component-Tabellean.

Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.

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

Anmerkung

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

Freigeben über