Sumber daya VERSIONINFO

Artikel
06/13/2023

Menentukan sumber daya informasi versi. Sumber daya berisi informasi tentang file sebagai nomor versinya, sistem operasi yang dimaksudkan, dan nama file aslinya. Sumber daya dimaksudkan untuk digunakan dengan fungsi Informasi Versi .

Ada dua cara untuk memformat pernyataan VERSIONINFO :

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

- atau -

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

Parameter

versionID

Pengidentifikasi sumber daya informasi versi. Nilai ini harus 1.

info tetap

Informasi versi, seperti versi file dan sistem operasi yang dimaksudkan. Parameter ini terdiri dari pernyataan berikut.

Pernyataan	Deskripsi
Versi FILEVERSION	Nomor versi biner untuk file. Versi ini terdiri dari dua bilangan bulat 32-bit, yang ditentukan oleh empat bilangan bulat 16-bit. Misalnya, "FILEVERSION 3,10,0,61" diterjemahkan ke dalam dua kata ganda: 0x0003000a dan 0x0000003d, dalam urutan tersebut. Oleh karena itu, jika versi didefinisikan oleh nilai DWORDdw1 dan dw2, mereka perlu muncul dalam pernyataan FILEVERSION sebagai berikut: `HIWORD(dw1)`, , `LOWORD(dw1)`, `LOWORD(dw2)HIWORD(dw2)`.
Versi PRODUCTVERSION	Nomor versi biner untuk produk tempat file didistribusikan. Parameter versi adalah dua bilangan bulat 32-bit, yang ditentukan oleh empat bilangan bulat 16-bit. Untuk informasi selengkapnya tentang versi, lihat deskripsi FILEVERSION .
FILEFLAGSMASKfileflagsmask	Menunjukkan bit mana dalam pernyataan FILEFLAGS yang valid. Untuk Windows 16-bit, nilai ini 0x3f.
FILEFLAGSfileflags	Atribut file.
Fileos FILEOS	Sistem operasi yang dirancang untuk file ini. Parameter fileos dapat menjadi salah satu nilai sistem operasi yang diberikan di bagian Keterangan.
Jenis file FILETYPE	Jenis file umum. Parameter jenis file dapat menjadi salah satu nilai jenis file yang tercantum di bagian Keterangan.
SubjenisFILESUBTYPE	Fungsi file. Parameter subjenis adalah nol kecuali parameter jenis file dalam pernyataan FILETYPE VFT_DRV, VFT_FONT, atau VFT_VXD. Untuk daftar nilai subjenis file, lihat bagian Keterangan.

pernyataan blok

Menentukan satu atau beberapa blok informasi versi. Blok dapat berisi informasi string atau informasi variabel. Untuk informasi selengkapnya, lihat Blok StringFileInfo atau Blok VarFileInfo.

Keterangan

Untuk menggunakan konstanta yang ditentukan dengan pernyataan VERSIONINFO , Anda harus menyertakan file header Winver.h atau Windows.h dalam file definisi sumber daya.

Daftar berikut menjelaskan parameter yang digunakan dalam pernyataan VERSIONINFO :

fileflags

Kombinasi nilai berikut.

Nilai	Deskripsi
VS_FF_DEBUG	File berisi informasi penelusuran kesalahan atau dikompilasi dengan fitur penelusuran kesalahan diaktifkan.
VS_FF_PATCHED	File telah dimodifikasi dan tidak identik dengan file pengiriman asli dari nomor versi yang sama.
VS_FF_PRERELEASE	File adalah versi pengembangan, bukan produk yang dirilis secara komersial.
VS_FF_PRIVATEBUILD	File tidak dibangun menggunakan prosedur rilis standar. Jika nilai ini diberikan, blok StringFileInfo harus berisi string PrivateBuild .
VS_FF_SPECIALBUILD	File dibangun oleh perusahaan asli menggunakan prosedur rilis standar tetapi merupakan variasi file standar dari nomor versi yang sama. Jika nilai ini diberikan, blok blok StringFileInfo harus berisi string SpecialBuild.
VS_FFI_FILEFLAGSMASK	Kombinasi semua nilai sebelumnya.

fileos

Salah satu nilai berikut.

Nilai	Deskripsi
VOS_UNKNOWN	Sistem operasi tempat file dirancang tidak diketahui.
VOS_DOS	File dirancang untuk MS-DOS.
VOS_NT	File dirancang untuk Windows 32-bit.
VOS__WINDOWS16	File dirancang untuk Windows 16-bit.
VOS__WINDOWS32	File dirancang untuk Windows 32-bit.
VOS_DOS_WINDOWS16	File dirancang untuk Windows 16-bit yang berjalan dengan MS-DOS.
VOS_DOS_WINDOWS32	File dirancang untuk Windows 32-bit yang berjalan dengan MS-DOS.
VOS_NT_WINDOWS32	File dirancang untuk Windows 32-bit.

Nilai 0x00002L, 0x00003L, 0x20000L dan 0x30000L dicadangkan.

Filetype

Salah satu nilai berikut.

Nilai	Deskripsi
VFT_UNKNOWN	Tipe file tidak diketahui.
VFT_APP	File berisi aplikasi.
VFT_DLL	File berisi pustaka tautan-dinamis (DLL).
VFT_DRV	File berisi pengandar perangkat. Jika jenis fileVFT_DRV, subjenis berisi deskripsi driver yang lebih spesifik.
VFT_FONT	File berisi font. Jika jenis file VFT_FONT, subjenis berisi deskripsi font yang lebih spesifik.
VFT_VXD	File berisi perangkat virtual.
VFT_STATIC_LIB	File berisi pustaka tautan statis.

Semua nilai lainnya dicadangkan untuk digunakan oleh Microsoft.

Subtipe

Informasi tambahan tentang jenis file.

Jika jenis file menentukan VFT_DRV, parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Deskripsi
VFT2_UNKNOWN	Tipe driver tidak diketahui.
VFT2_DRV_COMM	File berisi pengandar komunikasi.
VFT2_DRV_PRINTER	File berisi pengandar pencetak.
VFT2_DRV_KEYBOARD	File berisi pengandar keyboard.
VFT2_DRV_LANGUAGE	File berisi driver bahasa.
VFT2_DRV_DISPLAY	File berisi pengandar tampilan.
VFT2_DRV_MOUSE	File berisi pengandar mouse.
VFT2_DRV_NETWORK	File berisi driver jaringan.
VFT2_DRV_SYSTEM	File berisi pengandar sistem.
VFT2_DRV_INSTALLABLE	File berisi pengandar yang dapat diinstal.
VFT2_DRV_SOUND	File berisi pengandar suara.
VFT2_DRV_VERSIONED_PRINTER	File berisi pengandar pencetak versi.

Jika jenis file menentukan VFT_FONT, parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Deskripsi
VFT2_UNKNOWN	Tipe font tidak diketahui.
VFT2_FONT_RASTER	File berisi font raster.
VFT2_FONT_VECTOR	File berisi font vektor.
VFT2_FONT_TRUETYPE	File berisi font TrueType.

Jika jenis file menentukan VFT_VXD, parameter ini harus menjadi pengidentifikasi perangkat virtual yang disertakan dalam blok kontrol perangkat virtual.

Semua nilai subjenis yang tidak tercantum di sini dicadangkan untuk digunakan oleh Microsoft.

langID

Salah satu kode bahasa berikut.

Kode	Bahasa	Kode	Bahasa
0x0401	Arab	0x0415	Polski
0x0402	Bulgaria	0x0416	Portugis (Brasil)
0x0403	Katalan	0x0417	Rhaeto-Romanic
0x0404	Mandarin Tradisional	0x0418	Rumania
0x0405	Cheska	0x0419	Rusia
0x0406	Dansk	0x041A	Croato-Serbian (Latin)
0x0407	Jerman	0x041B	Slovak
0x0408	Yunani	0x041C	Albania
0x0409	Inggris A.S.	0x041D	Swedia
0x040A	Bahasa Spanyol Castilian	0x041E	Thailand
0x040B	Suomi	0x041F	Turki
0x040C	Prancis	0x0420	Urdu
0x040D	Ibrani	0x0421	Bahasa Indonesia
0x040E	Hungaria	0x0804	Bahasa Tionghoa Sederhana
0x040F	Islandia	0x0807	Swiss Jerman
0x0410	Italia	0x0809	Inggris U.K.
0x0411	Jepang	0x080A	Spanyol (Meksiko)
0x0412	Korea	0x080C	Bahasa Prancis Belgia
0x0413	Belanda	0x0C0C	Bahasa Prancis Kanada
0x0414	Norwegia? Bokmal	0x100C	Prancis Swiss
0x0810	Italia Swiss	0x0816	Portugis (Portugal)
0x0813	Bahasa Belanda Belgia	0x081A	Serbo-Croatian (Sirilik)
0x0814	Norwegia? Nynorsk

charsetID

Salah satu pengidentifikasi set karakter berikut.

Desimal	Heksadesimal	Tataan Karakter
0	0000	ASCII 7-bit
932	03A4	Jepang (Shift? JIS X-0208)
949	03B5	Korea (Shift? KSC 5601)
950	03B6	Taiwan (Big5)
1200	04B0	Unicode
1250	04E2	Latin-2 (Eropa Timur)
1251	04E3	Sirilik
1252	04E4	Multibahasa
1253	04E5	Yunani
1254	04E6	Turki
1255	04E7	Ibrani
1256	04E8	Arab

nama string

Salah satu nama yang telah ditentukan sebelumnya berikut ini.

Nama	Deskripsi
Komentar	Informasi tambahan yang harus ditampilkan untuk tujuan diagnostik.
CompanyName	Perusahaan yang memproduksi file—misalnya, `Microsoft Corporation` atau `Standard Microsystems Corporation, Inc.` String ini diperlukan.
FileDescription	Deskripsi file yang akan disajikan kepada pengguna. String ini dapat ditampilkan dalam kotak daftar saat pengguna memilih file untuk diinstal—misalnya, `Keyboard Driver for AT-Style Keyboards`. String ini diperlukan.
FileVersion	Nomor versi file—misalnya, `3.10` atau `5.00.RC2`. String ini diperlukan.
InternalName	Nama internal file, jika ada—misalnya, nama modul jika file adalah pustaka tautan dinamis. Jika file tidak memiliki nama internal, string ini harus menjadi nama file asli, tanpa ekstensi. String ini diperlukan.
LegalCopyright	Pemberitahuan hak cipta yang berlaku untuk file. Ini harus mencakup teks lengkap dari semua pemberitahuan, simbol hukum, tanggal hak cipta, dan sebagainya. String ini bersifat opsional.
LegalTrademarks	Merek dagang dan merek dagang terdaftar yang berlaku untuk file. Ini harus mencakup teks lengkap dari semua pemberitahuan, simbol hukum, nomor merek dagang, dan sebagainya. String ini bersifat opsional.
OriginalFilename	Nama asli file, tidak termasuk jalur. Informasi ini memungkinkan aplikasi untuk menentukan apakah file telah diganti namanya oleh pengguna. Format nama tergantung pada sistem file tempat file dibuat. String ini diperlukan.
PrivateBuild	Informasi tentang versi privat file—misalnya, `Built by TESTER1 on \\TESTBED`. String ini harus ada hanya jika VS_FF_PRIVATEBUILD ditentukan dalam parameter fileflags dari blok akar.
ProductName	Nama produk tempat file didistribusikan. String ini diperlukan.
ProductVersion	Versi produk tempat file didistribusikan—misalnya, `3.10` atau `5.00.RC2`. String ini diperlukan.
SpecialBuild	Teks yang menentukan bagaimana versi file ini berbeda dari versi standar—misalnya, `Private build for TESTER1 solving mouse problems on M250 and M250E computers`. String ini harus ada hanya jika VS_FF_SPECIALBUILD ditentukan dalam parameter fileflags dari blok akar.

Atribut tertentu juga didukung untuk kompatibilitas mundur. Untuk informasi selengkapnya, lihat Atribut Sumber Daya Umum.

Contoh

Contoh berikut mendefinisikan sumber daya 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

Lihat juga

Menggunakan Informasi Versi
Informasi Versi

Bagikan melalui

Sumber daya VERSIONINFO

Parameter

Keterangan

Contoh

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: