Fungsi BeginUpdateResourceW (winbase.h)

Mengambil handel yang dapat digunakan oleh fungsi UpdateResource untuk menambahkan, menghapus, atau mengganti sumber daya dalam modul biner.

Sintaksis

HANDLE BeginUpdateResourceW(
  [in] LPCWSTR pFileName,
  [in] BOOL    bDeleteExistingResources
);

Parameter

[in] pFileName

Jenis: LPCTSTR

File biner untuk memperbarui sumber daya. Aplikasi harus dapat memperoleh akses tulis ke file ini; file yang dirujuk oleh pFileName saat ini tidak dapat dijalankan. Jika pFileName tidak menentukan jalur lengkap, sistem akan mencari file di direktori saat ini.

[in] bDeleteExistingResources

Jenis: BOOL

Menunjukkan apakah akan menghapus sumber daya parameter pFileName yang ada. Jika parameter ini TRUE, sumber daya yang ada dihapus dan file yang diperbarui hanya menyertakan sumber daya yang ditambahkan dengan fungsi UpdateResource. Jika parameter ini FALSE, file yang diperbarui menyertakan sumber daya yang ada kecuali jika secara eksplisit dihapus atau diganti dengan menggunakan UpdateResource.

Mengembalikan nilai

Jenis: HANDLE

Jika fungsi berhasil, nilai pengembalian adalah handel yang dapat digunakan oleh fungsi UpdateResource dan EndUpdateResource. Nilai yang dikembalikan NULL jika file yang ditentukan bukan PE, file tidak ada, atau file tidak dapat dibuka untuk ditulis. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Disarankan agar file sumber daya tidak dimuat sebelum fungsi ini dipanggil. Namun, jika file tersebut sudah dimuat, file tersebut tidak akan menyebabkan kesalahan dikembalikan.

Ada beberapa batasan pada pembaruan sumber daya dalam file yang berisi data Konfigurasi Sumber Daya (Konfigurasi RC): File LN dan file .mui terkait. Detail tentang jenis sumber daya mana yang diizinkan untuk diperbarui dalam file-file ini berada di bagian Keterangan untuk fungsi UpdateResource.

Fungsi ini dapat memperbarui sumber daya dalam modul yang berisi kode dan sumber daya. Seperti disebutkan di atas, ada pembatasan pembaruan sumber daya dalam file LN dan file .mui, yang keduanya berisi data Konfigurasi RC; detail pembatasan berada dalam referensi untuk fungsi UpdateResource.

Contoh

Misalnya, lihat, Memperbarui Sumber Daya.

Nota

Header winbase.h mendefinisikan BeginUpdateResource 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Konseptual

endUpdateResource

Referensi

Sumber Daya

UpdateResource