共用方式為


heapLock 函式 (heapapi.h)

嘗試取得與指定堆積相關聯的重要區段對象或鎖定。

語法

BOOL HeapLock(
  [in] HANDLE hHeap
);

參數

[in] hHeap

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

傳回值

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

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

如果函式成功,呼叫線程就會擁有堆積鎖定。 只有呼叫線程能夠配置或釋放堆積中的記憶體。 如果該線程嘗試從堆積配置或釋放記憶體,則會封鎖呼叫進程的任何其他線程執行。 這類線程會保持封鎖狀態,直到擁有堆積鎖定的線程呼叫 HeapUnlock 函式為止。

HeapLock 函式主要用於防止其他線程配置和釋放堆積記憶體,而呼叫線程使用 HeapWalk 函式。

如果在以 HEAP_NO_SERIALIZE 旗標建立的堆積上呼叫 HeapLock 函式,則結果為未定義。

HeapLock 的每個成功呼叫都必須與 對 HeapUnlock 的對應呼叫進行比對。 呼叫 HeapUnlock 失敗將會封鎖嘗試存取堆積之呼叫進程的任何其他線程執行。

範例

列舉堆積

規格需求

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

另請參閱

堆積函式

HeapUnlock

HeapWalk

記憶體管理功能

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