Fungsi RtlFreeHeap (ntifs.h)

  • Artikel

Rutinitas RtlFreeHeap membebaskan blok memori yang dialokasikan dari timbunan oleh RtlAllocateHeap.

Sintaks

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

Parameter

[in] HeapHandle

Handel untuk tumpukan yang blok memorinya akan dikosongkan. Parameter ini adalah handel yang dikembalikan oleh RtlCreateHeap.

[in, optional] Flags

Sekumpulan bendera yang mengontrol aspek membebaskan blok memori. Menentukan nilai berikut akan menggantikan nilai terkait yang ditentukan dalam parameter Bendera saat tumpukan dibuat oleh RtlCreateHeap.

Bendera Makna
HEAP_NO_SERIALIZE Pengecualian timbal balik tidak akan digunakan ketika RtlFreeHeap mengakses timbunan.

BaseAddress

Pointer ke blok memori untuk membebaskan. Pointer ini dikembalikan oleh RtlAllocateHeap.

Mengembalikan nilai

RtlFreeHeap mengembalikan TRUE jika blok berhasil dibebaskan; FALSE jika tidak.

Catatan Dimulai dengan Windows 8 nilai pengembalian diketik sebagai LOGICAL, yang memiliki ukuran yang berbeda dari BOOLEAN.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia mulai dari Windows XP.
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Lihat juga

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap