共用方式為


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

另請參閱

堆積函式

HeapCreate

記憶體管理功能

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