Funzione VerQueryValueW (winver.h)

Articolo
08/28/2023

Recupera le informazioni sulla versione specificate dalla risorsa delle informazioni sulla versione specificata. Per recuperare la risorsa appropriata, prima di chiamare VerQueryValue, è prima necessario chiamare la funzione GetFileVersionInfoSize e quindi la funzione GetFileVersionInfo .

Sintassi

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

Parametri

[in] pBlock

Tipo: LPCVOID

Risorsa delle informazioni sulla versione restituita dalla funzione GetFileVersionInfo .

[in] lpSubBlock

Tipo: LPCTSTR

Valore delle informazioni sulla versione da recuperare. La stringa deve essere costituita da nomi separati da barre rovesciate (\) e deve avere uno dei formati seguenti.

\

Blocco radice. La funzione recupera un puntatore alla struttura VS_FIXEDFILEINFO per la risorsa di informazioni sulla versione.

\VarFileInfo\Translation

Matrice di conversione in una struttura di informazioni variabile Var , ovvero il membro Value di questa struttura. La funzione recupera un puntatore a questa matrice di identificatori di linguaggio e tabella codici. Un'applicazione può usare questi identificatori per accedere a una struttura StringTable specifica della lingua (usando il membro szKey ) nella risorsa version-information.

\StringFileInfo\lang-codepage\string-name

Valore in una struttura StringTable specifica del linguaggio. Il nome della tabella codici lang è una concatenazione di una coppia di identificatori della lingua e della tabella codici trovata come DWORD nella matrice di traduzione per la risorsa. Qui il nome della tabella codici lang deve essere specificato come stringa esadecimale. Il nome stringa deve essere una delle stringhe predefinite descritte nella sezione Osservazioni seguente. La funzione recupera un valore stringa specifico per la lingua e la tabella codici indicate.

[out] lplpBuffer

Tipo: LPVOID*

Quando termina, questo metodo contiene l'indirizzo di un puntatore alle informazioni sulla versione richieste nel buffer a cui punta pBlock. La memoria a cui punta lplpBuffer viene liberata quando la memoria pBlock associata viene liberata.

[out] puLen

Tipo: PUINT

Quando termina, questo metodo contiene un puntatore alle dimensioni dei dati richiesti a cui punta lplpBuffer: per i valori delle informazioni sulla versione, la lunghezza in caratteri della stringa archiviata in lplpBuffer; per i valori della matrice di traduzione, le dimensioni in byte della matrice archiviate in lplpBuffer; e per il blocco radice, le dimensioni in byte della struttura.

Valore restituito

Tipo: BOOL

Se la struttura delle informazioni sulla versione specificata esiste e le informazioni sulla versione sono disponibili, il valore restituito è diverso da zero. Se l'indirizzo del buffer di lunghezza è zero, non è disponibile alcun valore per il nome delle informazioni sulla versione specificato.

Se il nome specificato non esiste o la risorsa specificata non è valida, il valore restituito è zero.

Commenti

Questa funzione funziona su immagini di file a 16, 32 e 64 bit.

Di seguito sono riportate le informazioni sulla versione predefinite delle stringhe Unicode.

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

Esempio

Nell'esempio seguente viene illustrato come enumerare le lingue di versione disponibili e recuperare il valore stringa FileDescription per ogni linguaggio.

Assicurarsi di chiamare le funzioni GetFileVersionInfoSize e GetFileVersionInfo prima di chiamare VerQueryValue per inizializzare correttamente il buffer 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

L'intestazione winver.h definisce VerQueryValue come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winver.h (include Windows.h)
Libreria	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll