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 regis‐
tered in the product install registry.
RETURN VALUES
The wsreg_get() function returns a pointer to a Wsreg_component struc‐
ture 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 repre‐
sents one registered component.
USAGE
The wsreg library must be initialized by a call to wsreg_initial‐
ize(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_cre‐
ate_component(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 ALSOwsreg_create_component(3WSREG), wsreg_initialize(3WSREG), wsreg_regis‐
ter(3WSREG), attributes(5)SunOS 5.10 22 Sep 2000 wsreg_get(3WSREG)