INtime SDK Help
DetachRtHeap
INtime SDK v6 > About INtime > INtime Kernel > Ports > DetachRtHeap

From INtime 6.0 the INtime Service and Port objects have been deprecated.

New projects should not be started using these features, and existing projects will not work with XM mode. You will receive a compiler warning by default if you use these calls.

Ends the association between a heap object and a message port. This call does not delete the heap. The handle received as a result of this call can be used to attach the heap to a different port, or to reattach it to the same port.

RTHANDLE DetachRtHeap(
    RTHANDLE hPort
);

Parameters

hPort
A handle for the port to be detached from the heap.

Return Values

A handle for the detached heap.
Success.
A BAD_RTHANDLE value.
Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
The hPort parameter is not the handle for an existing object.
E_STATE 0x0007
The port does not have a heap attached.
E_TYPE 0x8002
The handle supplied is not for a port object.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib

See Also

Port system calls,

Send Feedback