1picl_get_first_prop(3PICL)  PICL Library Functions  picl_get_first_prop(3PICL)
2
3
4

NAME

6       picl_get_first_prop,  picl_get_next_prop  -  get a property handle of a
7       node
8

SYNOPSIS

10       cc [ flag... ] file... -lpicl [ library... ]
11       #include <picl.h>
12
13       int picl_get_first_prop(picl_nodehdl_t nodeh,
14            piclprop_hdl_t *proph);
15
16
17       int picl_get_next_prop(picl_prophdl_t proph,
18            picl_prophdl_t *nextprop);
19
20

DESCRIPTION

22       The picl_get_first_prop() function gets the handle of the  first  prop‐
23       erty  of  the  node  specified by nodeh and copies it into the location
24       given by proph.
25
26
27       The picl_get_next_prop() function gets the handle of the next  property
28       after  the  one  specified by proph from the property list of the node,
29       and copies it into the location specified by nextprop.
30
31
32       If there are no more properties, this function returns PICL_ENDOFLIST.
33

RETURN VALUES

35       Upon successful completion, 0 is returned. On failure,  a  non-negative
36       integer is returned to indicate an error.
37
38
39       PICL_ENDOFLIST  is  returned to indicate that there are no more proper‐
40       ties.
41
42
43       PICL_STALEHANDLE is returned if the handle is  no  longer  valid.  This
44       occurs if the PICL tree was refreshed or reinitialized.
45
46
47       PICL_INVALIDHANDLE  is  returned if the specified handle never existed.
48       This error may be returned for a previously valid handle if the  daemon
49       was  brought down and restarted. When this occurs a client must revali‐
50       date any saved handles.
51

ERRORS

53       PICL_NOTINITIALIZED    Session not initialized
54
55
56       PICL_NORESPONSE        Daemon not responding
57
58
59       PICL_NOTNODE           Not a node
60
61
62       PICL_NOTPROP           Not a property
63
64
65       PICL_INVALIDHANDLE     Invalid handle
66
67
68       PICL_STALEHANDLE       Stale handle
69
70
71       PICL_FAILURE           General system failure
72
73
74       PICL_ENDOFLIST         End of list
75
76

ATTRIBUTES

78       See attributes(5) for descriptions of the following attributes:
79
80
81
82
83       ┌─────────────────────────────┬─────────────────────────────┐
84       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
85       ├─────────────────────────────┼─────────────────────────────┤
86       │MT-Level                     │MT-Safe                      │
87       └─────────────────────────────┴─────────────────────────────┘
88

SEE ALSO

90       picl_get_prop_by_name(3PICL), attributes(5)
91
92
93
94SunOS 5.11                        28 Mar 2000       picl_get_first_prop(3PICL)
Impressum