MsiGetProductCodeA, fonction (msi.h)

Article
08/24/2023

La fonction MsiGetProductCode retourne le code produit d’une application à l’aide du code de composant d’un composant installé ou publié de l’application. Pendant l’initialisation, une application doit déterminer sous quel code de produit elle a été installée ou annoncée.

Syntaxe

UINT MsiGetProductCodeA(
  [in]  LPCSTR szComponent,
  [out] LPSTR  lpBuf39
);

Paramètres

[in] szComponent

Ce paramètre spécifie le code de composant d’un composant qui a été installé par l’application. Il s’agit généralement du code de composant du composant contenant le fichier exécutable de l’application.

[out] lpBuf39

Pointeur vers une mémoire tampon qui reçoit le code de produit. Cette mémoire tampon doit contenir 39 caractères. Les 38 premiers caractères correspondent au GUID et le dernier caractère correspond au caractère null de fin.

Valeur retournée

Valeur	Signification
ERROR_BAD_CONFIGURATION	Les données de configuration sont endommagées.
ERROR_INSTALL_FAILURE	Impossible de déterminer le code de produit.
ERROR_INVALID_PARAMETER	Un paramètre non valide a été transmis à la fonction.
ERROR_SUCCESS	La fonction s’est terminée avec succès.
ERROR_UNKNOWN_COMPONENT	Le composant spécifié est inconnu.

Remarques

Pendant l’initialisation, une application doit déterminer le code de produit sous lequel elle a été installée. Une application peut faire partie de différents produits dans différentes installations. Par exemple, une application peut faire partie d’une suite d’applications ou être installée seule.

Notes

L’en-tête msi.h définit MsiGetProductCode comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal 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. Windows Installer sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions spécifiques à l’application