1ptree_get_propval(3PICLTRPEIEC)L Plug-In Library Functipotnrsee_get_propval(3PICLTREE)
2
3
4

NAME

6       ptree_get_propval, ptree_get_propval_by_name - get the value of a prop‐
7       erty
8

SYNOPSIS

10       cc [ flag... ] file... -lpicltree [ library... ]
11       #include <picltree.h>
12
13       int ptree_get_propval(picl_prophdl_t proph, void *valbuf,
14            size_t nbytes);
15
16
17       int ptree_get_propval_by_name(picl_nodehdl_t nodeh,
18            void *name, void *valbuf, size_t nbytes);
19
20

DESCRIPTION

22       The ptree_get_propval() function gets the value of the property  speci‐
23       fied  by  the  handle  proph and copies it into the buffer specified by
24       valbuf.  The size of the buffer valbuf is specifed in nbytes.
25
26
27       The ptree_get_propval_by_name() function gets the value  of  the  prop‐
28       erty,  whose name is specified by name, from the node specified by han‐
29       dle nodeh.  The value is copied into the buffer  specified  by  valbuf.
30       The size of the buffer is specified by nbytes.
31
32
33       For volatile properties, the read access function provided by the plug-
34       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
66       PICL_FAILURE          General system failure
67
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │MT-Level                     │MT-Safe                      │
79       └─────────────────────────────┴─────────────────────────────┘
80

SEE ALSO

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