Función GetFileVersionInfoSizeExA (winver.h)

Determina si el sistema operativo puede recuperar información de versión para un archivo especificado. Si la información de versión está disponible, GetFileVersionInfoSizeEx devuelve el tamaño, en bytes, de esa información.

Sintaxis

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parámetros

[in] dwFlags

Tipo: DWORD de

Controla qué ARCHIVOS DLL de MUI (si los hay) desde los que se extrae el recurso de versión. 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 0x002	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.

[in] lpwstrFilename

Tipo: LPCTSTR de

Nombre del archivo de interés. La función usa la secuencia de búsqueda especificada por la función LoadLibrary.

[out, optional] lpdwHandle

Tipo: LPDWORD de

Cuando se devuelve esta función, contiene un puntero a una variable que se establece en cero porque esta función la establece en cero. Este parámetro existe por motivos históricos.

Valor devuelto

Tipo: DWORD de

Si la función se ejecuta correctamente, el valor devuelto es el tamaño, en bytes, de la información de versión del archivo.

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. El tamaño devuelto por GetFileVersionInfoSizeEx indica el tamaño de búfer necesario para la información de versión devuelta por GetFileVersionInfoEx.

Nota

El encabezado winver.h define GetFileVersionInfoSizeEx 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

GetFileVersionInfoEx

GetFileVersionInfoSize

de referencia de

VS_VERSIONINFO

verQueryValue

de información de versión de