Función GetFileVersionInfoSizeExA (winver.h)

Artículo
08/28/2023

Determina si el sistema operativo puede recuperar información de versión para un archivo especificado. Si la información de la 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

Controla qué archivos DLL de MUI (si los hay) de 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 el recurso de versión completo (cadenas e información de versión binaria) desde el 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

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

Cuando esta función vuelve, 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

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

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 . 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
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 (incluye Windows.h)
Library	Version.lib
Archivo DLL	Api-ms-win-core-version-l1-1-0.dll