1picl_get_propinfo_by_name(3PIPCILC)L Library Functipoincsl_get_propinfo_by_name(3PICL)
2
3
4

NAME

6       picl_get_propinfo_by_name  -  get  property  information  and handle of
7       named property
8

SYNOPSIS

10       cc [ flag... ] file... -lpicl [library... ]
11       #include <picl.h>
12
13       int picl_get_propinfo_by_name(picl_nodehdl_t nodeh,
14            const char *pname, picl_propinfo_t *pinfo,
15            picl_prophdl_t *proph);
16
17

DESCRIPTION

19       The picl_get_propinfo_by_name() function copies the  property  informa‐
20       tion  of  the  property  specified  by pname in the node nodeh into the
21       location given by pinfo. The handle of the property is returned in  the
22       location proph.
23

RETURN VALUES

25       Upon  successful  completion, 0 is returned. On failure, a non-negative
26       integer is returned to indicate an error.
27
28
29       PICL_PROPNOTFOUND is returned if the property  of  the  specified  name
30       does not exist.
31
32
33       PICL_RESERVEDNAME  is returned if the property name specified is one of
34       the reserved property names.
35
36
37       PICL_STALEHANDLE is returned if the handle is  no  longer  valid.  This
38       occurs if the PICL tree was refreshed or reinitialized.
39
40
41       PICL_INVALIDHANDLE  is  returned if the specified handle never existed.
42       This error may be returned for a previously valid handle if the  daemon
43       was  brought down and restarted. When this occurs a client must revali‐
44       date any saved handles.
45

ERRORS

47       PICL_NOTINITIALIZED    Session not initialized
48
49
50       PICL_NORESPONSE        Daemon not responding
51
52
53       PICL_NOTNODE           Not a node
54
55
56       PICL_PROPNOTFOUND      Property not found
57
58
59       PICL_RESERVEDNAME      Reserved property name specified
60
61
62       PICL_INVALIDHANDLE     Invalid handle
63
64
65       PICL_STALEHANDLE       Stale handle
66
67
68       PICL_FAILURE           General system failure
69
70

ATTRIBUTES

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

SEE ALSO

84       picl_get_propinfo(3PICL), picl_get_prop_by_name(3PICL), attributes(5)
85
86
87
88SunOS 5.11                        1 Aug 2000  picl_get_propinfo_by_name(3PICL)
Impressum