HeapUnlock 函式 (heapapi.h)
釋放與指定堆積相關聯的重要區段對象或鎖定的擁有權。 它會反轉 HeapLock 函式的動作。
語法
BOOL HeapUnlock(
[in] HANDLE hHeap
);
參數
[in] hHeap
要解除鎖定之堆積的句柄。 HeapCreate 或 GetProcessHeap 函式會傳回此句柄。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
HeapLock 函式主要用於防止其他線程配置和釋放堆積記憶體,而呼叫線程使用 HeapWalk 函式。 HeapUnlock 函式是 HeapLock 的反轉。
HeapLock 的每個呼叫都必須符合對 HeapUnlock 函式的對應呼叫。 呼叫 HeapUnlock 失敗會封鎖嘗試存取堆積之呼叫進程的任何其他線程執行。
如果在使用 HEAP_NO_SERIALIZATION 旗標建立的堆積上呼叫 HeapUnlock 函式,則結果未定義。
範例
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | heapapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |