Funzione GetFileVersionInfoW (winver.h)

Articolo
03/13/2024

Recupera le informazioni sulla versione per il file specificato.

Sintassi

BOOL GetFileVersionInfoW(
  [in]  LPCWSTR lptstrFilename,
        DWORD   dwHandle,
  [in]  DWORD   dwLen,
  [out] LPVOID  lpData
);

Parametri

[in] lptstrFilename

Tipo: LPCTSTR

Nome del file. Se non viene specificato un percorso completo, la funzione usa la sequenza di ricerca specificata dalla funzione LoadLibrary .

dwHandle

Tipo: DWORD

Questo parametro viene ignorato.

[in] dwLen

Tipo: DWORD

Dimensioni, in byte, del buffer a cui punta il parametro lpData .

Chiamare prima la funzione GetFileVersionInfoSize per determinare le dimensioni, in byte, delle informazioni sulla versione di un file. Il membro dwLen deve essere uguale o maggiore di tale valore.

Se il buffer puntato da lpData non è abbastanza grande, la funzione tronca le informazioni sulla versione del file alle dimensioni del buffer.

[out] lpData

Tipo: LPVOID

Puntatore a un buffer che riceve le informazioni sulla versione del file.

È possibile usare questo valore in una chiamata successiva alla funzione VerQueryValue per recuperare i dati dal buffer.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le informazioni sulla versione del file hanno una parte fissa e non fissa. La parte fissa contiene informazioni come il numero di versione. La parte non fissa contiene elementi come stringhe. In passato GetFileVersionInfo ha preso le informazioni sulla versione dal file binario (exe/dll). Attualmente, esegue una query sulla versione fissa dal file neutrale del linguaggio (exe/dll) e la parte non fissa dal file mui, li unisce e restituisce all'utente. Se il file binario specificato non ha un file mui, il comportamento è come nella versione precedente.

Chiamare la funzione GetFileVersionInfoSize prima di chiamare la funzione GetFileVersionInfo . Per recuperare informazioni dal buffer delle informazioni sulla versione file, usare la funzione VerQueryValue .

Nota

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

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