RtlDestroyHeap 函数 (ntifs.h)

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

语法

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

参数

[in] HeapHandle

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

返回值

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

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

注解

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

要求

要求
最低受支持的客户端 Windows XP
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap