MsiGetFileVersionA, fonction (msi.h)

Article
08/24/2023

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 MsiGetFileVersionA(
  [in]      LPCSTR  szFilePath,
  [out]     LPSTR   lpVersionBuf,
  [in, out] LPDWORD pcchVersionBuf,
  [out]     LPSTR   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
ERROR_SUCCESS	Opération terminée correctement.
ERROR_FILE_NOT_FOUND	Le fichier n'existe pas.
ERROR_ACCESS_DENIED	Impossible d’ouvrir le fichier pour obtenir des informations de version.
ERROR_FILE_INVALID	Le fichier ne contient pas d’informations de version.
ERROR_INVALID_DATA	Les informations de version ne sont pas valides.
E_FAIL	Erreur inattendue.

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

Voir aussi

Fonctions d’état du système

Partager via