Fungsi LocalHandle (winbase.h)

Mengambil handel yang terkait dengan penunjuk yang ditentukan ke objek memori lokal.

Catatan Fungsi lokal memiliki overhead yang lebih besar dan menyediakan lebih sedikit fitur daripada fungsi manajemen memori lainnya. Aplikasi baru harus menggunakan fungsi heap kecuali dokumentasi menyatakan bahwa fungsi lokal harus digunakan. Untuk informasi selengkapnya, lihat Fungsi Global dan Lokal.

 

Sintaks

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

Parameter

[in] pMem

Penunjuk ke byte pertama dari objek memori lokal. Penunjuk ini dikembalikan oleh fungsi LocalLock .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek memori lokal yang ditentukan.

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

Keterangan

Saat fungsi LocalAlloc mengalokasikan objek memori lokal dengan LMEM_MOVEABLE, fungsi mengembalikan handel ke objek . Fungsi LocalLock mengonversi handel ini menjadi penunjuk ke blok memori objek, dan LocalHandle mengonversi pointer kembali menjadi handel.

Persyaratan

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

Lihat juga

Fungsi Global dan Lokal

LocalAlloc

LocalLock

Fungsi Manajemen Memori