1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>ENV_SetResourceSetArray</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">ENV_SetResourceSetArray <img src="../image/NTR.gif"align="middle"><img src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15<PRE><CODE>#include &lt;nitro/env.h&gt;</CODE></PRE>
16  <PRE><CODE>void ENV_SetResourceSetArray( ENVResource* array[] );
17  </CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" width="100%">
21  <TBODY>
22    <TR>
23<TD width="20%"><SPAN class="argument">array</SPAN></TD>
24<TD width="80%"> Pointer to the array of the resource array.</TD>
25    </TR>
26  </TBODY>
27</TABLE>
28<H2>Return Values</H2>
29<P>None.</P>
30<H2>Description</H2>
31<P>Sets the resource array used in searching for resources.</P>
32<P>Any resource arrays that have been set before this point are removed from the search target, and the array specified here becomes the target.</P>
33<P>Inside the function, the resource array at the start of the array specified by the <SPAN class="argument">array</SPAN> argument is set by the <A href="ENV_SetResourceSet.html"><CODE>ENV_SetResourceSet</CODE></A> function, and the subsequent resource arrays up until <CODE>NULL</CODE> is encountered are added by the <A href="ENV_AppendResourceSet.html"><CODE>ENV_AppendResourceSet</CODE></A> function. Close the end of <SPAN class="argument">array</SPAN> with <CODE>NULL</CODE>.<P>See <A href="ENV_SetResourceSet.html"><CODE>ENV_SetResourceSet</CODE></A> for more on specifying the resource array.</P>
34<P>This function is called from the <A href="ENV_Init.html"><CODE>ENV_Init</CODE></A> function. At that time:</P>
35<BLOCKQUOTE style="background:#ffffcc"><CODE><FONT color="#ff0000">SDK_WEAK_SYMBOL</FONT> ENVResource *<FONT color="#ff0000">resourceArray</FONT>[] = { NULL };<BR> <BR> void ENV_Init(void)<BR> {<BR> :<BR><FONT color="#ff0000">ENV_SetResourceSetArray( resourceArray );</FONT><BR> }</CODE></BLOCKQUOTE>
36<P>Initialization is performed for <CODE>resourceArray</CODE>, defined with the WEAK symbol. Because the <CODE>ENV_Init</CODE> function is called from the <A href="../os/init/OS_Init.html"><CODE>OS_Init</CODE></A> function, it is all right for the application to define <CODE>resourceArray</CODE> independently as long as the <CODE>OS_Init</CODE> function is not called.</P>
37<BLOCKQUOTE style="background-color:#ffffcc"><B>Example:</B><BR> The user program can simply make the following definition.<BR> <BR> <CODE>ENVResource myResource[] = {<BR> &quot;test.member&quot;, ENV_U32(100),<BR> ENV_RESOURCE_END<BR> };<BR> ENVResource <FONT color="#ff0000">resourceArray</FONT>[] = { myResource, NULL };</CODE><BR> <BR></BLOCKQUOTE>
38<P>Naturally, it is acceptable to specify other resource arrays later.</P>
39<BLOCKQUOTE style="background-color:#ffffcc"><B>Example:</B><BR> <BR> <CODE>ENV_SetResourceSetArray( anotherResourceArray );</CODE><BR> <BR>In this example, the newest configuration for <CODE>resourceArray</CODE> is used, not the one that was declared at the start.</BLOCKQUOTE>
40<H2>See Also</H2>
41<P><A href="ENV_Init.html"><CODE>ENV_Init</CODE></A><BR> <A href="ENV_SetResourceSet.html"><CODE>ENV_SetResourceSet</CODE></A><BR> <A href="ENV_AppendResourceSet.html"><CODE>ENV_AppendResourceSet</CODE></A></P>
42<H2>Revision History</H2>
43<P>2008/12/19 Added examples.<BR> 2005/10/07 Initial version.</P>
44<hr><p>CONFIDENTIAL</p></body>
45</HTML>
46