Funzione GetFileVersionInfoExA (winver.h)

Articolo
11/20/2024

Recupera le informazioni sulla versione per il file specificato.

Sintassi

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parametri

[in] dwFlags

Tipo: DWORD

Controlla le DLL MUI (se presenti) da cui viene estratta la risorsa di versione. Il valore di questo flag deve corrispondere ai flag passati alla chiamata GetFileVersionInfoSizeEx corrispondente, che è stata usata per determinare le dimensioni del buffer passate nel parametro dwLen. Zero o più flag seguenti.

Valore	Significato
FILE_VER_GET_LOCALISED 0x01	Carica l'intera risorsa della versione (stringhe e informazioni sulla versione binaria) dal file MUI corrispondente, se disponibile.
FILE_VER_GET_NEUTRAL 0x02	Carica le stringhe di risorse della versione dal file MUI corrispondente, se disponibile, e carica le informazioni sulla versione binaria (VS_FIXEDFILEINFO) dal file indipendente dalla lingua corrispondente, se disponibile.
FILE_VER_GET_PREFETCHED 0x04	Indica una preferenza per version.dll di tentare di precaricare l'immagine all'esterno del blocco del caricatore per evitare conflitti. Questo flag non modifica il comportamento o la semantica della funzione.

[in] lpwstrFilename

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 è riservato e dovrebbe essere zero (0).

[in] dwLen

Tipo: DWORD

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

Chiamare prima la funzione GetFileVersionInfoSizeEx per determinare le dimensioni, in byte, delle informazioni sulla versione di un file. Il parametro 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

Quando questa funzione viene restituita, contiene un puntatore a un buffer contenente 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

Chiamare la funzione getFileVersionInfoSizeEx prima di chiamare la funzione GetFileVersionInfoEx . Per recuperare informazioni dal buffer delle informazioni sulla versione del file, usare la funzione VerQueryValue.

Nota

L'intestazione winver.h definisce GetFileVersionInfoEx 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [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