GetFileVersionInfoSizeA, fonction (winver.h)

Article
03/04/2024

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 retournée

Type : DWORD

Si la fonction réussit, la valeur de retour correspond à 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étaillées sur l’erreur, 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.

Notes

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. 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 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winver.h (inclure Windows.h)
Bibliothèque	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll