Función GetFileVersionInfoA (winver.h)
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 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 se omite.
[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 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 de
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 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
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 archivo 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
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 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 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [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
de referencia de
de información de versión de