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