sunos man page for wsreg_get

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)