HeapUnlock 函式 (heapapi.h)

釋放與指定堆積相關聯的重要區段對象或鎖定的擁有權。 它會反轉 HeapLock 函式的動作。

語法

BOOL HeapUnlock(
  [in] HANDLE hHeap
);

參數

[in] hHeap

要解除鎖定之堆積的句柄。 HeapCreateGetProcessHeap 函式會傳回此句柄。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 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

另請參閱

堆積函式

HeapLock

HeapWalk

記憶體管理功能

VBS 記憶體保護區中可用的 Vertdll API