GetFileVersionInfoSizeExA, fonction (winver.h)

Article
11/20/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, GetFileVersionInfoSizeEx retourne la taille, en octets, de ces informations.

Syntaxe

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Paramètres

[in] dwFlags

Type : DWORD

Contrôle les DLL MUI (le cas échéant) à partir desquelles la ressource de version est extraite. Zéro ou plus des indicateurs suivants.

Valeur	Signification
FILE_VER_GET_LOCALISED 0x01	Charge l’intégralité de la ressource de version (chaînes et informations de version binaire) à partir du fichier MUI correspondant, le cas échéant.
FILE_VER_GET_NEUTRAL 0x002	Charge les chaînes de ressources de version à partir du fichier MUI correspondant, le cas échéant, et charge les informations de version binaire (VS_FIXEDFILEINFO) à partir du fichier neutre en langage correspondant, le cas échéant.

[in] lpwstrFilename

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

Lorsque cette fonction est retournée, contient un pointeur vers une variable définie sur zéro, car cette fonction la définit sur zéro. Ce paramètre existe pour des raisons historiques.

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 GetFileVersionInfoSizeEx avant d’appeler la fonction GetFileVersionInfoEx. La taille retournée par GetFileVersionInfoSizeEx indique la taille de mémoire tampon requise pour les informations de version retournées par GetFileVersionInfoEx.

Note

L’en-tête winver.h définit GetFileVersionInfoSizeEx 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 Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [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