Bagikan melalui


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