ptree_init_propinfo(3picltre) [sunos man page]
ptree_init_propinfo(3PICLTREE) PICL Plug-In Library Functions ptree_init_propinfo(3PICLTREE) NAME
ptree_init_propinfo - initialize ptree_propinfo_t structure SYNOPSIS
cc [ flag... ] file... -lpicltree [ library... ] #include <picltree.h> int ptree_init_propinfo(ptree_propinfo_t *infop, int version, int ptype, int pmode, size_t psize, char *pname, int (*readfn)(ptree_rarg_t *, void *), int (*writefn)(ptree_warg_t *, const void *)); DESCRIPTION
The ptree_init_propinfo() function initializes a ptree_propinfo_t property information structure given by location infop with the values provided by the arguments. The version argument specifies the version of the ptree_propinfo_t structure. PTREE_PROPINFO_VERSION gives the current version. The argu- ments ptype, pmode, psize, and pname specify the property's PICL type, access mode, size, and name. The maximum size of a property name is defined by PICL_PROPNAMELEN_MAX. The arguments readfn and writefn specify a volatile property's read and write access functions. For non- volatile properties, these are set to NULL. RETURN VALUES
Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error. ERRORS
PICL_INVALIDARG Invalid argument PICL_NOTSUPPORTED Property version not supported 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 ALSO
ptree_get_propinfo(3PICLTREE), attributes(5) SunOS 5.10 1 Aug 2000 ptree_init_propinfo(3PICLTREE)
Check Out this Related Man Page
ptree_find_node(3PICLTREE) PICL Plug-In Library Functions ptree_find_node(3PICLTREE) NAME
ptree_find_node - find node with given property and value SYNOPSIS
cc [ flag... ] file... -lpicltree [library... ] #include <picltree.h> int ptree_find_node(picl_nodehdl_t rooth, char *pname, picl_prop_type_t ptype, void *pval, size_t valsize, picl_nodehdl_t *retnodeh); DESCRIPTION
The ptree_find_node() function visits the nodes in the subtree under the node specified by rooth. The handle of the node that has the prop- erty whose name, type, and value matches the name, type, and value specified in pname, ptype, and pval respectively, is returned in the location given by retnodeh. The argument valsize gives the size of the value in pval. The first valsize number of bytes of the property value is compared with pval. RETURN VALUES
Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error. PICL_NODENOTFOUND is returned if there is no node that matches the property criteria can be found. ERRORS
PICL_NOTNODE Not a node PICL_INVALIDHANDLE Invalid handle PICL_STALEHANDLE Stale handle PICL_PROPNOTFOUND Property not found 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 ALSO
ptree_get_prop_by_name(3PICLTREE), ptree_get_propinfo(3PICLTREE), ptree_get_propval(3PICLTREE), ptree_get_propval_by_name(3PICLTREE), attributes(5) SunOS 5.10 1 Aug 2000 ptree_find_node(3PICLTREE)