Fungsi LockResource (libloaderapi.h)
Mengambil penunjuk ke sumber daya yang ditentukan dalam memori.
Sintaks
LPVOID LockResource(
[in] HGLOBAL hResData
);
Parameter
[in] hResData
Jenis: HGLOBAL
Handel ke sumber daya yang akan diakses. Fungsi LoadResource mengembalikan handel ini. Perhatikan bahwa parameter ini terdaftar sebagai variabel HGLOBAL hanya untuk kompatibilitas mundur. Jangan meneruskan nilai apa pun sebagai parameter selain nilai pengembalian yang berhasil dari fungsi LoadResource .
Nilai kembali
Jenis: LPVOID
Jika sumber daya yang dimuat tersedia, nilai yang dikembalikan adalah penunjuk ke byte pertama sumber daya; jika tidak, null.
Keterangan
Pointer yang dikembalikan oleh LockResource valid hingga modul yang berisi sumber daya dibongkar. Tidak perlu membuka kunci sumber daya karena sistem secara otomatis menghapusnya ketika proses yang membuatnya berakhir.
Jangan mencoba mengunci sumber daya dengan menggunakan handel yang dikembalikan oleh fungsi FindResourceA atau fungsiFindResourceExA . Pegangan seperti itu menunjuk ke data acak.
Catatan
LockResource sebenarnya tidak mengunci memori; ini hanya digunakan untuk mendapatkan pointer ke memori yang berisi data sumber daya. Nama fungsi berasal dari versi sebelum Windows XP, ketika digunakan untuk mengunci blok memori global yang dialokasikan oleh LoadResource.
Contoh
Misalnya, lihat Memperbarui Sumber Daya.
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 | libloaderapi.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |