MsiInstallProductA, fonction (msi.h)

Article
11/20/2024

La fonction MsiInstallProduct installe ou désinstalle un produit.

Syntaxe

UINT MsiInstallProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szCommandLine
);

Paramètres

[in] szPackagePath

Chaîne terminée par null qui spécifie le chemin d’accès à l’emplacement du package Windows Installer. La valeur de chaîne peut contenir une URL (par exemple, http://packageLocation/package/package.msi), un chemin d’accès réseau (par exemple, \packageLocation\package.msi), un chemin d’accès de fichier (par exemple, file://packageLocation/package.msi) ou un chemin local (par exemple, D:\packageLocation\package.msi).

[in] szCommandLine

Chaîne terminée par null qui spécifie les paramètres de propriété de ligne de commande. Il doit s’agir d’une liste du format Property=Setting Property=Setting. Pour plus d’informations, consultez À propos des propriétés.

Pour effectuer une installation administrative, incluez ACTION=ADMIN dans szCommandLine. Pour plus d’informations, consultez la propriété ACTION.

Valeur de retour

Valeur	Signification
ERROR_SUCCESS	La fonction s’exécute correctement.
Une erreur liée à une action	Pour plus d’informations, consultez codes d’erreur.
erreur d’initialisation	Une erreur liée à l’initialisation s’est produite.

Pour plus d’informations, consultez Afficher les messages d’erreur.

Remarques

La fonction MsiInstallProduct affiche l’interface utilisateur avec les paramètres actuels et le mode journal.

Vous pouvez modifier les paramètres de l’interface utilisateur à l’aide du MsiSetInternalUI , msiSetExternalUIou fonctions MsiSetExternalUIRecord.
Vous pouvez définir le mode journal à l’aide de la fonction MsiEnableLog.
Vous pouvez supprimer complètement un produit en définissant REMOVE=ALL dans szCommandLine.

Pour plus d’informations, consultez REMOVE Property.

Note

L’en-tête msi.h définit MsiInstallProduct comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible	Windows
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

messages d’erreur affichés

codes d’erreur

erreur d’initialisation

fonctions d’installation et de configuration

Multiple-Package Installations

Partager via