DAT_CR_HANDOFF(3DAT) Direct Access Transport Library Functions


NAME


dat_cr_handoff - hand off the Connection Request to another Service Point

SYNOPSIS


cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>

DAT_RETURN
dat_cr_handoff (
IN DAT_CR_HANDLE cr_handle,
IN DAT_CONN_QUAL handoff
)


PARAMETERS


cr_handle
Handle to an instance of a Connection Request that the
Consumer is handing off.


handoff
Indicator of another Connection Qualifier on the same IA to
which this Connection Request should be handed off.


DESCRIPTION


The dat_cr_handoff() function hands off the Connection Request to another
Service Point specified by the Connection Qualifier handoff.


The operation is synchronous. This operation also destroys the Connection
Request instance. Use of the handle of the destroyed Connection Request
in any consequent operation fails.

RETURN VALUES


DAT_SUCCESS
The operation was successful.


DAT_INVALID_HANDLE
The cr_handle parameter is invalid.


DAT_INVALID_PARAMETER
The handoff parameter is invalid.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+---------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+---------------------------+
|Interface Stability | Standard: uDAPL, 1.1, 1.2 |
+--------------------+---------------------------+
|MT-Level | Unsafe |
+--------------------+---------------------------+

SEE ALSO


libdat(3LIB), attributes(5)


July 16, 2004 DAT_CR_HANDOFF(3DAT)