ptree_create_and_add_nodPICLIPlug-In Libraptree_create_and_add_node(3PICLTREE)NAMEptree_create_and_add_node - create and add node to tree and return node
handle
SYNOPSIS
cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>
int ptree_create_and_add_node(picl_nodehdl_t parh, const char *name,
const char *classname, picl_nodehdl_t *nodeh);
DESCRIPTION
The ptree_create_and_add_node() function creates a node with the name
and PICL class specified by name and classname respectively. It then
adds the node as a a child to the node specified by parh. The handle of
the new node is returned in nodeh.
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_INVALIDARG Invalid argument
PICL_VALUETOOBIG Value exceeds maximum size
PICL_NOTSUPPORTED Property version not supported
PICL_CANTDESTROY Attempting to destroy before delete
PICL_NOTNODE Not a node
PICL_INVALIDHANDLE Invalid handle
PICL_STALEHANDLE Stale handle
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 ALSOptree_create_node(3PICLTREE), ptree_add_node(3PICLTREE), attributes(5)SunOS 5.10 1 Aug 20ptree_create_and_add_node(3PICLTREE)