MsiGetFileVersionW, fonction (msi.h)
MsiGetFileVersion retourne la chaîne de version et la chaîne de langue au format que le programme d’installation s’attend à trouver dans la base de données. Si vous souhaitez uniquement des informations de version, définissez lpLangBuf et pcchLangBuf sur 0 (zéro). Si vous souhaitez simplement obtenir des informations de langue, définissez lpVersionBuf et pcchVersionBuf sur 0 (zéro).
Syntaxe
UINT MsiGetFileVersionW(
[in] LPCWSTR szFilePath,
[out] LPWSTR lpVersionBuf,
[in, out] LPDWORD pcchVersionBuf,
[out] LPWSTR lpLangBuf,
[in, out] LPDWORD pcchLangBuf
);
Paramètres
[in] szFilePath
Spécifie le chemin d’accès au fichier.
[out] lpVersionBuf
Retourne la version du fichier.
Définissez sur 0 pour les informations de langue uniquement.
[in, out] pcchVersionBuf
Nombre de mémoires tampons entrantes et sortantes comme nombre de TCHAR.
Définissez sur 0 (zéro) pour les informations de langue uniquement. Lors de l’entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.
[out] lpLangBuf
Retourne la langue du fichier.
Définissez sur 0 (zéro) pour les informations de version uniquement.
[in, out] pcchLangBuf
Nombre de mémoires tampons entrantes et sortantes comme nombre de TCHAR.
Définissez sur 0 (zéro) pour les informations de version uniquement. Lors de l’entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.
Valeur retournée
Valeur | Signification |
---|---|
|
Opération terminée correctement. |
|
Le fichier n'existe pas. |
|
Impossible d’ouvrir le fichier pour obtenir des informations de version. |
|
Le fichier ne contient pas d’informations de version. |
|
Les informations de version ne sont pas valides. |
|
Erreur inattendue. |
Notes
Notes
L’en-tête msi.h définit MsiGetFileVersion en tant qu’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.
Spécifications
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 |