Fungsi GetFileVersionInfoW (winver.h)
Mengambil informasi versi untuk file yang ditentukan.
Sintaks
BOOL GetFileVersionInfoW(
[in] LPCWSTR lptstrFilename,
DWORD dwHandle,
[in] DWORD dwLen,
[out] LPVOID lpData
);
Parameter
[in] lptstrFilename
Jenis: LPCTSTR
Nama file. Jika jalur lengkap tidak ditentukan, fungsi menggunakan urutan pencarian yang ditentukan oleh fungsi LoadLibrary .
dwHandle
Jenis: DWORD
Parameter diabaikan
[in] dwLen
Jenis: DWORD
Ukuran, dalam byte, dari buffer yang diacu oleh parameter lpData .
Panggil fungsi GetFileVersionInfoSize terlebih dahulu untuk menentukan ukuran, dalam byte, dari informasi versi file. Anggota dwLen harus sama dengan atau lebih besar dari nilai tersebut.
Jika buffer yang diarahkan oleh lpData tidak cukup besar, fungsi akan memotong informasi versi file ke ukuran buffer.
[out] lpData
Jenis: LPVOID
Penunjuk ke buffer yang menerima informasi versi file.
Anda dapat menggunakan nilai ini dalam panggilan berikutnya ke fungsi VerQueryValue untuk mengambil data dari buffer.
Mengembalikan nilai
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Info versi file memiliki bagian tetap dan tidak tetap. Bagian tetap berisi informasi seperti nomor versi. Bagian yang tidak tetap berisi hal-hal seperti string. Di masa lalu GetFileVersionInfo mengambil informasi versi dari biner (exe/dll). Saat ini, ia mengkueri versi tetap dari file netral bahasa (exe/dll) dan bagian yang tidak tetap dari file mui, menggabungkannya dan kembali ke pengguna. Jika biner yang diberikan tidak memiliki file mui, maka perilakunya seperti pada versi sebelumnya.
Panggil fungsi GetFileVersionInfoSize sebelum memanggil fungsi GetFileVersionInfo . Untuk mengambil informasi dari buffer informasi versi file, gunakan fungsi VerQueryValue .
Catatan
Header winver.h mendefinisikan GetFileVersionInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winver.h (termasuk Windows.h) |
Pustaka | Version.lib |
DLL | Api-ms-win-core-version-l1-1-0.dll |
Lihat juga
Konseptual
Referensi