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.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>ENV_SetBelongingResourceSet</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">ENV_GetBelongingResourceSet <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>ENVResource* ENV_GetBelongingResourceSet( ENVResourceIter* res );
17  </CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" width="100%">
21  <TBODY>
22    <TR>
23      <TD width="20%"><EM><STRONG>res</STRONG></EM></TD>
24      <TD width="80%"> Pointer to the resource.</TD>
25    </TR>
26  </TBODY>
27</TABLE>
28<H2>Return Values</H2>
29<P>A pointer to the resource array which the resource belongs to.</P>
30<P>Returns NULL if the resource does not belong to any registered resource array.</P>
31<H2>Description</H2>
32<P>Gets a pointer to the resource array which the resource belongs to.</P>
33<P>Within the system there may be cases where multiple resource arrays are registered. When obtaining the resource value using <CODE><A href="ENV_GetXXX.html">ENV_Get*()</A></CODE>, etc., this can be performed on multiple resources without noticing. If you want to perform a strict check against the resource arrays, use <CODE>ENV_GetBelongingResourceSet()</CODE>.</P>
34<P>When identical items are in multiple resource arrays, the first item found in search of the list from the front is selected. If the resource does not belong to any array, the return value is NULL.</P>
35<H2>See Also</H2>
36<P><CODE><A href="ENV_Init.html">ENV_Init</A>, </CODE><CODE><A href="ENV_GetXXX.html">ENV_Get*</A></CODE></P>
37<H2>Revision History</H2>
38<P>2005/08/29 Initial version.</P>
39<hr><p>CONFIDENTIAL</p></body>
40</HTML>
41