PICL Library Functions                   piclgetpropinfo(3PICL)



NAME
     piclgetpropinfo - get the information about a property

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

     int piclgetpropinfo(piclprophdlt proph,
          piclpropinfot *pinfo);


DESCRIPTION
     The piclgetpropinfo() function gets the information  about
     the  property  specified  by handle proph and copies it into
     the location specified by pinfo.  The  property  information
     includes  the property type, access mode, size, and the name
     of the property as described on libpicl(3PICL) manual page.


     The maximum  size  of  a  property  value  is  specified  by
     PICLPROPSIZEMAX.  It is currently set to 512KB.

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.   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


     PICLNORESPONSE        Daemon not responding


     PICLNOTPROP           Not a property


     PICLINVALIDHANDLE     Invalid handle specified


     PICLSTALEHANDLE       Stale handle specifie




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                   piclgetpropinfo(3PICL)



     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
     libpicl(3PICL),                     piclgetpropval(3PICL),
     piclgetpropvalbyname(3PICL), attributes(5)




































SunOS 5.11          Last change: 28 Mar 2000                    2