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.11							    16 Jul 2004 				    dat_set_consumer_context(3DAT)