(ntifs.h) RtlFreeHeap 函式

  • 發行項

RtlFreeHeap 例程會釋放由 RtlAllocateHeap 從堆積配置的記憶體區塊。

語法

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

參數

[in] HeapHandle

要釋放記憶體區塊之堆積的句柄。 此參數是 RtlCreateHeap 所傳回的句柄。

[in, optional] Flags

一組旗標，可控制釋放記憶體區塊的各個層面。 指定下列值會覆寫由 RtlCreateHeap 建立堆積時，Flags 參數中指定的對應值。

旗標 意義
HEAP_NO_SERIALIZE 當 RtlFreeHeap 存取堆積時，將不會使用互斥。

BaseAddress

要釋放之內存區塊的指標。 此指標是由 RtlAllocateHeap 傳回。

傳回值

如果成功釋放區塊，RtlFreeHeap 會傳回 TRUE; 否則為 FALSE。

注意從 Windows 8 開始，傳回值會輸入為LOGICAL，其大小與BOOLEAN不同。
 

規格需求

需求 值
最低支援的用戶端 從 Windows XP 開始提供。
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另請參閱

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap