PTREE_GET_PROPINFO(3PICLTREE)PTREE_GET_PROPINFO(3PICLTREE)NAMEptree_get_propinfo - get property information
SYNOPSIS
cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>
int ptree_get_propinfo(picl_prophdl_t proph,
ptree_propinfo_t *pi);
DESCRIPTION
The ptree_get_propinfo() function gets the information about the prop‐
erty specified by handle proph and copies it into the location speci‐
fied by pi. See libpicltree(3PICLTREE) for more information about
ptree_propinfo_t structure.
RETURN VALUES
Upon successful completion, 0 is returned. On failure, a non-negative
integer is returned to indicate an error.
PICL_STALEHANDLE is returned if the handle is no longer valid. This
occurs if the PICL tree was refreshed or reinitialized.
PICL_INVALIDHANDLE is returned if the specified handle never existed.
ERRORS
PICL_INVALIDHANDLE
Invalid handle
PICL_STALEHANDLE
Stale handle
PICL_NOTPROP
Not a property
PICL_FAILURE
General system failure
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Evolving │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSOlibpicltree(3PICLTREE), ptree_create_prop(3PICLTREE), attributes(5)
Mar 28, 2000 PTREE_GET_PROPINFO(3PICLTREE)