PICL Library Functions                 piclgetfirstprop(3PICL)



NAME
     piclgetfirstprop, piclgetnextprop  -  get  a  property
     handle of a node

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

     int piclgetfirstprop(piclnodehdlt nodeh,
          piclprophdlt *proph);


     int piclgetnextprop(piclprophdlt proph,
          piclprophdlt *nextprop);


DESCRIPTION
     The piclgetfirstprop() function gets the  handle  of  the
     first  property of the node specified by nodeh and copies it
     into the location given by proph.


     The piclgetnextprop() function gets  the  handle  of  the
     next property after the one specified by proph from the pro-
     perty list of the node, and  copies  it  into  the  location
     specified by nextprop.


     If there are  no  more  properties,  this  function  returns
     PICLENDOFLIST.

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


     PICLENDOFLIST is returned to indicate  that  there  are  no
     more properties.


     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




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                 piclgetfirstprop(3PICL)



     PICLNOTINITIALIZED    Session not initialized


     PICLNORESPONSE        Daemon not responding


     PICLNOTNODE           Not a node


     PICLNOTPROP           Not a property


     PICLINVALIDHANDLE     Invalid handle


     PICLSTALEHANDLE       Stale handle


     PICLFAILURE           General system failure


     PICLENDOFLIST         End of list


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


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
















SunOS 5.11          Last change: 28 Mar 2000                    2