1ptree_create_prop(3PICLTRPEIEC)L Plug-In Library Functipotnrsee_create_prop(3PICLTREE)
2
3
4

NAME

6       ptree_create_prop, ptree_destroy_prop - create or destroy a property
7

SYNOPSIS

9       cc [ flag... ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_create_prop(ptree_propinfo_t *pinfo, void *valbuf,
13            picl_prophdl_t *proph);
14
15
16       int ptree_destroy_prop(picl_prophdl_t proph);
17
18

DESCRIPTION

20       The  ptree_create_prop() function creates a property using the informa‐
21       tion specified in pinfo, which includes the name,  type,  access  mode,
22       and  size  of  the  property, as well as the read access function for a
23       volatile property. The value of the property is specified in the buffer
24       valbuf,  which  may  be NULL for volatile properties. The handle of the
25       property created is copied into  the  location  given  by  proph.   See
26       libpicltree(3PICLTREE)   for  more  information  on  the  structure  of
27       ptree_propinfo_t structure.
28
29
30       The ptree_destroy_prop() function destroys the  property  specified  by
31       the handle proph.  For a table property, the entire table is destroyed.
32       The property to be destroyed must have been previously deleted.
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_STALEHANDLE  is  returned  if  the handle is no longer valid. This
40       occurs if the PICL tree was refreshed or reinitialized.
41
42
43       PICL_INVALIDHANDLE is returned if the specified handle never existed.
44

ERRORS

46       PICL_NOTSUPPORTED     Property version not supported
47
48
49       PICL_VALUETOOBIG      Value exceeds maximum size
50
51
52       PICL_NOTPROP          Not a property
53
54
55       PICL_CANTDESTROY      Attempting to destroy before delete
56
57
58       PICL_RESERVEDNAME     Property name is reserved
59
60
61       PICL_INVREFERENCE     Invalid reference property value
62
63
64       PICL_INVALIDHANDLE    Invalid handle
65
66
67       PICL_STALEHANDLE      Stale handle
68
69
70       PICL_FAILURE          General system failure
71
72

ATTRIBUTES

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

SEE ALSO

88       libpicltree(3PICLTREE), ptree_add_prop(3PICLTREE), attributes(5)
89
90
91
92SunOS 5.11                        28 Mar 2000     ptree_create_prop(3PICLTREE)
Impressum