Creates the heap object by allocating a segment of cbHeapSize bytes and creating the heap structure in this segment. The overhead incurred by the heap management structure is 28 bytes, plus another 8 bytes for each buffer allocated from it.

RTHANDLE CreateRtHeap(
    DWORD cbHeapSize,    // the size of the heap, in bytes
    WORD wHeapFlags      // the heap creation flags
);

Parameters

cbHeapSize

The number of bytes to allocate to the heap segment. The overhead required for heap management is 28 bytes per heap, plus another 8 bytes for every buffer allocated from it.

wHeapFlags

The heap creation flags, currently reserved. Specify 0 (zero) for this parameter.

Return Values

A handle for the heap object just created.

Success.

BAD_RTHANDLE

Failure. To determine the status, call GetLastRtError.

Requirements

See Also

Memory management system calls