Partager via


GetFileVersionInfoSizeW, 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 GetFileVersionInfoSizeW(
  [in]            LPCWSTR 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

Voir aussi

Conceptuel

GetFileVersionInfo

Référence

VS_VERSIONINFO

VerQueryValue

Informations sur la version