Fungsi GetFileVersionInfoExA (winver.h)

Artikel
03/11/2023

Mengambil informasi versi untuk file yang ditentukan.

Sintaks

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parameter

[in] dwFlags

Jenis: DWORD

Mengontrol DLL MUI (jika ada) tempat sumber daya versi diekstraksi. Nilai bendera ini harus cocok dengan bendera yang diteruskan ke panggilan GetFileVersionInfoSizeEx yang sesuai, yang digunakan untuk menentukan ukuran buffer yang diteruskan dalam parameter dwLen . Nol atau lebih dari bendera berikut.

Nilai	Makna
FILE_VER_GET_LOCALISED 0x01	Memuat seluruh sumber daya versi (baik string maupun informasi versi biner) dari file MUI yang sesuai, jika tersedia.
FILE_VER_GET_NEUTRAL 0x02	Memuat string sumber daya versi dari file MUI yang sesuai, jika tersedia, dan memuat informasi versi biner (VS_FIXEDFILEINFO) dari file netral bahasa yang sesuai, jika tersedia.
FILE_VER_GET_PREFETCHED 0x04	Menunjukkan preferensi bagi version.dll untuk mencoba memuat gambar sebelumnya di luar kunci pemuat untuk menghindari pertikaian. Bendera ini tidak mengubah perilaku atau semantik fungsi.

[in] lpwstrFilename

Jenis: LPCTSTR

Nama file. Jika jalur lengkap tidak ditentukan, fungsi menggunakan urutan pencarian yang ditentukan oleh fungsi LoadLibrary .

dwHandle

Jenis: DWORD

Parameter ini dicadangkan, dan diharapkan nol (0).

[in] dwLen

Jenis: DWORD

Ukuran, dalam byte, dari buffer yang diacu oleh parameter lpData .

Panggil fungsi GetFileVersionInfoSizeEx terlebih dahulu untuk menentukan ukuran, dalam byte, dari informasi versi file. Parameter 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

Saat fungsi ini kembali, berisi penunjuk ke buffer yang berisi 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

Panggil fungsi GetFileVersionInfoSizeEx sebelum memanggil fungsi GetFileVersionInfoEx . Untuk mengambil informasi dari buffer informasi versi file, gunakan fungsi VerQueryValue .

Catatan

Header winver.h mendefinisikan GetFileVersionInfoEx 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


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [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