Manual Pages for UNIX Operating System command usage for man ptree_create_and_add_node

PICL Plug-In Library Functions
                             ptree_create_and_add_node(3PICLTREE)



NAME
     ptree_create_and_add_node - create and add node to tree  and
     return node handle

SYNOPSIS
     cc [ flag... ] file... -lpicltree [ library... ]
     #include 

     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 reini-
     tialized.


     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




SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions
                             ptree_create_and_add_node(3PICLTREE)



     PICL_STALEHANDLE      Stale handle


     PICL_FAILURE          General system failure


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     ptree_create_node(3PICLTREE),     ptree_add_node(3PICLTREE),
     attributes(5)






























SunOS 5.11           Last change: 1 Aug 2000                    2






PICL Plug-In Library Functions
                             ptree_create_and_add_node(3PICLTREE)






















































SunOS 5.11           Last change: 1 Aug 2000                    3