ptree_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 property specified by handle proph and copies it into the location specified 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:

See Also

libpicltree(3PICLTREE), ptree_create_prop(3PICLTREE), attributes(5)