objet Session (Windows Installer)

L’objet session contrôle le processus d’installation. Il ouvre la base de données du programme d’installation, qui contient les tables et les données d’installation. Cet objet est associé à un ensemble standard de fonctions d’action, chacune effectuant des opérations particulières sur des données à partir d’une ou plusieurs tables. Des actions personnalisées supplémentaires peuvent être ajoutées pour des installations de produits spécifiques. La fonction de moteur de base est un séquenceur qui extrait les enregistrements séquentiels d’une table de séquences désignée, évalue toute expression de condition spécifiée et exécute l’action désignée. Les actions non reconnues par le moteur sont différées à l’objet gestionnaire d’interface utilisateur pour le traitement, généralement des séquences de boîte de dialogue.

Notez qu’un seul objet de session peut être ouvert par un processus unique.

Membres

L’objet session possède les types de membres suivants :

Méthodes

L’objet session possède ces méthodes.

Méthode Description
Action Exécute l’action spécifiée.
EvaluateCondition Évalue une expression logique contenant des symboles et des valeurs et retourne un entier de l’énumération msiEvaluateConditionErrorEnum.
FeatureInfo Retourne un objet FeatureInfo qui contient des informations descriptives pour la fonctionnalité spécifiée.
FormatRecord Retourne une chaîne mise en forme à partir de données de modèle et d’enregistrement.
Message Exécute toutes les opérations de journalisation activées et diffère l’exécution à l’objet de gestionnaire d’interface utilisateur associé au moteur.
Séquence Ouvre une requête sur la table spécifiée, en ordonnant les actions en fonction des nombres figurant dans la colonne séquence. Pour chaque ligne extraite, la méthode d' action est appelée, à condition que toute expression de condition fournie ne corresponde pas à false.
SetInstallLevel 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.

Propriétés

L’objet session possède ces propriétés.

Propriété Type d’accès Description
ComponentCosts
Retourne un objet RecordList énumérant l’espace disque par lecteur requis pour installer un composant.
ComponentCurrentState
Retourne l’état installé actuel du composant désigné.
ComponentRequestState
Obtient ou demande une modification de l’état d’action d’une ligne dans la table des composants.
Base de données
Retourne la base de données pour la session d’installation en cours.
FeatureCost
Retourne la quantité totale d’espace disque (en unités de 512 octets) requise par la fonctionnalité spécifiée et ses fonctionnalités parentes (jusqu’à la racine du tableau des fonctionnalités).
FeatureCurrentState
Retourne l’état installé actuel de la fonctionnalité désignée.
FeatureRequestState
Lecture/écriture
Obtient ou demande une modification de l’État SELECT de l’enregistrement et des sous-enregistrements d’une fonctionnalité.
FeatureValidStates
Retourne un entier représentant des indicateurs binaires avec chaque bit approprié représentant un état d’installation valide pour la fonctionnalité spécifiée.
Programme d’installation
Retourne l’objet d’installation actif.
Language (objet session)
Représente l’identificateur de langue numérique utilisé par la session d’installation en cours.
Mode
Cette propriété est une valeur représentant l’indicateur de mode désigné pour la session d’installation en cours.
ProductProperty
Représente la valeur de chaîne d’une propriété de programme d’installation nommée.
Propriété (objet session)
Lecture/écriture
Récupère les propriétés du produit de la base de données du produit.
SourcePath
Fournit le chemin d’accès complet au dossier désigné sur le média source ou l’image serveur.
TargetPath
Lecture/écriture
Fournit le chemin d’accès complet au dossier désigné sur le lecteur cible de l’installation.
VerifyDiskSpace
Retourne la valeur true si l’espace disque disponible est suffisant, et false si le disque est plein.

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

Voir aussi

Windows Exemples de scripts d’installation