Fungsi GetFileVersionInfoSizeExA (winver.h)

Artikel
08/28/2023

Menentukan apakah sistem operasi dapat mengambil informasi versi untuk file tertentu. Jika informasi versi tersedia, GetFileVersionInfoSizeEx mengembalikan ukuran, dalam byte, dari informasi tersebut.

Sintaks

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parameter

[in] dwFlags

Jenis: DWORD

Mengontrol DLL MUI mana (jika ada) dari mana sumber daya versi diekstraksi. 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 0x002	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.

[in] lpwstrFilename

Jenis: LPCTSTR

Nama file yang diminati. Fungsi ini menggunakan urutan pencarian yang ditentukan oleh fungsi LoadLibrary .

[out, optional] lpdwHandle

Jenis: LPDWORD

Ketika fungsi ini kembali, berisi penunjuk ke variabel yang diatur ke nol karena fungsi ini mengaturnya ke nol. Parameter ini ada karena alasan historis.

Nilai kembali

Jenis: DWORD

Jika fungsi berhasil, nilai yang dikembalikan adalah ukuran, dalam byte, dari informasi versi file.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Panggil fungsi GetFileVersionInfoSizeEx sebelum memanggil fungsi GetFileVersionInfoEx . Ukuran yang dikembalikan oleh GetFileVersionInfoSizeEx menunjukkan ukuran buffer yang diperlukan untuk informasi versi yang dikembalikan oleh GetFileVersionInfoEx.

Catatan

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