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.10ad esempio o5.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.10ad esempio o5.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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per