heapDestroy 函式 (heapapi.h)

終結指定的堆積物件。

HeapDestroy 取消認可並釋放私人堆積物件的所有頁面，並使堆積的句柄失效。

語法

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

[in] hHeap

要終結之堆積的句柄。 HeapCreate 函式會傳回這個句柄。請勿將句柄用於 GetProcessHeap 函式所傳回的進程堆積。

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

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

進程可以呼叫 HeapDestroy ，而不需要先呼叫 HeapFree 函式以釋放從堆積配置的記憶體。


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