GetFileVersionInfoSizeExW, 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, GetFileVersionInfoSizeEx retourne la taille, en octets, de ces informations.
Syntaxe
DWORD GetFileVersionInfoSizeExW(
[in] DWORD dwFlags,
[in] LPCWSTR lpwstrFilename,
[out] 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.
[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] 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 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 GetFileVersionInfoSizeEx avant d’appeler la fonction GetFileVersionInfoEx . La taille retournée par GetFileVersionInfoSizeEx indique la taille de la mémoire tampon requise pour les informations de version retournées par GetFileVersionInfoEx.
Notes
L’en-tête winver.h définit GetFileVersionInfoSizeEx 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.
Spécifications
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [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
Référence