Binds an address to the port identified by a handle.

NTXSTATUS ntxBindRtPort(
    NTXHANDLE hPort,
    GENADDR pAddress
);

Parameters

hPort

The port that will have the address bound to it. The port must have been created with the CREATE_UNBOUND flag set.

pAddress

The address to be bound to the port.

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 already bound. The port is a sink port.

E_INVALID_ADDR 0x00e2

The address parameter is not valid.

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