Fungsi RtlFreeHeap (ntifs.h)
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 |