Makes a heap's memory resources available to one or more message port objects. The INtime kernel allocates buffers from this heap for receive operations on associated ports. The application must return these buffers to the heap when they are no longer needed.

BOOLEAN AttachRtHeap(
    RTHANDLE hHeap,    // heap handle
    RTHANDLE hPort     // port handle
);

Parameters

hHeap

A handle for a heap object.

hPort

A handle for the port to which to attach the heap.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST 0x0006

Either the hPort or hHeap parameter does not refer to an existing object.

E_STATE 0x0007

The port already has a heap attached.

E_TYPE 0x8002

Either hPort or the hHeap parameter is not a handle of the correct type.

Requirements

See Also

Port system calls