Installer.ConfigureProduct-Methode

Artikel
06/13/2023

Die ConfigureProduct-Methode des Installer-Objekts installiert oder deinstalliert ein Produkt.

Syntax

Installer.ConfigureProduct(
  Product,
  InstallLevel,
  InstallState
)

Parameter

Produkt

Gibt den Produktcode des Produkts an.

InstallLevel

Gibt die Standardinstallationskonfiguration des Produkts an. Der InstallLevel-Parameter wird ignoriert, und alle Features werden installiert, wenn der InstallState-Parameter auf einen anderen Wert als msiInstallStateDefault festgelegt ist.

Dieser Parameter muss entweder 0 (Installation mit den bei der Erstellung festgelegten Featureebenen), 65535 (Installation aller Features) oder zum Installieren einer Teilmenge der verfügbaren Features ein Wert zwischen 0 und 65535 sein.

InstallState

Gibt den Installationsstatus des Features an. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
msiInstallStateAdvertised	Das Feature ist angekündigt.
msiInstallStateLocal	Das Feature ist lokal installiert.
msiInstallStateAbsent	Das Feature ist deinstalliert.
msiInstallStateSource	Das Feature ist für die Ausführung aus der Quelle installiert.
msiInstallStateDefault	Das Feature ist am Standardspeicherort installiert.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die ConfigureProduct-Methode zeigt die Benutzeroberfläche mit den aktuellen Einstellungen an. Benutzeroberflächeneinstellungen können geändert werden, indem die UILevel-Eigenschaft (Installer-Objekt) vor dem Aufrufen der ConfigureProduct-Methode geändert wird.

Wenn der InstallState-Parameter auf einen anderen Wert als msiInstallStateDefault festgelegt ist, wird der InstallLevel-Parameter ignoriert, und alle Features des Produkts werden installiert. Verwenden Sie die ConfigureFeature-Methode, um die Installation einzelner Features zu steuern, wenn der InstallState-Parameter nicht auf msiInstallStateDefault festgelegt ist.

Anforderungen

Anforderung	Wert
Version	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
DLL	Msi.dll
IID	IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046

Siehe auch

MsiConfigureProduct
Installations- und Konfigurationsfunktionen

Freigeben über