Función GetFileVersionInfoExA (winver.h)

Artículo
03/08/2023

Recupera la información de versión del archivo especificado.

Sintaxis

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

Parámetros

[in] dwFlags

Tipo: DWORD

Controla los archivos DLL de MUI (si los hay) desde los que se extrae el recurso de versión. El valor de esta marca debe coincidir con las marcas pasadas a la llamada GetFileVersionInfoSizeEx correspondiente, que se usó para determinar el tamaño del búfer que se pasa en el parámetro dwLen . Cero o más de las marcas siguientes.

Valor	Significado
FILE_VER_GET_LOCALISED 0x01	Carga todo el recurso de versión (cadenas e información de versión binaria) desde el archivo MUI correspondiente, si está disponible.
FILE_VER_GET_NEUTRAL 0x02	Carga las cadenas de recursos de versión desde el archivo MUI correspondiente, si está disponible, y carga la información de versión binaria (VS_FIXEDFILEINFO) desde el archivo independiente del idioma correspondiente, si está disponible.
FILE_VER_GET_PREFETCHED 0x04	Indica una preferencia para version.dll intentar cargar previamente la imagen fuera del bloqueo del cargador para evitar la contención. Esta marca no cambia el comportamiento ni la semántica de la función.

[in] lpwstrFilename

Tipo: LPCTSTR

Nombre del archivo. Si no se especifica una ruta de acceso completa, la función usa la secuencia de búsqueda especificada por la función LoadLibrary .

dwHandle

Tipo: DWORD

Este parámetro está reservado y se espera que sea cero (0).

[in] dwLen

Tipo: DWORD

Tamaño, en bytes, del búfer al que apunta el parámetro lpData .

Llame primero a la función GetFileVersionInfoSizeEx para determinar el tamaño, en bytes, de la información de versión de un archivo. El parámetro dwLen debe ser igual o mayor que ese valor.

Si el búfer al que apunta lpData no es lo suficientemente grande, la función trunca la información de versión del archivo al tamaño del búfer.

[out] lpData

Tipo: LPVOID

Cuando esta función vuelve, contiene un puntero a un búfer que contiene la información de la versión del archivo.

Puede usar este valor en una llamada posterior a la función VerQueryValue para recuperar datos del búfer.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Llame a la función GetFileVersionInfoSizeEx antes de llamar a la función GetFileVersionInfoEx . Para recuperar información del búfer de información de versión de archivo, use la función VerQueryValue .

Nota

El encabezado winver.h define GetFileVersionInfoEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winver.h (incluya Windows.h)
Library	Version.lib
Archivo DLL	Api-ms-win-core-version-l1-1-0.dll