Función GetFileVersionInfoExA (winver.h)

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 de

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) del archivo MUI correspondiente, si está disponible.
FILE_VER_GET_NEUTRAL 0x02	Carga las cadenas de recursos de versión del archivo MUI correspondiente, si está disponible, y carga la información de versión binaria (VS_FIXEDFILEINFO) del 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 de

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 de

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

[in] dwLen

Tipo: DWORD de

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 de

Cuando se devuelve esta función, 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 de

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

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winver.h (incluya Windows.h)
biblioteca de	Version.lib
DLL de	Api-ms-win-core-version-l1-1-0.dll

Consulte también

conceptual de

GetFileVersionInfo

GetFileVersionInfoSizeEx

de referencia de

VS_VERSIONINFO

verQueryValue

de información de versión de