INtime SDK Help
ntxDeleteRtPort

Deletes an RT port created by a Windows process. If any threads are in the port's receive thread queue at deletion time, they are awakened with an E_EXIST exceptional condition. Deleting the port counts toward the object limit for the containing process. Any messages queued at the port are discarded and, if the port is forwarded, forwarding is severed.

Deleting a sink port automatically detaches it from its source port.

NTXSTATUS ntxDeleteRtPort(
    NTXHANDLE hPort
);

Parameters

hPort
A handle for the port you want to delete.

Return Values

E_OK
Success.
The appropriate status code.
Failure. To determine the status, call ntxGetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
The port is already being deleted.
E_TYPE 0x8002
The handle supplied is not for a port object.
E_LOCATION
The RT client on which the port was created is now invalid.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.
Note:   Other status values may be generated by the service-specific DeletePort handler.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

Port system calls, DeletePort