Fungsi LoadResource (libloaderapi.h)

Artikel
03/04/2024

Mengambil handel yang dapat digunakan untuk mendapatkan penunjuk ke byte pertama dari sumber daya yang ditentukan dalam memori.

Sintaks

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

Parameter

[in, optional] hModule

Jenis: HMODULE

Handel ke modul yang file yang dapat dieksekusi berisi sumber daya. Jika hModule adalah NULL, sistem memuat sumber daya dari modul yang digunakan untuk membuat proses saat ini.

[in] hResInfo

Jenis: HRSRC

Handel ke sumber daya yang akan dimuat. Handel ini dikembalikan oleh fungsi FindResource atau FindResourceEx .

Nilai kembali

Jenis: HGLOBAL

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke data yang terkait dengan sumber daya.

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

Keterangan

Jenis pengembalian LoadResource adalah HGLOBAL untuk kompatibilitas mundur, bukan karena fungsi mengembalikan handel ke blok memori global. Jangan teruskan handel ini ke fungsi GlobalLock atau GlobalFree . Untuk mendapatkan penunjuk ke byte pertama data sumber daya, panggil fungsi LockResource ; untuk mendapatkan ukuran sumber daya, panggil SizeofResource.

GlobalSize mengembalikan 0 untuk HGLOBAL sumber daya. Akibatnya, API apa pun yang bergantung pada GlobalSize untuk menentukan ukuran HGLOBAL tidak akan berfungsi dengan benar. Misalnya, gunakan SHCreateMemStream alih-alih CreateStreamOnHGlobal.

Untuk segera menggunakan sumber daya, aplikasi harus menggunakan fungsi khusus sumber daya berikut untuk menemukan dan memuat sumber daya dalam satu panggilan.

Fungsi	Tindakan	Untuk menghapus sumber daya
FormatMessage	Memuat dan memformat entri tabel pesan	Tidak ada tindakan yang diperlukan
LoadAccelerators	Memuat tabel akselerator	DestroyAcceleratorTable
LoadBitmap	Memuat sumber daya bitmap	DeleteObject
LoadCursor	Memuat sumber daya kursor	DestroyCursor
LoadIcon	Memuat sumber daya ikon	DestroyIcon
LoadMenu	Memuat sumber daya menu	DestroyMenu
LoadString	Memuat sumber daya string	Tidak ada tindakan yang diperlukan

Misalnya, aplikasi dapat menggunakan fungsi LoadIcon untuk memuat ikon untuk ditampilkan di layar, diikuti oleh DestroyIcon setelah selesai.

Contoh

Misalnya lihat Memperbarui Sumber Daya.

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	libloaderapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll