Partager via


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
Msi.dll
IID
IID_IInstaller est défini comme 000C1090-0000-0000-C000-000000000046

Voir aussi

Utilisation de l’interface Automation

Exemples de scripts Windows Installer