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 |