Función VerQueryValueA (winver.h)

Artículo
08/28/2023

Recupera la información de versión especificada del recurso de información de versión especificado. Para recuperar el recurso adecuado, antes de llamar a VerQueryValue, primero debe llamar a la función GetFileVersionInfoSize y, a continuación, la función GetFileVersionInfo .

Sintaxis

BOOL VerQueryValueA(
  [in]  LPCVOID pBlock,
  [in]  LPCSTR  lpSubBlock,
  [out] LPVOID  *lplpBuffer,
  [out] PUINT   puLen
);

Parámetros

[in] pBlock

Tipo: LPCVOID

Recurso de información de versión devuelto por la función GetFileVersionInfo .

[in] lpSubBlock

Tipo: LPCTSTR

Valor de información de versión que se va a recuperar. La cadena debe constar de nombres separados por barras diagonales inversas (\) y debe tener uno de los siguientes formularios.

\

Bloque raíz. La función recupera un puntero a la estructura de VS_FIXEDFILEINFO para el recurso de información de versión.

\VarFileInfo\Translation

Matriz de traducción en una estructura de información de variable Var : el miembro Value de esta estructura. La función recupera un puntero a esta matriz de identificadores de idioma y página de códigos. Una aplicación puede usar estos identificadores para acceder a una estructura StringTable específica del lenguaje (mediante el miembro szKey ) en el recurso version-information.

\StringFileInfo\lang-codepage\string-name

Valor de una estructura StringTable específica del lenguaje. El nombre de la página de códigos lang es una concatenación de un par de identificadores de página de códigos y idioma que se encuentra como DWORD en la matriz de traducción del recurso. Aquí el nombre de la página de códigos lang debe especificarse como una cadena hexadecimal. El nombre de cadena debe ser una de las cadenas predefinidas descritas en la sección Comentarios siguiente. La función recupera un valor de cadena específico del idioma y la página de códigos indicado.

[out] lplpBuffer

Tipo: LPVOID*

Cuando este método vuelve, contiene la dirección de un puntero a la información de versión solicitada en el búfer al que apunta pBlock. La memoria a la que apunta lplpBuffer se libera cuando se libera la memoria pBlock asociada.

[out] puLen

Tipo: PUINT

Cuando este método vuelve, contiene un puntero al tamaño de los datos solicitados a los que apunta lplpBuffer: para los valores de información de versión, la longitud en caracteres de la cadena almacenada en lplpBuffer; para los valores de matriz de traducción, el tamaño en bytes de la matriz almacenada en lplpBuffer; y para el bloque raíz, el tamaño en bytes de la estructura.

Valor devuelto

Tipo: BOOL

Si existe la estructura de información de versión especificada y la información de versión está disponible, el valor devuelto es distinto de cero. Si la dirección del búfer de longitud es cero, no hay ningún valor disponible para el nombre de información de versión especificado.

Si el nombre especificado no existe o el recurso especificado no es válido, el valor devuelto es cero.

Comentarios

Esta función funciona en imágenes de archivo de 16, 32 y 64 bits.

A continuación se muestran cadenas Unicode de información de versión predefinidas.

Comentarios	InternalName	ProductName
CompanyName	LegalCopyright	ProductVersion
FileDescription	LegalTrademarks	PrivateBuild
FileVersion	OriginalFilename	SpecialBuild

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar los idiomas de versión disponibles y recuperar el valor de cadena fileDescription para cada idioma.

Asegúrese de llamar a las funciones GetFileVersionInfoSize y GetFileVersionInfo antes de llamar a VerQueryValue para inicializar correctamente el búfer de pBlock .

// Structure used to store enumerated languages and code pages.

HRESULT hr;

struct LANGANDCODEPAGE {
  WORD wLanguage;
  WORD wCodePage;
} *lpTranslate;

// Read the list of languages and code pages.

VerQueryValue(pBlock, 
              TEXT("\\VarFileInfo\\Translation"),
              (LPVOID*)&lpTranslate,
              &cbTranslate);

// Read the file description for each language and code page.

for( i=0; i < (cbTranslate/sizeof(struct LANGANDCODEPAGE)); i++ )
{
  hr = StringCchPrintf(SubBlock, 50,
            TEXT("\\StringFileInfo\\%04x%04x\\FileDescription"),
            lpTranslate[i].wLanguage,
            lpTranslate[i].wCodePage);
	if (FAILED(hr))
	{
	// TODO: write error handler.
	}

  // Retrieve file description for language and code page "i". 
  VerQueryValue(pBlock, 
                SubBlock, 
                &lpBuffer, 
                &dwBytes); 
}

Nota

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