Manual Pages for UNIX Operating System command usage for man ptree_create_node

PICL Plug-In Library Functions       ptree_create_node(3PICLTREE)



NAME
     ptree_create_node, ptree_destroy_node - create or destroy  a
     node

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

     int ptree_create_node(char *name, char *clname,
          picl_nodehdl_t *nodeh);


     int ptree_destroy_node(picl_nodehdl_t nodeh);


DESCRIPTION
     The ptree_create_node() function creates a node and sets the
     "name"  property  value  to the string specified in name and
     the "class"  property  value  to  the  string  specified  in
     clname.  The handle of the new node is copied into the loca-
     tion given by nodeh.


     The ptree_destroy_node() function destroys the  node  speci-
     fied  by nodeh and frees up any allocated space. The node to
     be  destroyed  must  have   been   previously   deleted   by
     ptree_delete_node  (see  ptree_add_node(3PICLTREE)).  Other-
     wise, PICL_CANTDESTROY is returned.

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





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions       ptree_create_node(3PICLTREE)



     PICL_CANTDESTROY      Attempting to destroy before delete


     PICL_TREEBUSY         PICL tree is busy


     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  attri-
     butes:



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


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




















SunOS 5.11          Last change: 28 Mar 2000                    2