wsreg_set_parent(3Product Install Registry Library Funwsreg_set_parent(3WSREG)NAME
wsreg_set_parent, wsreg_get_parent - set or get the parent of a compo‐
nent
SYNOPSIS
cc [flag ...] file ...-lwsreg [library ...]
#include <wsreg.h>
void wsreg_set_parent(Wsreg_component *comp, const Wsreg_component
*parent);
Wsreg_component *wsreg_get_parent(const Wsreg_component *comp);
DESCRIPTION
The wsreg_set_parent() function sets the parent specified by parent of
the component specified by comp.
The wsreg_get_parent() function gets the parent of the component speci‐
fied by comp.
RETURN VALUES
The wsreg_get_parent() function returns a pointer to a Wsreg_component
structure that represents the parent of the specified component. If
the specified component does not have a parent, NULL is returned. If a
non-null value is returned, it the caller's responsibility to release
the memory associated with the resulting Wsreg_component pointer with a
call to wsreg_free_component(). See wsreg_create_component(3WSREG).
USAGE
The parent of a component is set as a result of registering the parent
component. When a component that has children is registered, all of
the child components are updated to reflect the newly registered compo‐
nent as their parent. This update only occurs if the child component
does not already have a parent component set.
The specified parent component is reduced to a lightweight component
reference that uniquely identifies the parent in the product install
registry. This lightweight reference includes the parent's uuid and
instance number.
The parent must be registered before a call to wsreg_set_parent() can
be made, since the parent's instance number must be known at the time
the wsreg_set_parent() function is called.
A process needing to call wsreg_set_parent() or wsreg_get_parent() must
have read access to the product install registry.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOwsreg_can_access_registry(3WSREG), wsreg_create_component(3WSREG),
wsreg_initialize(3WSREG), wsreg_register(3WSREG),
wsreg_set_instance(3WSREG), attributes(5)SunOS 5.10 22 Sep 2000 wsreg_set_parent(3WSREG)