localUnlock 函式 (winbase.h)

發行項
08/27/2023

遞減與配置 LMEM_MOVEABLE記憶體物件相關聯的鎖定計數。此函式不會影響搭配 LMEM_FIXED配置的記憶體物件。

注意本機函式具有更大的額外負荷，並提供比其他記憶體管理功能少的功能。除非檔指出應該使用本機函式，否則新的應用程式應該使用堆積函式。如需詳細資訊，請參閱全域和區域函式。

語法

BOOL LocalUnlock(
  [in] HLOCAL hMem
);

參數

[in] hMem

本機記憶體物件的控制碼。 LocalAlloc或LocalReAlloc函式會傳回此控制碼。

傳回值

如果記憶體物件在遞減鎖定計數之後仍鎖定，則傳回值為非零。如果記憶體物件在遞減鎖定計數之後解除鎖定，則函式會傳回零，而 GetLastError 會傳回 NO_ERROR。

如果函式失敗，則傳回值為零，而 GetLastError 會傳回 NO_ERROR以外的值。

備註

每個記憶體物件的內部資料結構都包含一開始為零的鎖定計數。對於可移動的記憶體物件， LocalLock 函式會將計數遞增一，而 LocalUnlock 會將計數遞減一。對於進程針對物件對 LocalLock 進行的每個呼叫，最終都必須呼叫 LocalUnlock。除非使用 LocalReAlloc 函式重新配置記憶體物件，否則不會移動或捨棄鎖定的記憶體。鎖定記憶體物件的記憶體區塊會維持鎖定狀態，直到鎖定計數遞減為零為止，此時可以移動或捨棄它。

如果記憶體物件已經解除鎖定， LocalUnlock 會傳回 FALSE 和 GetLastError 報告 ERROR_NOT_LOCKED。配置 LMEM_FIXED 的記憶體物件一律具有零的鎖定計數，並導致 ERROR_NOT_LOCKED 錯誤。

進程不應該依賴傳回值來判斷它後續必須呼叫 LocalUnlock 作為記憶體區塊的次數。

規格需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll