Funzione GetFileVersionInfoA (winver.h)

Articolo
11/20/2024

Recupera le informazioni sulla versione per il file specificato.

Sintassi

BOOL GetFileVersionInfoA(
  [in]  LPCSTR 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

Dimensione, 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 a cui punta lpData non è sufficientemente 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 stava prendendo informazioni sulla versione dal file binario (exe/dll). Attualmente, esegue una query sulla versione fissa dal file indipendente dal linguaggio (exe/dll) e la parte non fissa dal file mui, li unisce e torna 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 del 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winver.h (include Windows.h)
libreria	Version.lib
dll	Api-ms-win-core-version-l1-1-0.dll