Compartir a través de


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 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

Consulte también

Conceptual

GetFileVersionInfoEx

GetFileVersionInfoSize

Referencia

VS_VERSIONINFO

VerQueryValue

Información de versión