Risorsa VERSIONINFO

Articolo
06/13/2023

Definisce una risorsa di informazioni sulla versione. La risorsa contiene tali informazioni sul file come numero di versione, il sistema operativo previsto e il nome file originale. La risorsa deve essere usata con le funzioni Version Information .

Esistono due modi per formattare un'istruzione VERSIONINFO :

versionID VERSIONINFO fixed-info  { block-statement . . . }

- oppure -

versionID VERSIONINFO 
fixed-info
BEGIN
block-statement
. . .
END

Parametri

Versionid

Identificatore di risorsa delle informazioni sulla versione. Questo valore deve essere 1.

fixed-info

Informazioni sulla versione, ad esempio la versione del file e il sistema operativo previsto. Questo parametro è costituito dalle istruzioni seguenti.

Istruzione	Descrizione
Versione DI FILEVERSION	Numero di versione binaria per il file. La versione è costituita da due interi a 32 bit, definiti da quattro interi a 16 bit. Ad esempio, "FILEVERSION 3,10,0,61" viene convertito in due parole doppie: 0x0003000a e 0x0000003d, in tale ordine. Pertanto, se la versione è definita dai valori DWORDdw1 e dw2, è necessario che vengano visualizzate nell'istruzione FILEVERSION come indicato di seguito: `HIWORD(dw1)`, , `LOWORD(dw1)`, `HIWORD(dw2)LOWORD(dw2)`.
VERSIONE PRODUCTVERSION	Numero di versione binario per il prodotto con cui viene distribuito il file. Il parametro version è costituito da due interi a 32 bit, definiti da quattro interi a 16 bit. Per altre informazioni sulla versione, vedere la descrizione DI FILEVERSION .
FILEFLAGSMASKfileflagsmask	Indica i bit nell'istruzione FILEFLAGS validi. Per Windows a 16 bit, questo valore è 0x3f.
FileFLAGS fileflags	Attributi del file.
FileOS FILEOS	Sistema operativo per il quale è stato progettato questo file. Il parametro fileos può essere uno dei valori del sistema operativo indicati nella sezione Osservazioni.
FileTYPE filetype	Tipo generale di file. Il parametro filetype può essere uno dei valori del tipo di file elencati nella sezione Osservazioni.
SottotipoFILESUBTYPE	Funzione del file. Il parametro del sottotipo è zero a meno che il parametro filetype nell'istruzione FILETYPE non sia VFT_DRV, VFT_FONT o VFT_VXD. Per un elenco dei valori del sottotipo di file, vedere la sezione Osservazioni.

block-statement

Specifica uno o più blocchi di informazioni sulla versione. Un blocco può contenere informazioni sulla stringa o informazioni sulle variabili. Per altre informazioni, vedere Blocco StringFileInfo o Blocco VarFileInfo.

Commenti

Per usare le costanti specificate con l'istruzione VERSIONINFO , è necessario includere il file di intestazione Winver.h o Windows.h nel file di definizione della risorsa.

Nell'elenco seguente vengono descritti i parametri usati nell'istruzione VERSIONINFO :

fileflags

Combinazione dei valori seguenti.

Valore	Descrizione
VS_FF_DEBUG	Il file contiene informazioni di debug o viene compilato con le funzionalità di debug abilitate.
VS_FF_PATCHED	Il file è stato modificato e non è identico al file di spedizione originale dello stesso numero di versione.
VS_FF_PRERELEASE	File è una versione di sviluppo, non un prodotto rilasciato commercialmente.
VS_FF_PRIVATEBUILD	Il file non è stato compilato usando le procedure di rilascio standard. Se questo valore viene specificato, il blocco StringFileInfo deve contenere una stringa PrivateBuild .
VS_FF_SPECIALBUILD	Il file è stato creato dall'azienda originale usando procedure di rilascio standard, ma è una variante del file standard dello stesso numero di versione. Se questo valore viene specificato, il blocco di blocco StringFileInfo deve contenere una stringa SpecialBuild.
VS_FFI_FILEFLAGSMASK	Combinazione di tutti i valori precedenti.

fileos

Uno dei valori seguenti.

Valore	Descrizione
VOS_UNKNOWN	Il sistema operativo per il quale il file è stato progettato è sconosciuto.
VOS_DOS	Il file è stato progettato per MS-DOS.
VOS_NT	Il file è stato progettato per Windows a 32 bit.
VOS__WINDOWS16	Il file è stato progettato per Windows a 16 bit.
VOS__WINDOWS32	Il file è stato progettato per Windows a 32 bit.
VOS_DOS_WINDOWS16	Il file è stato progettato per Windows a 16 bit in esecuzione con MS-DOS.
VOS_DOS_WINDOWS32	Il file è stato progettato per Windows a 32 bit in esecuzione con MS-DOS.
VOS_NT_WINDOWS32	Il file è stato progettato per Windows a 32 bit.

I valori 0x000002L, 0x00003L, 0x20000L e 0x30000L sono riservati.

Filetype

Uno dei valori seguenti.

Valore	Descrizione
VFT_UNKNOWN	Tipo di file sconosciuto.
VFT_APP	Il file contiene un'applicazione.
VFT_DLL	Il file contiene una libreria a collegamento dinamico (DLL).
VFT_DRV	Il file contiene un driver di dispositivo. Se il tipo di file è VFT_DRV, il sottotipo contiene una descrizione più specifica del driver.
VFT_FONT	Il file contiene un tipo di carattere. Se il tipo di file è VFT_FONT, il sottotipo contiene una descrizione più specifica del tipo di carattere.
VFT_VXD	Il file contiene un dispositivo virtuale.
VFT_STATIC_LIB	Il file contiene una libreria di collegamenti statici.

Tutti gli altri valori sono riservati per l'uso da parte di Microsoft.

Sottotipo

Informazioni aggiuntive sul tipo di file.

Se filetype specifica VFT_DRV, questo parametro può essere uno dei valori seguenti.

Valore	Descrizione
VFT2_UNKNOWN	Il tipo di driver è sconosciuto.
VFT2_DRV_COMM	Il file contiene un driver di comunicazione.
VFT2_DRV_PRINTER	Il file contiene un driver della stampante.
VFT2_DRV_KEYBOARD	Il file contiene un driver da tastiera.
VFT2_DRV_LANGUAGE	Il file contiene un driver di lingua.
VFT2_DRV_DISPLAY	Il file contiene un driver di visualizzazione.
VFT2_DRV_MOUSE	Il file contiene un driver del mouse.
VFT2_DRV_NETWORK	Il file contiene un driver di rete.
VFT2_DRV_SYSTEM	Il file contiene un driver di sistema.
VFT2_DRV_INSTALLABLE	Il file contiene un driver installabile.
VFT2_DRV_SOUND	Il file contiene un driver audio.
VFT2_DRV_VERSIONED_PRINTER	Il file contiene un driver della stampante con versione.

Se filetype specifica VFT_FONT, questo parametro può essere uno dei valori seguenti.

Valore	Descrizione
VFT2_UNKNOWN	Tipo di carattere sconosciuto.
VFT2_FONT_RASTER	Il file contiene un tipo di carattere raster.
VFT2_FONT_VECTOR	Il file contiene un tipo di carattere vettoriale.
VFT2_FONT_TRUETYPE	Il file contiene un tipo di carattere TrueType.

Se filetype specifica VFT_VXD, questo parametro deve essere l'identificatore del dispositivo virtuale incluso nel blocco di controllo virtual-device.

Tutti i valori di sottotipo non elencati di seguito sono riservati per l'uso da parte di Microsoft.

langID

Uno dei codici di lingua seguenti.

Codice	Linguaggio	Codice	Linguaggio
0x0401	Arabo	0x0415	Polacco
0x0402	Bulgaro	0x0416	Portoghese (Brasile)
0x0403	Catalano	0x0417	Rhaeto-Romanic
0x0404	Cinese tradizionale	0x0418	Romeno
0x0405	Ceco	0x0419	Russo
0x0406	Danese	0x041A	Croato-Serbian (alfabeto latino)
0x0407	Tedesco	0x041B	Slovacco
0x0408	Greco	0x041C	Albanese
0x0409	Inglese (Stati Uniti)	0x041D	Svedese
0x040A	Castilian Spagnolo	0x041E	Thai
0x040B	Finlandese	0x041F	Turco
0x040C	Francese	0x0420	Urdu
0x040D	Ebraico	0x0421	Bahasa
0x040E	Ungherese	0x0804	Cinese semplificato
0x040F	Islandese	0x0807	Tedesco svizzero
0x0410	Italiano	0x0809	Inglese (Regno Unito)
0x0411	Giapponese	0x080A	Spagnolo (Messico)
0x0412	Coreano	0x080C	Francese belga
0x0413	Olandese	0x0C0C	Francese (Canada)
0x0414	Norvegese? Bokmal	0x100C	Francese svizzero
0x0810	Italiano svizzero	0x0816	Portoghese (Portogallo)
0x0813	Olandese belga	0x081A	Serbo-Croatian (cirillico)
0x0814	Norvegese? Nynorsk

charsetID

Uno degli identificatori del set di caratteri seguenti.

Decimal	Valore esadecimale	Set di caratteri
0	0000	ASCII a 7 bit
932	03A4	Giappone (spostamento ? JIS X-0208)
949	03B5	Corea (shift ? KSC 5601)
950	03B6	Taiwan (Big5)
1200	04B0	Unicode
1250	04E2	Latino-2 (Europa orientale)
1251	04E3	Cirillico
1252	04E4	Multilingue
1253	04E5	Greco
1254	04E6	Turco
1255	04E7	Ebraico
1256	04E8	Arabo

string-name

Uno dei nomi predefiniti seguenti.

Nome	Descrizione
Commenti	Informazioni aggiuntive da visualizzare a scopo diagnostico.
CompanyName	Società che ha prodotto il file, ad esempio o `Microsoft CorporationStandard Microsystems Corporation, Inc.` Questa stringa è obbligatoria.
FileDescription	Descrizione del file da presentare agli utenti. Questa stringa può essere visualizzata in una casella di riepilogo quando l'utente sceglie i file da installare, `Keyboard Driver for AT-Style Keyboards`ad esempio . Questa stringa è obbligatoria.
FileVersion	Numero di versione del file, `3.10` ad esempio o `5.00.RC2`. Questa stringa è obbligatoria.
InternalName	Nome interno del file, se presente, ad esempio un nome di modulo se il file è una libreria a collegamento dinamico. Se il file non ha un nome interno, questa stringa deve essere il nome file originale, senza estensione. Questa stringa è obbligatoria.
LegalCopyright	Note sul copyright applicabili al file. Questo dovrebbe includere il testo completo di tutti gli avvisi, simboli legali, date di copyright e così via. Questa stringa è facoltativa.
LegalTrademarks	Marchi e marchi registrati che si applicano al file. Deve includere il testo completo di tutte le comunicazioni, i simboli legali, i numeri dei marchi e così via. Questa stringa è facoltativa.
OriginalFilename	Nome originale del file, non incluso un percorso. Queste informazioni consentono a un'applicazione di determinare se un file è stato rinominato da un utente. Il formato del nome dipende dal file system per cui è stato creato il file. Questa stringa è obbligatoria.
PrivateBuild	Informazioni su una versione privata del file, `Built by TESTER1 on \\TESTBED`ad esempio . Questa stringa deve essere presente solo se VS_FF_PRIVATEBUILD è specificato nel parametro fileflags del blocco radice.
ProductName	Nome del prodotto con cui viene distribuito il file. Questa stringa è obbligatoria.
ProductVersion	Versione del prodotto con cui viene distribuito il file, `3.10` ad esempio o `5.00.RC2`. Questa stringa è obbligatoria.
SpecialBuild	Testo che specifica il modo in cui questa versione del file è diversa dalla versione standard, `Private build for TESTER1 solving mouse problems on M250 and M250E computers`ad esempio . Questa stringa deve essere presente solo se VS_FF_SPECIALBUILD è specificato nel parametro fileflags del blocco radice.

Alcuni attributi sono supportati anche per la compatibilità con le versioni precedenti. Per altre informazioni, vedere Attributi comuni delle risorse.

Esempio

L'esempio seguente definisce una risorsa VERSIONINFO :

#define VER_FILEVERSION             3,10,349,0
#define VER_FILEVERSION_STR         "3.10.349.0\0"

#define VER_PRODUCTVERSION          3,10,0,0
#define VER_PRODUCTVERSION_STR      "3.10\0"

#ifndef DEBUG
#define VER_DEBUG                   0
#else
#define VER_DEBUG                   VS_FF_DEBUG
#endif

VS_VERSION_INFO VERSIONINFO
FILEVERSION     VER_FILEVERSION
PRODUCTVERSION  VER_PRODUCTVERSION
FILEFLAGSMASK   VS_FFI_FILEFLAGSMASK
FILEFLAGS       (VER_PRIVATEBUILD|VER_PRERELEASE|VER_DEBUG)
FILEOS          VOS__WINDOWS32
FILETYPE        VFT_DLL
FILESUBTYPE     VFT2_UNKNOWN
BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904E4"
        BEGIN
            VALUE "CompanyName",      VER_COMPANYNAME_STR
            VALUE "FileDescription",  VER_FILEDESCRIPTION_STR
            VALUE "FileVersion",      VER_FILEVERSION_STR
            VALUE "InternalName",     VER_INTERNALNAME_STR
            VALUE "LegalCopyright",   VER_LEGALCOPYRIGHT_STR
            VALUE "LegalTrademarks1", VER_LEGALTRADEMARKS1_STR
            VALUE "LegalTrademarks2", VER_LEGALTRADEMARKS2_STR
            VALUE "OriginalFilename", VER_ORIGINALFILENAME_STR
            VALUE "ProductName",      VER_PRODUCTNAME_STR
            VALUE "ProductVersion",   VER_PRODUCTVERSION_STR
        END
    END

    BLOCK "VarFileInfo"
    BEGIN
        /* The following line should only be modified for localized versions.     */
        /* It consists of any number of WORD,WORD pairs, with each pair           */
        /* describing a language,codepage combination supported by the file.      */
        /*                                                                        */
        /* For example, a file might have values "0x409,1252" indicating that it  */
        /* supports English language (0x409) in the Windows ANSI codepage (1252). */

        VALUE "Translation", 0x409, 1252

    END
END

Vedi anche

Uso delle informazioni sulla versione
Informazioni sulla versione

Condividi tramite

Risorsa VERSIONINFO

Parametri

Commenti

Esempio

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive