Session.SetInstallLevel-Methode

Die SetInstallLevel-Methode des Session-Objekts legt die Installationsebene für die aktuelle Installation auf einen angegebenen Wert fest und berechnet die Zustände „Select“ und „Installed“ für alle Features in der Feature-Tabelle neu. Außerdem wird der Action-Status jeder Komponente in der Component-Tabelle basierend auf der neuen Ebene festgelegt.

Syntax

Session.SetInstallLevel(
  installLevel
)

Parameter

installLevel

Erforderliche angeforderte neue Installationsebene.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die CostInitialize-Aktion muss vor dem Aufruf von SetInstallLevel ausgeführt werden.

Wenn 0 für den installLevel-Parameter übergeben wird, wird die aktuelle Installationsebene nicht geändert, aber alle Features werden weiterhin basierend auf der aktuellen Installationsebene aktualisiert. Diese Funktionalität kann beispielsweise vom Handler-Modul verwendet werden, um alle Auswahlen an einem beliebigen Punkt des Auswahlprozesses der Benutzeroberfläche auf ihren ursprünglichen Standardstatus zurückzusetzen.

Wenn die Methode fehlschlägt, können Sie die erweiterten Fehlerinformationen mithilfe der LastErrorRecord-Methode abrufen.

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_ISession ist definiert als 000C109E-0000-0000-C000-000000000046