Manual Pages for UNIX Operating System command usage for man picl_get_first_prop

PICL Library Functions                 picl_get_first_prop(3PICL)



NAME
     picl_get_first_prop, picl_get_next_prop  -  get  a  property
     handle of a node

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

     int picl_get_first_prop(picl_nodehdl_t nodeh,
          piclprop_hdl_t *proph);


     int picl_get_next_prop(picl_prophdl_t proph,
          picl_prophdl_t *nextprop);


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


     The picl_get_next_prop() 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
     PICL_ENDOFLIST.

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


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


     PICL_STALEHANDLE is returned if  the  handle  is  no  longer
     valid.  This occurs if the PICL tree was refreshed or reini-
     tialized.


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

ERRORS




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                 picl_get_first_prop(3PICL)



     PICL_NOTINITIALIZED    Session not initialized


     PICL_NORESPONSE        Daemon not responding


     PICL_NOTNODE           Not a node


     PICL_NOTPROP           Not a property


     PICL_INVALIDHANDLE     Invalid handle


     PICL_STALEHANDLE       Stale handle


     PICL_FAILURE           General system failure


     PICL_ENDOFLIST         End of list


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


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
















SunOS 5.11          Last change: 28 Mar 2000                    2