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 tableaux 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 journal de 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. 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 suite d’applications ou d’applications. |
| MsiConfigureProduct | Installe ou supprime une suite d’applications ou d’applications. |
| msiConfigureProductEx | Installe ou supprime une suite d’applications ou 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 | Avertit et met à jour les informations internes de Windows Installer avec les modifications apportées aux SID utilisateur. Disponible à partir de Windows Installer 3.1. |
| MsiProcessAdvertiseScript | Traite un fichier de script de publication 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 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 source spécifique pour une instance de produit spécifiée. |
| MsiSourceListClearAllEx | Supprime toutes les sources existantes d’un type 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 inscrite en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste source inscrite. |
| MsiSourceListForceResolutionEx | Supprime l’inscription de la source actuelle du produit ou du correctif, qui est inscrite en tant que propriété « LastUsedSource ». Cette fonction n’affecte pas la liste source inscrite. Disponible dans Windows Installer 3.0. |
| msiSourceListGetInfo | Récupère des informations sur la liste source 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 multimédia d’un correctif ou d’un produit. Disponible dans Windows Installer 3.0. |
| MsiSourceListAddMediaDisk | Ajoute ou met à jour un disque de la source multimédia d’un produit ou d’un correctif inscrit. Disponible dans Windows Installer 3.0. |
| MsiSourceListClearMediaDisk | Supprime un disque inscrit existant sous la source multimédia d’un produit ou d’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 complet du composant pour un assembly. |
| MsiProvideComponent | Installe et retourne le chemin complet du composant d’un composant. |
| MsiProvideQualifiedComponent | Installe et retourne le chemin complet du composant d’un composant qualifié. |
| MsiProvideQualifiedComponentEx | Installe et retourne le chemin complet du composant d’un composant qualifié 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 à 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. |
| MsiLocateComponent | Retourne le chemin complet d’un composant installé sans code de produit. |
| MsiQueryComponentState | Retourne l’état installé d’un composant. Peut interroger des composants d’une instance d’un produit installé sous des comptes d’utilisateur 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 pour une fonctionnalité et indique l’état d’installation. |
| MsiUseFeatureEx | Incrémente le nombre d’utilisations pour une fonctionnalité et indique l’état d’installation. |
| msiGetProductCode | Retourne le code de 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 ayant 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é d’une fonctionnalité de produit. Peut interroger des fonctionnalités d’une instance d’un produit installé sous des 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 des métriques d’utilisation pour une fonctionnalité. |
| msiGetProductInfo | Retourne des informations sur le produit pour les produits publiés et installés. |
| MsiGetProductInfoEx | Retourne des informations sur le produit pour 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 des informations sur le produit pour un fichier de script 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 s’il est disponible. |
| 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 et une liste de transformations de chaque correctif qui s’applique 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 pour un produit dans un contexte particulier ou dans tous les contextes. Disponible dans Windows Installer 3.0. |
| MsiGetPatchFileList | Lorsqu’une liste de fichiers .msp est fournie, cette fonction récupère la liste des fichiers qui peuvent être mis à jour par les correctifs pour le targe. Disponible dans Windows Installer 4.0. |
| MsiGetPatchInfoEx | Requêtes pour plus d’informations sur l’application d’un correctif spécifié sur 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 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 | Démarre le traitement des transactions 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 effectue le processus actuel comme propriétaire de la transaction installant une installation multi-package. 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 Windows Installer identifiées dans les tables précédentes, vous pouvez manipuler des informations dans la base de données d’installation à l’aide des fonctions d’accès à la base de données décrites dans la section Database Functions.
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.