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(7) 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(7)

July 16, 2004 DAT_CR_HANDOFF(3DAT)