Partager via


GetFileVersionInfoSizeA, fonction (winver.h)

Détermine si le système d’exploitation peut récupérer les informations de version d’un fichier spécifié. Si des informations de version sont disponibles, GetFileVersionInfoSize retourne la taille, en octets, de ces informations.

Syntaxe

DWORD GetFileVersionInfoSizeA(
  [in]            LPCSTR  lptstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Paramètres

[in] lptstrFilename

Type : LPCTSTR

Nom du fichier d’intérêt. La fonction utilise la séquence de recherche spécifiée par la fonction LoadLibrary.

[out, optional] lpdwHandle

Type : LPDWORD

Pointeur vers une variable que la fonction définit sur zéro.

Valeur de retour

Type : DWORD

Si la fonction réussit, la valeur de retour est la taille, en octets, des informations de version du fichier.

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

Remarques

Appelez la fonction GetFileVersionInfoSize avant d’appeler la fonction GetFileVersionInfo. La taille retournée par GetFileVersionInfoSize indique la taille de la mémoire tampon requise pour les informations de version retournées par GetFileVersionInfo.

Note

L’en-tête winver.h définit GetFileVersionInfoSize 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. 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

Voir aussi

conceptuelle

GetFileVersionInfo

de référence

VS_VERSIONINFO

VerQueryValue

informations de version