GlobalUnlock 函式 (winbase.h)
遞減與配置 GMEM_MOVEABLE記憶體物件相關聯的鎖定計數。 此函式不會影響搭配 GMEM_FIXED配置的記憶體物件。
語法
BOOL GlobalUnlock(
[in] HGLOBAL hMem
);
參數
[in] hMem
全域記憶體物件的控制碼。 GlobalAlloc或GlobalReAlloc函式會傳回此控制碼。
傳回值
如果記憶體物件在遞減鎖定計數之後仍鎖定,則傳回值是非零值。 如果記憶體物件在遞減鎖定計數之後解除鎖定,則函式會傳回零,而 GetLastError 會傳回 NO_ERROR。
如果函式失敗,則傳回值為零,而 GetLastError 會傳回 NO_ERROR以外的值。
備註
每個記憶體物件的內部資料結構都包含一開始為零的鎖定計數。 對於可移動的記憶體物件, GlobalLock 函式會將計數遞增一, 而 GlobalUnlock 會將計數遞減一。 對於進程對 物件進行 GlobalLock 的每個呼叫,最終必須呼叫 GlobalUnlock。 除非使用 GlobalReAlloc 函式重新配置記憶體物件,否則不會移動或捨棄鎖定的記憶體。 鎖定記憶體物件的記憶體區塊會維持鎖定狀態,直到鎖定計數遞減為零為止,此時可以移動或捨棄它。
配置 GMEM_FIXED 的記憶體物件一律具有零的鎖定計數。 如果指定的記憶體區塊是固定記憶體,此函式會傳回 TRUE。
如果記憶體物件已經解除鎖定, GlobalUnlock 會傳回 FALSE 和 GetLastError 報告 ERROR_NOT_LOCKED。
進程不應該依賴傳回值來判斷它後續必須呼叫 Memory 物件的 GlobalUnlock 次數。
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | winbase.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |