Fungsi GlobalUnlock (winbase.h)

Mengurangi jumlah kunci yang terkait dengan objek memori yang dialokasikan dengan GMEM_MOVEABLE. Fungsi ini tidak berpengaruh pada objek memori yang dialokasikan dengan GMEM_FIXED.

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

BOOL GlobalUnlock(
  [in] HGLOBAL hMem
);

Parameter

[in] hMem

Handel ke objek memori global. Handel ini dikembalikan oleh fungsi GlobalAlloc atau GlobalReAlloc .

Mengembalikan nilai

Jika objek memori masih dikunci setelah mengurangi jumlah kunci, nilai yang dikembalikan adalah nilai bukan nol. Jika objek memori tidak terkunci setelah mengurangi jumlah kunci, fungsi mengembalikan nol dan GetLastError mengembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah nol dan GetLastError mengembalikan nilai selain NO_ERROR.

Keterangan

Struktur data internal untuk setiap objek memori menyertakan jumlah kunci yang awalnya nol. Untuk objek memori yang dapat dipangkas, fungsi GlobalLock menaikkan hitungan satu per satu, dan GlobalUnlock mengurangi hitungan satu per satu. Untuk setiap panggilan yang dilakukan proses ke GlobalLock untuk objek, pada akhirnya harus memanggil GlobalUnlock. Memori terkunci tidak akan dipindahkan atau dibuang, kecuali objek memori direalokasikan dengan menggunakan fungsi GlobalReAlloc . Blok memori objek memori terkunci tetap terkunci sampai jumlah kuncinya dikurangi menjadi nol, pada saat itu dapat dipindahkan atau dibuang.

Objek memori yang dialokasikan dengan GMEM_FIXED selalu memiliki jumlah kunci nol. Jika blok memori yang ditentukan adalah memori tetap, fungsi ini mengembalikan TRUE.

Jika objek memori sudah tidak terkunci, GlobalUnlock mengembalikan laporan FALSE dan GetLastErrorERROR_NOT_LOCKED.

Proses tidak boleh mengandalkan nilai pengembalian untuk menentukan berapa kali kemudian harus memanggil GlobalUnlock untuk objek memori.

Persyaratan

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

Lihat juga

Fungsi Global dan Lokal

GlobalAlloc

GlobalLock

GlobalReAlloc

Fungsi Manajemen Memori