RtlFreeHeap-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlFreeHeap Routine gibt einen Speicherblock frei, der von einem Heap durch RtlAllocateHeapzugewiesen wurde.

Syntax

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

Parameter

[in] HeapHandle

Ein Handle für den Heap, dessen Speicherblock freigegeben werden soll. Dieser Parameter ist ein Handle, das von RtlCreateHeapzurückgegeben wird.

[in, optional] Flags

Eine Reihe von Flags, die Aspekte des Freigebens eines Speicherblocks steuern. Wenn Sie den folgenden Wert angeben, wird der entsprechende Wert außer Kraft gesetzt, der im parameter Flags angegeben wurde, als der Heap von RtlCreateHeaperstellt wurde.

Flagge	Bedeutung
HEAP_NO_SERIALIZE	Der gegenseitige Ausschluss wird nicht verwendet, wenn RtlFreeHeap- auf den Heap zugreift.

BaseAddress

Ein Zeiger auf den Speicherblock, der freigegeben werden soll. Dieser Zeiger wird von RtlAllocateHeapzurückgegeben.

Rückgabewert

RtlFreeHeap- gibt TRUE zurück, wenn der Block erfolgreich freigegeben wurde; andernfalls FALSE.

Hinweis Ab Windows 8 wird der Rückgabewert als LOGICAL-eingegeben, der eine andere Größe hat als VOM TYP BOOLEAN.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows XP.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	< DISPATCH_LEVEL

Siehe auch

RtlAllocateHeap-

RtlCreateHeap-

RtlDestroyHeap-

Freigeben über