Méthode Session.SetInstallLevel

La méthode SetInstallLevel de l’objet Session définit le niveau d’installation de l’installation en cours sur une valeur spécifiée et recalcule les états Select et Installed pour toutes les fonctionnalités de la table Feature. Il définit également l’état Action de chaque composant de la table Component en fonction du nouveau niveau.

Syntaxe

Session.SetInstallLevel(
  installLevel
)

Paramètres

installLevel

Nouveau niveau d’installation requis.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

L’action CostInitialize doit être exécutée avant d’appeler SetInstallLevel.

Si 0 est passé pour le paramètre installLevel, le niveau d’installation actuel n’est pas modifié, mais toutes les fonctionnalités sont toujours mises à jour en fonction du niveau d’installation actuel. Par exemple, cette fonctionnalité peut être utilisée par le module Gestionnaire pour réinitialiser toutes les sélections à leurs états par défaut initiaux à tout moment dans le processus de sélection de l’interface utilisateur.

Si la méthode échoue, vous pouvez obtenir des informations d’erreur détaillées à l’aide de la méthode LastErrorRecord.

Configuration requise

Condition requise Valeur
Version
Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
DLL
Msi.dll
IID
IID_ISession est défini comme 000C109E-0000-0000-C000-000000000046