LEARN ABOUT SUNOS
dat_set_consumer_context
dat_set_consumer_context(3DAT) Direct Access Transport Library Functions dat_set_consumer_context(3DAT)
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 fol-
lowing 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 han-
dle, 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)
SunOS 5.10 16 Jul 2004 dat_set_consumer_context(3DAT)