PICL Plug-In Library Functions       ptreecreateprop(3PICLTRE)



NAME
     ptreecreateprop, ptreedestroyprop - create or destroy  a
     property

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

     int ptreecreateprop(ptreepropinfot *pinfo, void *valbuf,
          piclprophdlt *proph);


     int ptreedestroyprop(piclprophdlt proph);


DESCRIPTION
     The ptreecreateprop() function creates  a  property  using
     the information specified in pinfo, which includes the name,
     type, access mode, and size of the property, as well as  the
     read  access  function for a volatile property. The value of
     the property is specified in the buffer valbuf, which may be
     NUL  for  volatile  properties.  The handle of the property
     created is copied into the location  given  by  proph.   See
     libpicltree(3PICLTRE) for more information on the structure
     of ptreepropinfot structure.


     The  ptreedestroyprop()  function  destroys  the  property
     specified  by  the  handle proph.  For a table property, the
     entire table is destroyed. The property to be destroyed must
     have been previously deleted.

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





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions       ptreecreateprop(3PICLTRE)



     PICLNOTPROP          Not a property


     PICLCANTDESTROY      Attempting to destroy before delete


     PICLRESERVEDNAME     Property name is reserved


     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
     libpicltree(3PICLTRE),  ptreeaddprop(3PICLTRE),   attri-
     butes(5)
















SunOS 5.11          Last change: 28 Mar 2000                    2