MsiGetProductInfoFromScriptA, fonction (msi.h)
La fonction MsiGetProductInfoFromScript retourne des informations produit pour un fichier de script Windows Installer.
Syntaxe
UINT MsiGetProductInfoFromScriptA(
[in] LPCSTR szScriptFile,
[out] LPSTR lpProductBuf39,
[out] LANGID *plgidLanguage,
[out] LPDWORD pdwVersion,
[out] LPSTR lpNameBuf,
[in, out] LPDWORD pcchNameBuf,
[out] LPSTR lpPackageBuf,
[in, out] LPDWORD pcchPackageBuf
);
Paramètres
[in] szScriptFile
Chaîne terminée par null spécifiant le chemin d’accès complet au fichier de script. Le fichier de script est le script de publication qui a été créé en appelant MsiAdvertiseProduct ou MsiAdvertiseProductEx.
[out] lpProductBuf39
Pointe vers une mémoire tampon qui reçoit le code de produit. La mémoire tampon doit comporter 39 caractères. Les 38 premiers caractères sont destinés au GUID du code de produit, et le dernier caractère correspond au caractère null de fin.
[out] plgidLanguage
Pointe vers une variable qui reçoit la langue du produit.
[out] pdwVersion
Pointe vers une mémoire tampon qui reçoit la version du produit.
[out] lpNameBuf
Pointe vers une mémoire tampon qui reçoit le nom du produit. La mémoire tampon inclut un caractère null de fin.
[in, out] pcchNameBuf
Pointe vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpNameBuf . Cette taille doit inclure le caractère null de fin. Lorsque la fonction retourne, cette variable contient la longueur de la chaîne stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin. Si la mémoire tampon n’est pas suffisamment grande, la fonction retourne ERROR_MORE_DATA et la variable contient la taille de la chaîne en caractères, sans compter le caractère null.
[out] lpPackageBuf
Pointe vers une mémoire tampon qui reçoit le nom du package. La mémoire tampon inclut le caractère null de fin.
[in, out] pcchPackageBuf
Pointe vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpPackageNameBuf . Cette taille doit inclure le caractère null de fin. Lorsque la fonction retourne, cette variable contient la longueur de la chaîne stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin. Si la mémoire tampon n’est pas suffisamment grande, la fonction retourne ERROR_MORE_DATA et la variable contient la taille de la chaîne en caractères, sans compter le caractère null.
Valeur retournée
Valeur | Signification |
---|---|
|
La fonction s’est terminée avec succès. |
|
Un argument non valide a été passé à la fonction . |
|
Une mémoire tampon était trop petite pour contenir la valeur entière. |
|
Impossible d’obtenir des informations de script. |
|
Cette fonction est disponible uniquement sur Windows 2000 et Windows XP. |
Remarques
Notes
L’en-tête msi.h définit MsiGetProductInfoFromScript 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. La combinaison 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 |