GetFileVersionInfoA, fonction (winver.h)

Article
11/20/2024

Récupère les informations de version du fichier spécifié.

Syntaxe

BOOL GetFileVersionInfoA(
  [in]  LPCSTR lptstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Paramètres

[in] lptstrFilename

Type : LPCTSTR

Nom du fichier. Si aucun chemin d’accès complet n’est spécifié, la fonction utilise la séquence de recherche spécifiée par la fonction LoadLibrary.

dwHandle

Type : DWORD

Ce paramètre est ignoré.

[in] dwLen

Type : DWORD

Taille, en octets, de la mémoire tampon pointée par le paramètre lpData.

Appelez d’abord la fonction GetFileVersionInfoSize pour déterminer la taille, en octets, des informations de version d’un fichier. Le membre dwLen doit être égal ou supérieur à cette valeur.

Si la mémoire tampon pointée par lpData n’est pas suffisamment grande, la fonction tronque les informations de version du fichier à la taille de la mémoire tampon.

[out] lpData

Type : LPVOID

Pointeur vers une mémoire tampon qui reçoit les informations de version de fichier.

Vous pouvez utiliser cette valeur dans un appel ultérieur à la fonction VerQueryValue pour récupérer des données à partir de la mémoire tampon.

Valeur de retour

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Les informations de version de fichier ont une partie fixe et non fixe. La partie fixe contient des informations telles que le numéro de version. La partie non fixe contient des éléments tels que des chaînes. Dans le passé GetFileVersionInfo prenait des informations de version à partir du fichier binaire (exe/dll). Actuellement, il interroge une version fixe à partir du fichier neutre du langage (exe/dll) et de la partie non fixe du fichier mui, les fusionne et retourne à l’utilisateur. Si le fichier binaire donné n’a pas de fichier mui, le comportement est comme dans la version précédente.

Appelez la fonction GetFileVersionInfoSize avant d’appeler la fonction GetFileVersionInfo. Pour récupérer des informations à partir de la mémoire tampon d’informations de version de fichier, utilisez la fonction VerQueryValue .

Note

L’en-tête winver.h définit GetFileVersionInfo 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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winver.h (inclure Windows.h)
bibliothèque	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll