PICL Plug-In Library Functions       ptreegetpropval(3PICLTRE)



NAME
     ptreegetpropval, ptreegetpropvalbyname - get the value
     of a property

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

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


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


DESCRIPTION
     The ptreegetpropval() function gets the value of the  pro-
     perty  specified  by the handle proph and copies it into the
     buffer specified by valbuf.  The size of the  buffer  valbuf
     is specifed in nbytes.


     The ptreegetpropvalbyname() function gets the  value  of
     the property, whose name is specified by name, from the node
     specified by handle nodeh.  The value  is  copied  into  the
     buffer specified by valbuf. The size of the buffer is speci-
     fied by nbytes.


     For volatile properties, the read 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       ptreegetpropval(3PICLTRE)



     PICLNOTNODE          Not a node


     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


     PICLPROPNOTFOUND     Property not found


     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
     ptreeupdatepropval(3PICLTRE), attributes(5)

























SunOS 5.11          Last change: 28 Mar 2000                    2