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
• Propriétés

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