wsreg_get(3WSREG) Product Install Registry Library Functions wsreg_get(3WSREG)
NAME
wsreg_get, wsreg_get_all - query product install registry
SYNOPSIS
cc [flag ...] file ...-lwsreg [library ...]
#include <wsreg.h>
Wsreg_component *wsreg_get(const Wsreg_query *query);
Wsreg_component **wsreg_get_all(void);
DESCRIPTION
The wsreg_get() function queries the product install registry for a component that matches the query specified by query.
The wsreg_get_all() function returns all components currently registered in the product install registry.
RETURN VALUES
The wsreg_get() function returns a pointer to a Wsreg_component structure representing the registered component. If no component matching
the specified query is currently registered, wsreg_get() returns NULL.
The wsreg_get_all() function returns a null-terminated array of Wsreg_component pointers. Each element in the resulting array represents
one registered component.
USAGE
The wsreg library must be initialized by a call to wsreg_initialize(3WSREG) before any call to wsreg_get() or wsreg_get_all().
The Wsreg_component pointer returned from wsreg_get() should be released through a call to wsreg_free_component(). See wsreg_create_compo-
nent(3WSREG).
The Wsreg_component pointer array returned from wsreg_get_all() should be released through a call to wsreg_free_component_array(). See
wsreg_create_component(3WSREG).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |Unsafe |
+-----------------------------+-----------------------------+
SEE ALSO
wsreg_create_component(3WSREG), wsreg_initialize(3WSREG), wsreg_register(3WSREG), attributes(5)
SunOS 5.10 22 Sep 2000 wsreg_get(3WSREG)
