PICL Plug-In Library Functions
                             ptreecreateandaddprop(3PICLTRE)



NAME
     ptreecreateandaddprop - create and add property to  node
     and return property handle

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

     int ptreecreateandaddprop(piclnodehdlt nodeh,
          ptreepropinfot *infop, void *vbuf, piclprophdlt *proph);


DESCRIPTION
     The ptreecreateandaddprop() function creates a  property
     using  the  property  information specified in infop and the
     value buffer vbuf and adds the property to the  node  speci-
     fied  by nodeh. If proph is not NUL, the handle of the pro-
     perty added to the node is returned in proph.

RETURN VALUES
     Upon successful completion, 0 is  returned.  On  failure,  a
     non-negative integer is returned to indicate an error.


     PICLSTALEHANDLE is returned if  the  handle  is  no  longer
     valid.  This occurs if the PICL tree was refreshed or reini-
     tialized.


     PICLINVALIDHANDLE is returned if the specified handle never
     existed.

ERORS
     PICLNOTSUPORTED     Property version not supported


     PICLVALUETOBIG      Value exceeds maximum size


     PICLNOTPROP          Not a property


     PICLNOTABLE         Not a table


     PICLPROPEXISTS       Property already exists


     PICLRESERVEDNAME     Property name is reserved





SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions
                             ptreecreateandaddprop(3PICLTRE)



     PICLINVREFERENCE     Invalid reference property value


     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


     PICLFAILURE          General system failure


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     ptreecreateprop(3PICLTRE),     ptreeaddprop(3PICLTRE),
     attributes(5)
























SunOS 5.11           Last change: 1 Aug 2000                    2






PICL Plug-In Library Functions
                             ptreecreateandaddprop(3PICLTRE)






















































SunOS 5.11           Last change: 1 Aug 2000                    3