Bagikan melalui

Fungsi LockResource (libloaderapi.h)

  • Artikel

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

Lihat juga

Konseptual

Referensi