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) |
Library | Kernel32.lib |
DLL | Kernel32.dll |