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 |
|
| IID |
IID _ ISession est défini en tant que 000C109E-0000-0000-C000-000000000046 |