RtlDestroyHeap 函式 (ntifs.h)

RtlDestroyHeap 例程會終結指定的堆積物件。 RtlDestroyHeap 會取消認可並釋放私人堆積物件的所有頁面,並且使堆積的句柄失效。

語法

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

參數

[in] HeapHandle

要終結之堆積的句柄。 此參數是 RtlCreateHeap 所傳回的堆積句柄。

傳回值

如果對 RtlDestroyHeap 的呼叫成功,則傳回值為 NULL 指標。

如果對 RtlDestroyHeap 的呼叫失敗,傳回值就是堆積的句柄。

備註

進程可以呼叫 RtlDestroyHeap ,而不需要先呼叫 RtlFreeHeap 以釋放從堆積配置的記憶體。

規格需求

需求
最低支援的用戶端 Windows XP
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另請參閱

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap