heapLock 函式 (heapapi.h)

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

語法

BOOL HeapLock(
  [in] HANDLE hHeap
);

[in] hHeap

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

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

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

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

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

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

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