Allocates a memory buffer from a heap object and returns a pointer to the caller. If insufficient resources are available to meet the request, a NULL pointer is returned.

LPVOID RequestRtBuffer(
    RTHANDLE hHeap,    // a handle for the heap
    DWORD    cbSize,   // the size of the buffer to allocate
    LPWORD   lpType    // a pointer to a variable to receive the buffer type
);

Parameters

hHeap

A handle for the heap from which to allocate a buffer.

cbSize

The number of bytes of the buffer to allocate.

lpType

A pointer to a variable allocated by the caller which receives the type of buffer allocated from the heap. Currently this value is always CONTIGUOUS_BUFFER.

Return Values

A pointer to the buffer allocated.

Success.

NULL pointer

Failure. To view detailed error information, call GetLastRtError.

Requirements

See Also

Memory management system calls, ReleaseRtBuffer