Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Product Install Registry Library Functionswsreg_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_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 TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

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


SunOS 5.9Go To TopLast Changed 22 Sep 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.