Manual Pages for UNIX Operating System command usage for man wsreg_get

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_component *wsreg_get(const Wsreg_query *query);


     Wsreg_component **wsreg_get_all(void);


DESCRIPTION
     The wsreg_get() function queries the product install  regis-
     try  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 com-
     ponent.  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_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  attri-
     butes:



SunOS 5.11          Last change: 22 Sep 2000                    1






Product Install Registry Library Functions      wsreg_get(3WSREG)



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


SEE ALSO
     wsreg_create_component(3WSREG),    wsreg_initialize(3WSREG),
     wsreg_register(3WSREG), attributes(5)













































SunOS 5.11          Last change: 22 Sep 2000                    2