PICL Library Functions                    piclsetpropval(3PICL)



NAME
     piclsetpropval, piclsetpropvalbyname - set  the  value
     of a property to the specified value

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

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


     int piclsetpropvalbyname(piclnodehdlt nodeh,
          const char *pname, void *valbuf, sizet nbytes);


DESCRIPTION
     The piclsetpropval() function sets the value of  the  pro-
     perty  specified  by the handle proph to the value contained
     in the buffer valbuf. The argument nbytes specifies the size
     of the buffer valbuf.


     The piclsetpropvalbyname() function sets  the  value  of
     the property named pname of the node specified by the handle
     nodeh to the value contained in the buffer valbuf. The argu-
     ment nbytes specifies the size of the buffer valbuf.

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


     PICLPERMDENIED is returned if the client does not have suf-
     ficient permission to access the property.


     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.   This error may be returned for a previously valid
     handle if the daemon was brought down  and  restarted.  When
     this occurs a client must revalidate any saved handles.

ERORS
     PICLNOTINITIALIZED    Session not initialized






SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                    piclsetpropval(3PICL)



     PICLNORESPONSE        Daemon not responding


     PICLPERMDENIED        Insufficient permission


     PICLNOTWRITABLE       Property is read-only


     PICLVALUETOBIG       Value too big


     PICLNOTPROP           Not a property


     PICLNOTNODE           Not a node


     PICLINVALIDHANDLE     Invalid handle specified


     PICLSTALEHANDLE       Stale handle specified


     PICLFAILURE           General system failure


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     attributes(5)













SunOS 5.11          Last change: 28 Mar 2000                    2