Fungsi BeginUpdateResourceA (winbase.h)

Artikel
03/08/2023

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

Sintaks

HANDLE BeginUpdateResourceA(
  [in] LPCSTR 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 akan 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.

Nilai kembali

Jenis: HANDEL

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

Keterangan

Disarankan agar file sumber daya tidak dimuat sebelum fungsi ini dipanggil. Namun, jika file tersebut sudah dimuat, itu 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 ada dalam referensi untuk fungsi UpdateResource .

Contoh

Misalnya lihat, Memperbarui Sumber Daya.

Catatan

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


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