Manual Pages for UNIX Operating System command usage for man ptree_get_first_prop

PICL Plug-In Library Functions    ptree_get_first_prop(3PICLTREE)



NAME
     ptree_get_first_prop, ptree_get_next_prop - get  a  property
     handle of the node

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

     int ptree_get_first_prop(picl_nodehdl_t nodeh,
          picl_prophdl_t *proph);


     int ptree_get_next_prop(picl_prophdl_t proph,
          picl_prophdl_t *nextproph);


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


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


     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.

ERRORS
     PICL_NOTPROP          Not a property


     PICL_NOTNODE          Not a node


     PICL_ENDOFLIST        End of list


     PICL_INVALIDHANDLE    Invalid handle




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions    ptree_get_first_prop(3PICLTREE)



     PICL_STALEHANDLE      Stale handle


     PICL_FAILURE          General system failure


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     ptree_get_prop_by_name(3PICLTREE), attributes(5)
































SunOS 5.11          Last change: 28 Mar 2000                    2