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

See Also

Port system calls, DeletePort