1ptree_update_propval(3PICPLITCRLEEP)lug-In Library Funpcttrieoen_supdate_propval(3PICLTREE)
2
3
4
6 ptree_update_propval, ptree_update_propval_by_name - update a property
7 value
8
10 cc [ flag... ] file... -lpicltree [ library... ]
11 #include <picltree.h>
12
13 int ptree_update_propval(picl_prophdl_t proph, void *valbuf,
14 size_t nbytes);
15
16
17 int ptree_update_propval_by_name(picl_nodehdl_t nodeh,
18 char *name, void *valbuf, size_t nbytes);
19
20
22 The ptree_update_propval() function updates the value of the property
23 specified by proph with the value specified in the buffer valbuf. The
24 size of the buffer valbuf is specified in nbytes.
25
26
27 The ptree_update_propval_by_name() function updates the value of the
28 property, whose name is specified by name, of the node specified by
29 handle nodeh. The new value is specified in the buffer valbuf, whose
30 size is specified in nbytes.
31
32
33 For volatile properties, the write access function provided by the
34 plug-in publishing the property is invoked.
35
37 Upon successful completion, 0 is returned. On failure, a non-negative
38 integer is returned to indicate an error.
39
40
41 PICL_STALEHANDLE is returned if the handle is no longer valid. This
42 occurs if the PICL tree was refreshed or reinitialized.
43
44
45 PICL_INVALIDHANDLE is returned if the specified handle never existed.
46
48 PICL_VALUETOOBIG Value too big
49
50
51 PICL_NOTPROP Not a property
52
53
54 PICL_NOTNODE Not a node
55
56
57 PICL_INVALIDHANDLE Invalid handle
58
59
60 PICL_STALEHANDLE Stale handle
61
62
63 PICL_PROPNOTFOUND Property not found
64
65
67 See attributes(5) for descriptions of the following attributes:
68
69
70
71
72 ┌─────────────────────────────┬─────────────────────────────┐
73 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
74 ├─────────────────────────────┼─────────────────────────────┤
75 │Interface Stability │Evolving │
76 ├─────────────────────────────┼─────────────────────────────┤
77 │MT-Level │MT-Safe │
78 └─────────────────────────────┴─────────────────────────────┘
79
81 ptree_get_propval(3PICLTREE), attributes(5)
82
83
84
85SunOS 5.11 28 Mar 2000 ptree_update_propval(3PICLTREE)