Функция RtlDestroyHeap (ntifs.h)

Подпрограмма RtlDestroyHeap уничтожает указанный объект кучи. RtlDestroyHeap удаляет и освобождает все страницы частного объекта кучи и делает дескриптор кучи недействительным.

Синтаксис

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

Параметры

[in] HeapHandle

Дескриптор для уничтожения кучи. Этот параметр представляет собой дескриптор кучи, возвращаемый RtlCreateHeap.

Возвращаемое значение

При успешном вызове RtlDestroyHeap возвращаемое значение будет указателем NULL .

Если вызов RtlDe примерheap завершается ошибкой, возвращаемое значение является дескриптором для кучи.

Комментарии

Процессы могут вызывать RtlDestroyHeap без предварительного вызова RtlFreeHeap для освобождения памяти, выделенной из кучи.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

См. также раздел

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap