1dat_set_consumer_conDtierxetc(t3DAAcTc)ess Transport LibrardyatF_usnectt_icoonnssumer_context(3DAT)
2
3
4
6 dat_set_consumer_context - set Consumer context
7
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
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
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
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
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
69 dat_get_consumer_context(3DAT), libdat(3LIB), attributes(5)
70
71
72
73SunOS 5.11 16 Jul 2004 dat_set_consumer_context(3DAT)