DetachRtHeap (deprecated)

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

Parameters

Return Values

Status

Requirements

See Also