Partager via


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.