Creates a connection between a local port and a remote port, which automatically routes messages sent from the host port to the specified remote address on the remote host. While the connection exists, the connected port can receive messages only from the specified remote port.

The connection is active when you specify a default remote address with this call. To disconnect the default remote address, invoke this call and specify a NULL value for lpAddress. Once disconnected the port remains disconnected until specifically connected again. A port can be connected more than once, the most recent connection overriding all previous connections.

Note that there is no implied communication between the local and remote ports to make the connection.

NTXSTATUS ntxConnectRtPort(
    NTXHANDLE hPort,
    GENADDR pAddress
);

Parameters

hPort

The local port that will be connected to the remote port.

pAddress

The address of the port to connect to, or NULL. This may be on another machine, depending on the service.

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_CONTEXT 0x0005

The service does not handle addresses.

E_EXIST 0x0006

The port is already being deleted.

E_STATE 0x0007

The port is a sink port.

E_INVALID_ADDR 0x00E2

The address parameter is not valid.

E_UNBOUND 0x00EB

The port is not bound.

E_TYPE 0x8002

The handle supplied is not for a port object.

E_NUC_BAD_BUF 0x80E2

An invalid address pointer was supplied.

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 VerifyAddress handler.

Requirements

See Also

Port system calls, VerifyAddress