PICL Plug-In Library Functions    ptreegetfirstprop(3PICLTRE)



NAME
     ptreegetfirstprop, ptreegetnextprop - get  a  property
     handle of the node

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

     int ptreegetfirstprop(piclnodehdlt nodeh,
          piclprophdlt *proph);


     int ptreegetnextprop(piclprophdlt proph,
          piclprophdlt *nextproph);


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


     The ptreegetnextprop() function gets the  handle  of  the
     next property after the one specified by proph from the list
     of properties of the node and copies it  into  the  location
     specified by nextproph.

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
     PICLNOTPROP          Not a property


     PICLNOTNODE          Not a node


     PICLENDOFLIST        End of list


     PICLINVALIDHANDLE    Invalid handle




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions    ptreegetfirstprop(3PICLTRE)



     PICLSTALEHANDLE      Stale handle


     PICLFAILURE          General system failure


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     ptreegetpropbyname(3PICLTRE), attributes(5)
































SunOS 5.11          Last change: 28 Mar 2000                    2