dat_cr_handoff(3DATDirect Access Transport Library Functiodat_cr_handoff(3DAT)NAMEdat_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 Connec‐
tion 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 ALSOlibdat(3LIB), attributes(5)SunOS 5.10 16 Jul 2004 dat_cr_handoff(3DAT)