Fungsi LoadResource (libloaderapi.h)

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

Sintaksis

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

Parameter-parameternya

[in, optional] hModule

Jenis: HMODULE

Handel ke modul yang file yang dapat dieksekusi berisi sumber daya. Jika hModuleADALAH 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 .

Mengembalikan nilai

Jenis: HGLOBAL

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

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

Komentar

Jenis pengembalian LoadResource adalah HGLOBAL untuk kompatibilitas mundur, bukan karena fungsi mengembalikan handel ke blok memori global. Jangan meneruskan 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 sumber daya HGLOBAL. 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]
Platform Target	Windows
Header	libloaderapi.h (termasuk Windows.h)
Perpustakaan	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

FindResource

FindResourceEx

LoadLibrary

LoadModule

LockResource