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

Статья
02/27/2024

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

Синтаксис

NTSYSAPI LOGICAL RtlFreeHeap(
  [in]           PVOID                 HeapHandle,
  [in, optional] ULONG                 Flags,
                 _Frees_ptr_opt_ PVOID BaseAddress
);

Параметры

[in] HeapHandle

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

[in, optional] Flags

Набор флагов, определяющих аспекты освобождения блока памяти. При указании следующего значения переопределяется соответствующее значение, указанное в параметре Flags при создании кучи rtlCreateHeap.

Flag	Значение
HEAP_NO_SERIALIZE	Взаимное исключение не будет использоваться, если RtlFreeHeap обращается к куче.

BaseAddress

Указатель на свободный блок памяти. Этот указатель возвращается rtlAllocateHeap.

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

RtlFreeHeap возвращает значение TRUE , если блок был успешно освобожден; Значение FALSE в противном случае.

Примечание Начиная с Windows 8 возвращаемое значение вводится как LOGICAL, размер которого отличается от размера BOOLEAN.

Требования

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

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

RtlAllocateHeap

RtlCreateHeap

RtlDe определенияheap

Share via