wsreg_query_set_instance(3WSREG)		    Product Install Registry Library Functions			  wsreg_query_set_instance(3WSREG)

NAME

       wsreg_query_set_instance, wsreg_query_get_instance - set or get the instance of a query

SYNOPSIS

       cc [flag ...]  file ...-lwsreg [library ...]
       #include <wsreg.h>

	int wsreg_query_set_instance(Wsreg_query *query, int instance);

       int wsreg_query_get_instance(Wsreg_query *comp);

DESCRIPTION

       The wsreg_query_set_instance() function sets the instance number specified by instance in the query specified by query.

       The wsreg_query_get_instance() function retrieves the instance from the query specified by query.

RETURN VALUES

       The wsreg_query_set_instance() function returns a non-zero value if the instance was set correctly; otherwise 0 is returned.

       The  wsreg_query_get_instance() function returns the instance number from the specified query.  It returns 0 if the instance number has not
       been set.

USAGE

       The query identifies fields used to search for a specific component in the product install registry.  By specifying the instance, the  com-
       ponent search is narrowed to all components in the product install registry that have the specified instance.

       Other fields can be specified in the same query to further narrow down the search.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       wsreg_get(3WSREG), wsreg_initialize(3WSREG), wsreg_query_create(3WSREG), attributes(5)

SunOS 5.10							    22 Sep 2000 				  wsreg_query_set_instance(3WSREG)