Fungsi GlobalHandle (winbase.h)

Mengambil handel yang terkait dengan penunjuk yang ditentukan ke blok memori global.

Catatan Fungsi global 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 global harus digunakan. Untuk informasi selengkapnya, lihat Fungsi Global dan Lokal.

 

Sintaks

HGLOBAL GlobalHandle(
  [in] LPCVOID pMem
);

Parameter

[in] pMem

Penunjuk ke byte pertama dari blok memori global. Penunjuk ini dikembalikan oleh fungsi GlobalLock .

Nilai kembali

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

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

Keterangan

Ketika fungsi GlobalAlloc mengalokasikan objek memori dengan GMEM_MOVEABLE, fungsi mengembalikan handel ke objek . Fungsi GlobalLock mengonversi handel ini menjadi penunjuk ke blok memori, dan GlobalHandle 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

GlobalAlloc

GlobalLock

Fungsi Manajemen Memori