INtime SDK Help
ntxConnectRtPort

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

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

See Also

Port system calls, VerifyAddress