Función GetFileVersionInfoA (winver.h)

Artículo
08/28/2023

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

Sintaxis

BOOL GetFileVersionInfoA(
  [in]  LPCSTR lptstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parámetros

[in] lptstrFilename

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 se ignora.

[in] dwLen

Tipo: DWORD

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

Llame primero a la función GetFileVersionInfoSize para determinar el tamaño, en bytes, de la información de versión de un archivo. El miembro 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

Puntero a un búfer que recibe 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

La información de la versión del archivo tiene una parte fija y no fija. La parte fija contiene información como el número de versión. La parte no fija contiene elementos como cadenas. En el pasado GetFileVersionInfo estaba tomando información de versión del binario (exe/dll). Actualmente, está consultando la versión fija del archivo neutro del lenguaje (exe/dll) y la parte no fija del archivo mui, las combina y vuelve al usuario. Si el binario especificado no tiene un archivo mui, el comportamiento es como en la versión anterior.

Llame a la función GetFileVersionInfoSize antes de llamar a la función GetFileVersionInfo . 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 GetFileVersionInfo 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

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [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