1dat_set_consumer_conDtierxetc(t3DAAcTc)ess Transport LibrardyatF_usnectt_icoonnssumer_context(3DAT)
2
3
4

NAME

6       dat_set_consumer_context - set Consumer context
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_set_consumer_context (
14           IN    DAT_HANDLE    dat_handle,
15           IN    DAT_CONTEXT   context
16           )
17
18

PARAMETERS

20       dat_handle    Handle for a DAT Object associated with context.
21
22
23       context       Consumer  context  to  be  stored  within  the associated
24                     dat_handle. The Consumer context is opaque to  the  uDAPL
25                     Provider. NULL represents no context.
26
27

DESCRIPTION

29       The  dat_set_consumer_context()  function associates a Consumer context
30       with the specified dat_handle. The dat_handle can be one of the follow‐
31       ing   handle   types:   DAT_IA_HANDLE,  DAT_EP_HANDLE,  DAT_EVD_HANDLE,
32       DAT_CR_HANDLE,    DAT_RSP_HANDLE,    DAT_PSP_HANDLE,     DAT_PZ_HANDLE,
33       DAT_LMR_HANDLE, DAT_RMR_HANDLE, or DAT_CNO_HANDLE.
34
35
36       Only a single Consumer context is provided for any dat_handle. If there
37       is a previous Consumer context associated with  the  specified  handle,
38       the new context replaces the old one. The Consumer can disassociate the
39       existing context by providing a  NULL  pointer  for  the  context.  The
40       Provider  makes  no assumptions about the contents of context; no check
41       is made on its value. Furthermore, the Provider  makes  no  attempt  to
42       provide any synchronization for access or modification of the context.
43

RETURN VALUES

45       DAT_SUCCESS              The operation was successful.
46
47
48       DAT_INVALID_PARAMETER    The context parameter is invalid.
49
50
51       DAT_INVALID_HANDLE       The dat_handle parameter is invalid.
52
53

ATTRIBUTES

55       See attributes(5) for descriptions of the following attributes:
56
57
58
59
60       ┌─────────────────────────────┬─────────────────────────────┐
61       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │MT-Level                     │Unsafe                       │
66       └─────────────────────────────┴─────────────────────────────┘
67

SEE ALSO

69       dat_get_consumer_context(3DAT), libdat(3LIB), attributes(5)
70
71
72
73SunOS 5.11                        16 Jul 2004   dat_set_consumer_context(3DAT)
Impressum