---
name: "RtlCreateHeap"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/RtlCreateHeap"
---

# RtlCreateHeap(3w)

## NAME

**RtlCreateHeap** (NTDLL.@)

## SYNOPSIS

HANDLE RtlCreateHeap\
  (\
   ULONG                *flags*,\
   PVOID                *addr*,\
   SIZE\_T               *totalSize*,\
   SIZE\_T               *commitSize*,\
   PVOID                *unknown*,\
   PRTL\_HEAP\_DEFINITION *definition*\
  )

## DESCRIPTION

Create a new Heap.

## PARAMS

*flags* **\[In\]**  **HEAP\_** *flags* from **"winnt.h"**.

*addr* **\[In\]**  Desired base address.

*totalSize* **\[In\]**  Total size of the heap, or **0** for a growable heap.

*commitSize* **\[In\]**  Amount of heap space to commit.

*unknown* **\[In\]**  Not yet understood.

*definition* **\[In\]**  Heap *definition*.

## RETURNS

**Success:** A **HANDLE** to the newly created heap.

**Failure:** a **NULL** HANDLE.

## IMPLEMENTATION

Declared in **"winternl.h"**.

Implemented in **"dlls/ntdll/heap.c"**.

Debug channel **"heap"**.
