Condividi tramite


Risorsa VERSIONINFO

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 Keyboardsad 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 \\TESTBEDad 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 computersad 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