PICL Library Functions           piclgetpropinfobyname(3PICL)



NAME
     piclgetpropinfobyname -  get  property  information  and
     handle of named property

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

     int piclgetpropinfobyname(piclnodehdlt nodeh,
          const char *pname, piclpropinfot *pinfo,
          piclprophdlt *proph);


DESCRIPTION
     The piclgetpropinfobyname() function copies the property
     information  of  the property specified by pname in the node
     nodeh into the location given by pinfo. The  handle  of  the
     property is returned in the location proph.

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


     PICLPROPNOTFOUND is returned if the property of the  speci-
     fied name does not exist.


     PICLRESERVEDNAME is returned if the property name specified
     is one of the reserved property names.


     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


     PICLNOTNODE           Not a node





SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Library Functions           piclgetpropinfobyname(3PICL)



     PICLPROPNOTFOUND      Property not found


     PICLRESERVEDNAME      Reserved property name specified


     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       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     piclgetpropinfo(3PICL),      piclgetpropbyname(3PICL),
     attributes(5)
























SunOS 5.11           Last change: 1 Aug 2000                    2