PICL Plug-In Library Functions  ptreegetpropbyname(3PICLTRE)



NAME
     ptreegetpropbyname - get a property handle by name

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

     int ptreegetpropbyname(piclnodehdlt nodeh, char *name,
          piclprophdlt *proph);


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


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


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


     PICLRESERVEDNAME     Property name is reserved


     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


     PICLPROPNOTFOUND     Property not found




SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions  ptreegetpropbyname(3PICLTRE)



     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
     ptreegetfirstprop(3PICLTRE),
     ptreegetpropvalbyname(3PICLTRE), attributes(5)


































SunOS 5.11          Last change: 28 Mar 2000                    2