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.
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 |