HeapDestroy 函数 (heapapi.h)

销毁指定的堆对象。

HeapDestroy 会取消提交并释放私有堆对象的所有页面，并使堆的句柄失效。

语法

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

[in] hHeap

要销毁的堆的句柄。此句柄由 HeapCreate 函数返回。请勿使用 GetProcessHeap 函数返回的进程堆的句柄。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

进程可以调用 HeapDestroy ，而无需先调用 HeapFree 函数来释放从堆中分配的内存。