Objet Installer

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 de ProgId « WindowsInstaller.Installer ».

Membres

L’objet Installer comporte ces types de membres :

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 source.
AdvertiseProduct Publie un package d’installation.
AnnonceScript Publie un package d’installation.
ApplyMultiplePatches Applique un ou plusieurs correctifs aux produits éligibles pour recevoir le correctif. Définit la propriété PATCH sur le chemin d’accès 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 comme éligible pour recevoir le correctif.
ClearSourceList Supprime toutes les sources réseau de la liste source.
CollectUserInfo Appelle une séquence d’Assistant interface utilisateur qui collecte et stocke les informations utilisateur et le code produit.
ConfigurerFeature 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 demandé de champs.
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 des informations d’un correctif sous forme de chaîne XML.
FileHash Prend le chemin d’accès à un fichier et retourne un hachage 128 bits de ce fichier.
FileSignatureInfo Prend le chemin d’accès à un fichier et retourne un 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 la liste source d’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 Renvoie un objet Record qui contient des paramètres d’erreur pour l’erreur la plus récente de la fonction qui a produit l’enregistrement d’erreur.
OpenDatabase Ouvre une base de données existante ou crée une nouvelle base de données.
OpenPackage Ouvre un package d’installation à utiliser avec des fonctions qui accèdent à la base de données de produit et au moteur d’installation.
OpenProduct Ouvre un package d’installation pour un produit installé à l’aide du code du produit.
ProvideAssembly Retourne le chemin d’accès installé d’un assembly.
ProvideComponent Retourne le chemin complet du composant et effectue toute installation nécessaire.
ProvideQualifiedComponent Retourne le chemin complet du composant et effectue toute installation nécessaire.
RegistryValue Lit des informations sur une clé de Registre spécifiée de valeur.
RéinstallerFeature Réinstalle les fonctionnalités ou corrige les problèmes liés aux fonctionnalités installées.
RéinstallezProduct 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 à la réception du 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 pris en charge.
ComponentClients
Retourne un objet StringList énumérant l’ensemble de clients d’un composant spécifié.
ComponentPath
Retourne le chemin d’accès complet à un composant installé.
ComponentPathEx
Renvoie un objet RecordList qui donne le chemin d’accès complet d’un composant installé spécifié.
Windows Installer 4.5 et versions antérieures : non pris en charge.
ComponentQualifiers
Retourne un objet StringList énumérant l’ensemble de qualificateurs inscrits pour le composant spécifié.
Components
Retourne un objet StringList énumérant l’ensemble des composants installés pour tous les produits.
ComponentsEx
Renvoie un objet RecordList qui répertorie les composants installés.
Windows Installer 4.5 et versions antérieures : non pris en charge.
Environment
Lecture/écriture
Valeur de chaîne pour une variable d’environnement du processus actuel.
FeatureParent
Spécifie la fonctionnalité parente d’une fonctionnalité.
Caractéristiques
Retourne un objet StringList énumérant l’ensemble des 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 qui représente les attributs de fichier combinés pour le chemin d’accès désigné à un fichier ou un dossier.
Correctifs
Retourne un objet StringList qui contient tous les correctifs appliqués au produit.
PatchesEx
Énumère une collection d’objets Patch .
PatchFiles
Renvoie un objet StringList qui contient une liste de fichiers pouvant être mis à jour par la liste fournie des correctifs.
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 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é stocké dans un script de publication.
Produits
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 d’état d’installation d’un produit.
QualifierDescription
Retourne une chaîne de texte qui décrit le composant qualifié.
RelatedProducts
Renvoie 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 de propriétés.
ShortcutTarget
Examine un raccourci et retourne son produit, son nom de fonctionnalité et son composant s’il est disponible.
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.

 

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. programme d’installation Windows 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 du programme d’installation Windows