Bagikan melalui

Sumber daya VERSIONINFO

  • Artikel

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