Objet Session (Programme d’installation Windows)
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 les données d’une ou plusieurs tables. Des actions personnalisées supplémentaires peuvent être ajoutées pour des installations de produits particulières. 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 reportées à l’objet gestionnaire de l’interface utilisateur pour traitement, en général des séquences de boîtes de dialogue.
Notez qu’un seul objet Session peut être ouvert par un seul processus.
Membres
L’objet Session a les types de membres suivants :
Méthodes
L’objet Session possède ces méthodes.
| Méthode | Description |
|---|---|
| DoAction | 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 contenant des informations descriptives pour la fonctionnalité spécifiée. |
| FormatRecord | Retourne une chaîne mise en forme à partir des données de modèle et d’enregistrement. |
| Message | Exécute des opérations de journalisation activées et reporte l’exécution à l’objet gestionnaire de l’interface utilisateur associé au moteur. |
| Séquence | Ouvre une requête sur la table spécifiée, en triant les actions par nombre dans la colonne Séquence. Pour chaque ligne extraite, la méthode DoAction est appelée, à condition que toute expression de condition fournie n’ait pas la valeur False. |
| SetInstallLevel | Définit le niveau d’installation de l’installation actuelle sur une valeur spécifiée et recalcule les états Sélectionner et Installé 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 |
Renvoie 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 Action d’une ligne dans la table Composant. |
|
|
Base de données |
Retourne la base de données de la session d’installation actuelle. |
|
|
FeatureCost |
Retourne la quantité totale d’espace disque (en unités de 512 octets) demandée par la fonctionnalité spécifiée et ses fonctionnalités parentes (jusqu’à la racine de la table Fonctionnalité). |
|
|
FeatureCurrentState |
Retourne l’état installé actuel de la fonctionnalité désignée. |
|
|
FeatureRequestState |
Lecture/écriture |
Obtient ou demande une modification de l’état Sélectionner de l’enregistrement et des sous-enregistrements d’une fonctionnalité. |
|
FeatureValidStates |
Retourne un entier représentant des indicateurs de bits avec chaque bit pertinent représentant un état d’installation valide pour la fonctionnalité spécifiée. |
|
|
Programme d’installation |
Retourne l’objet du programme d’installation actif. |
|
|
Langue (objet de session) |
Représente l’identificateur de langue numérique utilisé par la session d’installation actuelle. |
|
|
Mode |
Cette propriété est une valeur représentant l’indicateur de mode désigné pour la session d’installation actuelle. |
|
|
ProductProperty |
Représente la valeur de chaîne d’une propriété de programme d’installation nommée. |
|
|
Propriété (objet de session) |
Lecture/écriture |
Récupère les propriétés du produit à partir 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 d’installation. |
|
VerifyDiskSpace |
Retourne true si suffisamment d’espace disque existe et false si le disque est plein. |
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 |
|
| IID |
IID_ISession est défini comme 000C109E-0000-0000-C000-000000000046 |
Voir aussi