DAT_SET_CONSUMER_CONTEXT(3DAT) Direct Access Transport Library Functions


NAME


dat_set_consumer_context - set Consumer context

SYNOPSIS


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

DAT_RETURN
dat_set_consumer_context (
IN DAT_HANDLE dat_handle,
IN DAT_CONTEXT context
)


PARAMETERS


dat_handle
Handle for a DAT Object associated with context.


context
Consumer context to be stored within the associated
dat_handle. The Consumer context is opaque to the uDAPL
Provider. NULL represents no context.


DESCRIPTION


The dat_set_consumer_context() function associates a Consumer context
with the specified dat_handle. The dat_handle can be one of the following
handle types: DAT_IA_HANDLE, DAT_EP_HANDLE, DAT_EVD_HANDLE,
DAT_CR_HANDLE, DAT_RSP_HANDLE, DAT_PSP_HANDLE, DAT_PZ_HANDLE,
DAT_LMR_HANDLE, DAT_RMR_HANDLE, or DAT_CNO_HANDLE.


Only a single Consumer context is provided for any dat_handle. If there
is a previous Consumer context associated with the specified handle, the
new context replaces the old one. The Consumer can disassociate the
existing context by providing a NULL pointer for the context. The
Provider makes no assumptions about the contents of context; no check is
made on its value. Furthermore, the Provider makes no attempt to provide
any synchronization for access or modification of the context.

RETURN VALUES


DAT_SUCCESS
The operation was successful.


DAT_INVALID_PARAMETER
The context parameter is invalid.


DAT_INVALID_HANDLE
The dat_handle 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


dat_get_consumer_context(3DAT), libdat(3LIB), attributes(5)


July 16, 2004 DAT_SET_CONSUMER_CONTEXT(3DAT)