Informations de référence sur les fonctions du programme d’installation

Article
06/13/2023

Pour activer Windows Installer dans votre application, vous devez utiliser les fonctions du programme d’installation. Les tables de cette rubrique identifient les fonctions par catégorie.

Fonctions d’interface utilisateur et de journalisation

Nom	Description
MsiSetInternalUI	Active l’interface utilisateur interne du programme d’installation.
MsiSetExternalUI	Active un gestionnaire d’interface utilisateur externe qui reçoit des messages dans un format de chaîne.
MsiSetExternalUIRecord	Active un gestionnaire d’interface utilisateur externe qui reçoit des messages dans un format d’enregistrement.
MsiEnableLog	Définit le mode de journalisation pour toutes les installations du processus appelant.

Gérer les fonctions de gestion

Nom	Description
MsiCloseHandle	Ferme un handle d’installation ouvert.
MsiCloseAllHandles	Ferme tous les handles d’installation ouverts. Ne pas utiliser pour le nettoyage.

Fonctions d’installation et de configuration

Nom	Description
MsiAdvertiseProduct	Publie un produit.
MsiAdvertiseProductEx	Publie un produit.
MsiAdvertiseScript	Copie un fichier de script d’annonce dans des emplacements spécifiés.
MsiInstallProduct	Installe ou supprime une application ou une suite d’applications.
MsiConfigureProduct	Installe ou supprime une application ou une suite d’applications.
MsiConfigureProductEx	Installe ou supprime une application ou une suite d’applications. Une ligne de commande de produit peut être spécifiée.
MsiReinstallProduct	Réinstalle ou répare une installation.
MsiConfigureFeature	Configure l’état installé d’une fonctionnalité.
MsiReinstallFeature	Valide ou répare des fonctionnalités.
MsiInstallMissingComponent	Installe les composants manquants.
MsiInstallMissingFile	Installe les fichiers manquants.
MsiNotifySidChange	Notifie et met à jour les informations internes de Windows Installer avec les modifications apportées aux SID de l’utilisateur. Disponible à partir de Windows Installer 3.1.
MsiProcessAdvertiseScript	Traite un fichier de script d’annonce dans des emplacements spécifiés.
MsiSourceListAddSource	Ajoute ou réorganise les sources d’un correctif ou d’un produit dans un contexte spécifié.
MsiSourceListAddSourceEx	Ajoute ou réorganise les sources d’un correctif ou d’un produit dans un contexte spécifié. Crée une liste de sources pour un correctif qui n’existe pas dans un contexte spécifié. Disponible dans Windows Installer 3.0.
MsiSourceListClearSource	Supprime une source existante pour un produit ou un correctif dans un contexte spécifié. Disponible dans Windows Installer 3.0.
MsiSourceListClearAll	Supprime toutes les sources existantes d’un type de source spécifique pour une instance de produit spécifiée.
MsiSourceListClearAllEx	Supprime toutes les sources existantes d’un type de source spécifique pour une instance de produit spécifiée. Disponible dans Windows Installer 3.0.
MsiSourceListForceResolution	Supprime l’inscription de la source actuelle du produit ou du correctif, inscrite en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste de sources inscrite.
MsiSourceListForceResolutionEx	Supprime l’inscription de la source actuelle du produit ou du correctif, inscrite en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste de sources inscrite. Disponible dans Windows Installer 3.0.
MsiSourceListGetInfo	Récupère des informations sur la liste des sources d’un produit ou d’un correctif dans un contexte spécifique.
MsiSourceListSetInfo	Définit la source la plus récente utilisée pour un produit ou un correctif dans un contexte spécifié. Disponible dans Windows Installer 3.0.
MsiSourceListEnumMediaDisks	Énumère les disques inscrits pour la source de support d’un correctif ou d’un produit. Disponible dans Windows Installer 3.0.
MsiSourceListAddMediaDisk	Ajoute ou met à jour un disque de la source de support d’un produit ou d’un correctif inscrit. Disponible dans Windows Installer 3.0.
MsiSourceListClearMediaDisk	Supprime un disque inscrit existant dans la source de support pour un produit ou un correctif dans un contexte spécifique. Disponible dans Windows Installer 3.0.
MsiSourceListEnumSources	Énumère les sources dans la liste des sources d’un correctif ou d’un produit spécifié. Disponible dans Windows Installer 3.0.

Fonctions spécifiques aux composants

Nom	Description
MsiProvideAssembly	Installe et retourne le chemin d’accès complet du composant pour un assembly.
MsiProvideComponent	Installe et retourne le chemin d’accès complet d’un composant.
MsiProvideQualifiedComponent	Installe et retourne le chemin d’accès complet d’un composant qualifié.
MsiProvideQualifiedComponentEx	Installe et retourne le chemin d’accès complet d’un composant qualifié publié par un produit.
MsiGetComponentPath	Retourne le chemin d’accès complet ou la clé de Registre d’un composant installé.
MsiGetComponentPathEx	Retourne le chemin d’accès complet ou la clé de Registre d’un composant installé sur des comptes d’utilisateur et dans un contexte d’installation. Windows Installer 4.5 et versions antérieures : Non prises en charge.
MsiLocateComponent	Retourne le chemin complet d’un composant installé sans code de produit.
MsiQueryComponentState	Retourne l’état installé d’un composant. Peut interroger les composants d’une instance d’un produit installé sous des comptes d’utilisateur autres que celui de l’utilisateur actuel. Disponible dans Windows Installer 3.0 ou versions ultérieures.

Fonctions spécifiques à l’application

Nom	Description
MsiCollectUserInfo	Stocke les informations sur l’utilisateur à partir d’un assistant d’installation.
MsiUseFeature	Incrémente le nombre d’utilisations d’une fonctionnalité et indique l’état d’installation.
MsiUseFeatureEx	Incrémente le nombre d’utilisations d’une fonctionnalité et indique l’état d’installation.
MsiGetProductCode	Retourne le code produit à l’aide du code du composant.

Fonctions d’état du système

Nom	Description
MsiEnumProducts	Énumère les produits publiés.
MsiEnumProductsEx	Énumère toutes les instances des produits publiés ou installés dans un contexte spécifié. Disponible dans Windows Installer 3.0 ou versions ultérieures.
MsiEnumRelatedProducts	Énumère les produits actuellement installés avec un code de mise à niveau spécifié.
MsiEnumFeatures	Énumère les fonctionnalités publiées.
MsiEnumComponents	Énumère les composants installés.
MsiEnumComponentsEx	Énumère les composants installés dans les comptes d’utilisateur et le contexte d’installation. Windows Installer 4.5 et versions antérieures : Non prises en charge.
MsiEnumClients	Énumère les clients d’un composant installé.
MsiEnumClientsEx	Énumère les clients d’un composant installé parmi les comptes d’utilisateur et le contexte d’installation. Windows Installer 4.5 et versions antérieures : Non prises en charge.
MsiEnumComponentQualifiers	Énumère les qualificateurs publiés pour un composant.
MsiQueryFeatureState	Retourne l’état installé d’une fonctionnalité.
MsiQueryFeatureStateEx	Retourne l’état installé d’une fonctionnalité de produit. Peut interroger les fonctionnalités d’une instance d’un produit installé sous des comptes d’utilisateur autres que le compte de l’utilisateur actuel. Disponible dans Windows Installer 3.0 ou versions ultérieures.
MsiQueryProductState	Retourne l’état installé d’une application ou d’une suite d’applications.
MsiGetFeatureUsage	Retourne les métriques d’utilisation d’une fonctionnalité.
MsiGetProductInfo	Retourne des informations sur les produits publiés et installés.
MsiGetProductInfoEx	Retourne des informations sur les produits publiés et installés. Peut récupérer des informations sur une instance d’un produit installé sous un compte d’utilisateur autre que celui de l’utilisateur actuel. Disponible dans Windows Installer 3.0 ou versions ultérieures.
MsiGetUserInfo	Retourne des informations sur l’utilisateur inscrit pour un produit installé.

Fonctions de requête de produit

Nom	Description
MsiOpenProduct	Ouvre un produit à utiliser avec les fonctions qui accèdent à la base de données.
MsiOpenPackage	Ouvre un package à utiliser avec les fonctions qui accèdent à la base de données.
MsiOpenPackageEx	Ouvre un package à utiliser avec les fonctions qui accèdent à la base de données.
MsiIsProductElevated	Vérifie si le produit est installé avec des privilèges élevés.
MsiGetProductInfoFromScript	Retourne des informations sur le produit pour un fichier de script de programme d’installation.
MsiGetProductProperty	Récupère les propriétés dans la base de données de produit.
MsiGetShortcutTarget	Examine un raccourci et retourne son produit, son nom de fonctionnalité et son composant, le cas échéant.
MsiGetFeatureInfo	Retourne des informations descriptives pour une fonctionnalité.
MsiVerifyPackage	Vérifie qu’un fichier spécifié est un package d’installation.

Fonctions de mise à jour corrective

Nom	Description
MsiApplyPatch	Appelle une installation et applique un package de correctifs.
MsiEnumPatches	Retourne le GUID de chaque correctif appliqué à un produit, ainsi qu’une liste des transformations de chaque correctif applicables au produit.
MsiGetPatchInfo	Retourne des informations sur un correctif.
MsiRemovePatches	Désinstalle un correctif d’un produit. Disponible dans Windows Installer 3.0.
MsiDeterminePatchSequence	Détermine la meilleure séquence d’applications pour un ensemble de correctifs et de produits. Disponible dans Windows Installer 3.0.
MsiApplyMultiplePatches	Applique un ou plusieurs correctifs à des produits. Disponible dans Windows Installer 3.0.
MsiEnumPatchesEx	Énumère tous les correctifs appliqués à un produit dans un contexte particulier ou dans tous les contextes. Disponible dans Windows Installer 3.0.
MsiGetPatchFileList	Lorsqu’elle fournit une liste de fichiers .msp, cette fonction récupère la liste des fichiers qui peuvent être mis à jour par les correctifs pour la cible. Disponible dans Windows Installer 4.0.
MsiGetPatchInfoEx	Recherche des informations sur l’application d’un correctif spécifié à un produit spécifié. Disponible dans Windows Installer 3.0.
MsiExtractPatchXMLData	Extrait des informations d’un correctif. Disponible dans Windows Installer 3.0.
MsiDetermineApplicablePatches	Détermine le meilleur ensemble de correctifs requis pour mettre à jour un produit ou un ensemble de produits. Disponible dans Windows Installer 3.0.

Fonctions de requête de fichier

Nom	Description
MsiGetFileHash	Sélectionne le chemin d’un fichier et retourne un hachage 128 bits de ce fichier.
MsiGetFileSignatureInformation	Sélectionne le chemin d’accès à un fichier signé numériquement et retourne le certificat de signataire et le hachage du fichier.
MsiGetFileVersion	Retourne la chaîne de version et la chaîne de langue.

Fonctions de gestion des transactions

Nom	Description
MsiBeginTransaction	Lance le traitement transactionnel d’une installation à plusieurs packages et retourne un identificateur pour la transaction. Cette fonction est disponible à partir de Windows Installer 4.5.
MsiJoinTransaction	Demande que Windows Installer fasse du processus actuel le propriétaire de la transaction en installant une installation à plusieurs packages. Cette fonction est disponible à partir de Windows Installer 4.5.
MsiEndTransaction	Valide ou restaure toutes les installations appartenant à la transaction. Cette fonction est disponible à partir de Windows Installer 4.5.

Fonctions de base de données

En plus des fonctions Windows Installer identifiées dans les tables précédentes, vous pouvez manipuler les informations de la base de données d’installation à l’aide des fonctions d’accès à la base de données décrites dans la section Fonctions de base de données.

Structures du programme d’installation

En outre, certaines informations de la base de données d’installation sont gérées à l’aide des structures décrites dans la section Structures du programme d’installation.