Informations de référence sur les fonctions du programme d’installation
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.