Partager via

GetFileVersionInfoExA, fonction (winver.h)

  • Article

Récupère les informations de version du fichier spécifié.

Syntaxe

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Paramètres

[in] dwFlags

Type : DWORD

Contrôle les DLL MUI (le cas échéant) à partir desquelles la ressource de version est extraite. La valeur de cet indicateur doit correspondre aux indicateurs passés à l’appel GetFileVersionInfoSizeEx correspondant, qui a été utilisé pour déterminer la taille de mémoire tampon passée dans le paramètre dwLen. 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
0x02
 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.
FILE_VER_GET_PREFETCHED
0x04
 Indique une préférence pour version.dll tenter de précharger l’image en dehors du verrou du chargeur pour éviter la contention. Cet indicateur ne modifie pas le comportement ou la sémantique de la fonction.

[in] lpwstrFilename

Type : LPCTSTR

Nom du fichier. Si aucun chemin d’accès complet n’est spécifié, la fonction utilise la séquence de recherche spécifiée par la fonction LoadLibrary.

dwHandle

Type : DWORD

Ce paramètre est réservé et devrait être égal à zéro (0).

[in] dwLen

Type : DWORD

Taille, en octets, de la mémoire tampon pointée par le paramètre lpData.

Appelez d’abord la fonction GetFileVersionInfoSizeEx pour déterminer la taille, en octets, des informations de version d’un fichier. Le paramètre dwLen doit être égal ou supérieur à cette valeur.

Si la mémoire tampon pointée par lpData n’est pas suffisamment grande, la fonction tronque les informations de version du fichier à la taille de la mémoire tampon.

[out] lpData

Type : LPVOID

Lorsque cette fonction est retournée, contient un pointeur vers une mémoire tampon qui contient les informations de version de fichier.

Vous pouvez utiliser cette valeur dans un appel ultérieur à la fonction VerQueryValue pour récupérer des données à partir de la mémoire tampon.

Valeur de retour

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

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. Pour récupérer des informations à partir de la mémoire tampon d’informations de version de fichier, utilisez la fonction VerQueryValue .

Note

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

Voir aussi

conceptuelle

GetFileVersionInfo

GetFileVersionInfoSizeEx

de référence

VS_VERSIONINFO

VerQueryValue

informations de version