Objet du programme d’installation
Un objet Installer doit être créé initialement pour charger la prise en charge de l’automatisation requise pour que COM accède aux fonctions du programme d’installation. Cet objet fournit des wrappers pour créer les objets de niveau supérieur et accéder à leurs méthodes.
Vous pouvez créer l’objet Installer à partir du ProgId « WindowsInstaller.Installer ».
Membres
L’objet Installer a les types de membres suivants :
Méthodes
L’objet Installer a ces méthodes.
| Méthode | Description |
|---|---|
| AddSource | Ajoute une source à la liste des sources réseau valides dans la liste des sources. |
| AdvertiseProduct | Publie un package d’installation. |
| AdvertiseScript | Publie un package d’installation. |
| ApplyMultiplePatches | Applique un ou plusieurs correctifs pour les produits éligibles à recevoir le correctif. Définit la propriété PATCH sur le chemin des packages de correctifs fournis. |
| ApplyPatch | Appelle une installation et définit la propriété PATCH sur le chemin d’accès du package de correctifs pour chaque produit répertorié par le package de correctifs pouvant recevoir le correctif. |
| ClearSourceList | Supprime toutes les sources réseau de la liste des sources. |
| CollectUserInfo | Appelle une séquence de l’Assistant d’interface utilisateur qui collecte et stocke à la fois les informations utilisateur et le code du produit. |
| ConfigureFeature | Configure l’état installé d’une fonctionnalité de produit. |
| ConfigureProduct | Installe ou désinstalle un produit. |
| CreateAdvertiseScript | Génère un script de publication. |
| CreateRecord | Retourne un nouvel objet Record avec le nombre de champs demandé. |
| EnableLog | Active la journalisation du type de message sélectionné pour toutes les sessions d’installation suivantes dans l’espace de processus actuel. |
| ExtractPatchXMLData | Extrait les informations d’un correctif sous forme de chaîne XML. |
| FileHash | Sélectionne le chemin d’un fichier et retourne un hachage 128 bits de ce fichier. |
| FileSignatureInfo | Sélectionne le chemin d’accès à un fichier et retourne un objet SAFEARRAY d’octets qui représente le hachage ou le certificat encodé. |
| FileSize | Retourne la taille du fichier spécifié. |
| FileVersion | Retourne la chaîne de version ou la chaîne de langue du chemin d’accès spécifié. |
| ForceSourceListResolution | Force le programme d’installation à rechercher dans la liste des sources une source de produit valide la prochaine fois qu’une source est requise. |
| InstallProduct | Ouvre un package d’installation et initialise une session d’installation. |
| LastErrorRecord | Retourne un objet Record qui contient les paramètres de l’erreur la plus récente de la fonction à l’origine de l’enregistrement de l’erreur. |
| OpenDatabase | Ouvre une base de données existante ou en crée une. |
| OpenPackage | Ouvre un package d’installation à utiliser avec des fonctions qui accèdent à la base de données du produit et au moteur d’installation. |
| OpenProduct | Ouvre un package d’installation pour un produit installé à l’aide du code de produit. |
| ProvideAssembly | Retourne le chemin d’accès installé d’un assembly. |
| ProvideComponent | Retourne le chemin d’accès complet du composant et effectue l’installation nécessaire. |
| ProvideQualifiedComponent | Retourne le chemin d’accès complet du composant et effectue l’installation nécessaire. |
| RegistryValue | Lit des informations sur une clé de valeur de Registre spécifiée. |
| ReinstallFeature | Réinstalle les fonctionnalités ou corrige les problèmes liés aux fonctionnalités installées. |
| ReinstallProduct | Réinstalle un produit ou corrige les problèmes d’installation dans un produit installé. |
| RemovePatches | Supprime un ou plusieurs correctifs pour les produits éligibles à recevoir le correctif. |
| UseFeature | Incrémente le nombre d’utilisations d’une fonctionnalité particulière et retourne l’état d’installation de cette fonctionnalité. |
Propriétés
L’objet Installer a ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
|
ClientsEx |
Retourne un objet RecordList qui répertorie les produits qui utilisent un composant installé spécifié. Windows Installer 4.5 et versions antérieures : Non prises en charge. |
|
|
ComponentClients |
Retourne un objet StringList qui énumére l’ensemble de clients d’un composant spécifié. |
|
|
ComponentPath |
Retourne le chemin d’accès complet vers un composant installé. |
|
|
ComponentPathEx |
Retourne un objet RecordList qui fournit le chemin d’accès complet d’un composant installé spécifié. Windows Installer 4.5 et versions antérieures : Non prises en charge. |
|
|
ComponentQualifiers |
Retourne un objet StringList qui énumère l’ensemble de qualificateurs inscrits pour le composant spécifié. |
|
|
Composants |
Retourne un objet StringList énumérant l’ensemble des composants installés pour tous les produits. |
|
|
ComponentsEx |
Retourne un objet RecordList qui répertorie les composants installés. Windows Installer 4.5 et versions antérieures : Non prises en charge. |
|
|
Environnement |
Lecture/écriture |
Valeur de chaîne pour une variable d’environnement du processus en cours. |
|
FeatureParent |
Spécifie la fonctionnalité parente d’une fonctionnalité. |
|
|
Caractéristiques |
Retourne un objet StringList énumérant l’ensemble de fonctionnalités publiées pour le produit spécifié. |
|
|
FeatureState |
Retourne l’état installé d’une fonctionnalité. |
|
|
FeatureUsageCount |
Retourne le nombre de fois où la fonctionnalité a été utilisée. |
|
|
FeatureUsageDate |
Retourne la date à laquelle la fonctionnalité spécifiée a été utilisée pour la dernière fois. |
|
|
FileAttributes |
Retourne un nombre représentant les attributs de fichier combinés pour le chemin désigné d’un fichier ou d’un dossier. |
|
|
Patches |
Retourne un objet StringList qui contient tous les correctifs appliqués au produit. |
|
|
PatchesEx |
Énumère une collection d’objets Patch. |
|
|
PatchFiles |
Retourne un objet StringList qui contient une liste de fichiers qui peuvent être mis à jour par la liste de correctifs fournie. |
|
|
PatchInfo |
Retourne des informations sur un correctif. |
|
|
PatchTransforms |
Retourne la liste délimitée par des points-virgules des transformations qui se trouvent dans le package de correctifs spécifié et qui sont appliquées au produit spécifié. |
|
|
ProductElevated |
Retourne True si le produit est géré ou False si le produit n’est pas géré. |
|
|
ProductInfo |
Retourne la valeur de l’attribut spécifié pour un produit installé ou publié. |
|
|
ProductInfoFromScript |
Retourne la valeur de l’attribut spécifié qui est stocké dans un script de publication. |
|
|
Products |
Retourne un objet StringList énumérant l’ensemble de tous les produits installés ou publiés pour l’utilisateur et l’ordinateur actuels. |
|
|
ProductsEx |
Énumère une collection d’objets Product. |
|
|
ProductState |
Retourne les informations sur l’état d’installation d’un produit. |
|
|
QualifierDescription |
Retourne une chaîne de texte qui décrit le composant qualifié. |
|
|
RelatedProducts |
Retourne un objet StringList énumérant l’ensemble de tous les produits installés ou publiés pour l’utilisateur et l’ordinateur actuels avec une propriété UpgradeCode spécifiée dans leur table Propriété. |
|
|
ShortcutTarget |
Examine un raccourci et retourne son produit, son nom de fonctionnalité et son composant, le cas échéant. |
|
|
SummaryInformation |
Retourne un objet SummaryInfo qui peut être utilisé pour examiner, mettre à jour et ajouter des propriétés au flux d’informations récapitulatives d’un package ou d’une transformation. |
|
|
UILevel |
Lecture/écriture |
Indique le type d’interface utilisateur à utiliser lors de l’ouverture et du traitement des packages suivants dans l’espace de processus actuel. |
|
Version |
Retourne la représentation sous forme de chaîne de la version actuelle de Windows Installer. |
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_IInstaller est défini comme 000C1090-0000-0000-C000-000000000046 |
Voir aussi