Référence des fonctions du programme d’installation

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

Interface utilisateur et fonctions 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 dans le processus appelant.

Gérer les fonctions de gestion

Nom Description
MsiCloseHandle Ferme un handle d’installation ouvert.
MsiCloseAllHandles Ferme tous les descripteurs d’installation ouverts. N’utilisez pas 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 de publication 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 les fonctionnalités.
MsiInstallMissingComponent Installe les composants manquants.
MsiInstallMissingFile Installe les fichiers manquants.
MsiNotifySidChange notifie et met à jour les informations internes du Windows Installer avec les modifications apportées aux sid des utilisateurs. disponible à partir de Windows Installer 3,1.
MsiProcessAdvertiseScript Traite un fichier de script de publication à 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 source 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, qui est enregistré en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste des sources inscrites.
MsiSourceListForceResolutionEx Supprime l’inscription de la source actuelle du produit ou du correctif, qui est enregistré en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste des sources inscrites. disponible dans Windows Installer 3,0.
MsiSourceListGetInfo Récupère des informations sur la liste source pour un produit ou un correctif dans un contexte spécifique.
MsiSourceListSetInfo Définit la source utilisée le plus récemment pour un produit ou un correctif dans un contexte spécifié. disponible dans Windows Installer 3,0.
MsiSourceListEnumMediaDisks Énumère la liste des disques inscrits pour la source du média pour un correctif ou un produit. disponible dans Windows Installer 3,0.
MsiSourceListAddMediaDisk Ajoute ou met à jour un disque de la source du média d’un produit ou d’un correctif enregistré. disponible dans Windows Installer 3,0.
MsiSourceListClearMediaDisk Supprime un disque inscrit existant sous la source du média 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 source d’un correctif ou d’un produit spécifié. disponible dans Windows Installer 3,0.

Fonctions Component-Specific

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 du composant d’un composant.
MsiProvideQualifiedComponent Installe et retourne le chemin d’accès complet du composant d’un composant qualifié.
MsiProvideQualifiedComponentEx Installe et retourne le chemin d’accès complet du composant d’un composant qualifié qui est publié par un produit.
MsiGetComponentPath Retourne le chemin d’accès complet ou la clé de Registre à un composant installé.
MsiGetComponentPathEx Retourne le chemin d’accès complet ou la clé de registre d’un composant installé parmi les comptes d’utilisateur et le contexte d’installation. Windows Installer 4,5 et versions antérieures: Non pris en charge.
MsiLocateComponent Retourne le chemin d’accès complet à un composant installé sans code produit.
MsiQueryComponentState Retourne l’état installé pour un composant. Peut interroger des composants d’une instance d’un produit installé sous des comptes d’utilisateurs autres que l’utilisateur actuel. disponible dans Windows Installer 3,0 ou version ultérieure.

Fonctions Application-Only

Nom Description
MsiCollectUserInfo Stocke les informations utilisateur à partir d’un Assistant installation.
MsiUseFeature Incrémente le nombre d’utilisations d’une fonctionnalité et indique l’état de l’installation.
MsiUseFeatureEx Incrémente le nombre d’utilisations d’une fonctionnalité et indique l’état de l’installation.
MsiGetProductCode Retourne le code du 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 de produits publiés ou installés dans un contexte spécifié. disponible dans Windows Installer 3,0 ou version ultérieure.
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 entre les comptes d’utilisateur et le contexte d’installation. Windows Installer 4,5 et versions antérieures: Non pris en charge.
MsiEnumClients Énumère les clients d’un composant installé.
MsiEnumClientsEx Énumère les clients d’un composant installé entre les comptes d’utilisateur et le contexte d’installation. Windows Installer 4,5 et versions antérieures: Non pris 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é pour une fonctionnalité de produit. Peut interroger les fonctionnalités d’une instance d’un produit installé sous comptes d’utilisateur autres que l’utilisateur actuel. disponible dans Windows Installer 3,0 ou version ultérieure.
MsiQueryProductState Retourne l’état installé pour une application ou une suite d’applications.
MsiGetFeatureUsage Retourne les métriques d’utilisation d’une fonctionnalité.
MsiGetProductInfo Retourne des informations sur le produit pour 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 l’utilisateur actuel. disponible dans Windows Installer 3,0 ou version ultérieure.
MsiGetUserInfo Retourne les informations utilisateur inscrites 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 les informations sur le produit pour un fichier de script d’installation.
MsiGetProductProperty Récupère les propriétés de la base de données du 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 qui s’appliquent 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’application pour un ensemble de correctifs et de produits. disponible dans Windows Installer 3,0.
MsiApplyMultiplePatches Applique un ou plusieurs correctifs aux 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 Lorsque vous avez fourni une liste de fichiers. msp, cette fonction récupère la liste des fichiers qui peuvent être mis à jour par les correctifs pour le cible. disponible dans Windows Installer 4,0.
MsiGetPatchInfoEx Recherche des informations sur l’application d’un correctif spécifique à 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 Prend le chemin d’accès à un fichier et retourne un hachage 128 bits de ce fichier.
MsiGetFileSignatureInformation Prend le chemin d’accès à un fichier qui a été signé numériquement et retourne le certificat du 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 Démarre le traitement des transactions d’une installation de plusieurs packages et retourne un identificateur pour la transaction. cette fonction est disponible à partir de Windows Installer 4,5.
MsiJoinTransaction demande que l’Windows Installer que le processus actuel soit le propriétaire de la transaction qui installe une installation de 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

outre les fonctions de 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 .