Manual Pages for UNIX Operating System command usage for man ptree_create_and_add_prop

PICL Plug-In Library Functions
                             ptree_create_and_add_prop(3PICLTREE)



NAME
     ptree_create_and_add_prop - create and add property to  node
     and return property handle

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

     int ptree_create_and_add_prop(picl_nodehdl_t nodeh,
          ptree_propinfo_t *infop, void *vbuf, picl_prophdl_t *proph);


DESCRIPTION
     The ptree_create_and_add_prop() function creates a  property
     using  the  property  information specified in infop and the
     value buffer vbuf and adds the property to the  node  speci-
     fied  by nodeh. If proph is not NULL, the handle of the pro-
     perty added to the node is returned in proph.

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_NOTSUPPORTED     Property version not supported


     PICL_VALUETOOBIG      Value exceeds maximum size


     PICL_NOTPROP          Not a property


     PICL_NOTTABLE         Not a table


     PICL_PROPEXISTS       Property already exists


     PICL_RESERVEDNAME     Property name is reserved





SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions
                             ptree_create_and_add_prop(3PICLTREE)



     PICL_INVREFERENCE     Invalid reference property value


     PICL_INVALIDHANDLE    Invalid handle


     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_create_prop(3PICLTREE),     ptree_add_prop(3PICLTREE),
     attributes(5)
























SunOS 5.11           Last change: 1 Aug 2000                    2






PICL Plug-In Library Functions
                             ptree_create_and_add_prop(3PICLTREE)






















































SunOS 5.11           Last change: 1 Aug 2000                    3