PICL Plug-In Library Functions    ptreeupdatepropval(3PICLTRE)



NAME
     ptreeupdatepropval, ptreeupdatepropvalbyname -  update
     a property value

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

     int ptreeupdatepropval(piclprophdlt proph, void *valbuf,
          sizet nbytes);


     int ptreeupdatepropvalbyname(piclnodehdlt nodeh,
          char *name, void *valbuf, sizet nbytes);


DESCRIPTION
     The ptreeupdatepropval() function updates the value of the
     property  specified by proph with the value specified in the
     buffer valbuf. The size of the buffer valbuf is specified in
     nbytes.


     The  ptreeupdatepropvalbyname()  function  updates   the
     value  of  the property, whose name is specified by name, of
     the node specified by handle nodeh.  The new value is speci-
     fied  in  the  buffer  valbuf,  whose  size  is specified in
     nbytes.


     For volatile properties, the write access function  provided
     by the plug-in publishing the property is invoked.

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
     PICLVALUETOBIG      Value too big


     PICLNOTPROP          Not a property




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions    ptreeupdatepropval(3PICLTRE)



     PICLNOTNODE          Not a node


     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


     PICLPROPNOTFOUND     Property not found


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



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


SEE ALSO
     ptreegetpropval(3PICLTRE), attributes(5)


























SunOS 5.11          Last change: 28 Mar 2000                    2