1ptree_update_propval(3PICPLITCRLEEP)lug-In Library Funpcttrieoen_supdate_propval(3PICLTREE)
2
3
4

NAME

6       ptree_update_propval,  ptree_update_propval_by_name - update a property
7       value
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUES

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

81       ptree_get_propval(3PICLTREE), attributes(5)
82
83
84
85SunOS 5.11                        28 Mar 2000  ptree_update_propval(3PICLTREE)
Impressum