Fungsi GetFileVersionInfoA (winver.h)

Artikel
03/04/2024

Mengambil informasi versi untuk file yang ditentukan.

Sintaks

BOOL GetFileVersionInfoA(
  [in]  LPCSTR 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