MsiGetProductCodeA, fonction (msi.h)
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. Lors de l’initialisation, une application doit déterminer sous quel code de produit il a été installé ou publié.
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 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 du produit. Cette mémoire tampon doit comporter 39 caractères. Les 38 premiers caractères concernent le GUID et le dernier caractère correspond au caractère null de fin.
Valeur de retour
| Valeur | Signification |
|---|---|
|
Les données de configuration sont endommagées. |
|
Le code du produit n’a pas pu être déterminé. |
|
Un paramètre non valide a été passé à la fonction. |
|
La fonction s’est terminée correctement. |
|
Le composant spécifié est inconnu. |
Remarques
Lors de 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 elle peut être installée par elle-même.
Note
L’en-tête msi.h définit MsiGetProductCode 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. Windows Installer sur Windows Server 2003 ou Windows XP. 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 |