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 |