(ntifs.h) RtlDestroyHeap 函数

RtlDestroyHeap 例程销毁指定的堆对象。 RtlDestroyHeap 取消提交并释放专用堆对象的所有页面,并使堆的句柄失效。

语法

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

参数

[in] HeapHandle

要销毁堆的句柄。 此参数是 RtlCreateHeap 返回的堆句柄。

返回值

如果对 RtlDestroyHeap 的调用成功,则返回值为 NULL 指针。

如果对 RtlDestroyHeap 的调用失败,则返回值是堆的句柄。

备注

进程可以调用 RtlDestroyHeap ,而无需首先调用 RtlFreeHeap 来释放从堆分配的内存。

要求

   
最低受支持的客户端 此例程在 Microsoft Windows XP 及更高版本上可用。
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap