Manual Pages for UNIX Operating System command usage for man wsreg_get_child_components

Product Install Registry Library Functions
                                wsreg_add_child_component(3WSREG)



NAME
     wsreg_add_child_component,     wsreg_remove_child_component,
     wsreg_get_child_components - add or remove a child component

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

     int wsreg_add_child_component(Wsreg_component *comp,
          const Wsreg_component *childComp);


     int wsreg_remove_child_component(Wsreg_component *comp,
          const Wsreg_component *childComp);


     Wsreg_component **wsreg_get_child_components(const Wsreg_component *comp);


DESCRIPTION
     The wsreg_add_child_component() function adds the  component
     specified  by childComp to the list of child components con-
     tained in the component specified by comp.


     The wsreg_remove_child_component() function removes the com-
     ponent  specified  by  childComp from the list of child com-
     ponents contained in the component specified by comp.


     The wsreg_get_child_components() function returns  the  list
     of  child components contained in the component specified by
     comp.

RETURN VALUES
     The wsreg_add_child_component() function returns a  non-zero
     value  if  the  specified  child  component was successfully
     added; otherwise, 0 is returned.


     The wsreg_remove_child_component() function returns  a  non-
     zero value if the specified child component was successfully
     removed; otherwise, 0 is returned.


     The wsreg_get_child_components() function  returns  a  null-
     terminated array of Wsreg_component pointers that represents
     the specified component's list of child components.  If  the
     specified   component  has  no  child  components,  NULL  is
     returned. The resulting array must be released by the caller
     through   a   call   to   wsreg_free_component_array().  See



SunOS 5.11          Last change: 22 Sep 2000                    1






Product Install Registry Library Functions
                                wsreg_add_child_component(3WSREG)



     wsreg_create_component(3WSREG).

USAGE
     The parent-child relationship between components in the pro-
     duct  install  registry is used to record a product's struc-
     ture.  Product structure is the arrangement of features  and
     components  that  make  up  a  product.   The  structure  of
     installed products can be displayed with the prodreg GUI.


     The child component must be installed and registered  before
     the  parent  component can be.  The registration of a parent
     component that has child components results in each  of  the
     child  components being updated to reflect their parent com-
     ponent.


     Read access to the product install registry is  required  in
     order to use these functions because these relationships are
     held with lightweight component references that can only  be
     fully resolved using the registry contents.

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



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


SEE ALSO
     prodreg(1M),              wsreg_can_access_registry(3WSREG),
     wsreg_create_component(3WSREG),    wsreg_initialize(3WSREG),
     wsreg_register(3WSREG),   wsreg_set_parent(3WSREG),   attri-
     butes(5)














SunOS 5.11          Last change: 22 Sep 2000                    2






Product Install Registry Library Functions
                                wsreg_add_child_component(3WSREG)






















































SunOS 5.11          Last change: 22 Sep 2000                    3