Manual Pages for UNIX Operating System command usage for man ptree_get_prop_by_name

PICL Plug-In Library Functions  ptree_get_prop_by_name(3PICLTREE)



NAME
     ptree_get_prop_by_name - get a property handle by name

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

     int ptree_get_prop_by_name(picl_nodehdl_t nodeh, char *name,
          picl_prophdl_t *proph);


DESCRIPTION
     The ptree_get_prop_by_name() function gets the handle of the
     property,  whose  name  is  specified  in  name, of the node
     specified by the  handle  nodeh.   The  property  handle  is
     copied into the location specified by proph.

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


     PICL_RESERVEDNAME is returned if the  name  specified  is  a
     PICL reserved name property. Reserved name properties do not
     have     an     associated     property     handle.      Use
     ptree_get_propval_by_name(3PICLTREE)  to  get the value of a
     reserved property.


     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_NOTNODE          Not a node


     PICL_RESERVEDNAME     Property name is reserved


     PICL_INVALIDHANDLE    Invalid handle


     PICL_STALEHANDLE      Stale handle


     PICL_PROPNOTFOUND     Property not found




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions  ptree_get_prop_by_name(3PICLTREE)



     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_first_prop(3PICLTREE),
     ptree_get_propval_by_name(3PICLTREE), attributes(5)


































SunOS 5.11          Last change: 28 Mar 2000                    2