Session. SetInstallLevel, méthode

La méthode SetInstallLevel de l’objet session définit le niveau d’installation de l’installation actuelle 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 d’action de chaque composant dans la table des composants en fonction du nouveau niveau.

Syntaxe

Session.SetInstallLevel(
  installLevel
)

Paramètres

installLevel

Nouveau niveau d’installation demandé requis.

Valeur de retour

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 Handler pour réinitialiser toutes les sélections à leur état initial par défaut à tout moment dans le processus de sélection de l’interface utilisateur.

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

Spécifications

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 en tant que 000C109E-0000-0000-C000-000000000046