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 http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24InitDlIterateContext</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<LINK rel="stylesheet" type="text/css" href="../nwc24.css">
9</HEAD>
10<BODY>
11<H1>NWC24InitDlIterateContext</H1>
12
13<H2>C Specification</H2>
14<DL>
15<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
16<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24InitDlIterateContext( <A HREF="../Types/NWC24DlIterateContext.html">NWC24DlIterateContext</A>* <VAR>context</VAR>, <A HREF="../Types/NWC24DlIterateOperation.html">NWC24DlIterateOperation</A> <VAR>operation</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Initializes the context for <A href="NWC24IterateDlTaskEx.html"><CODE>NWC24IterateDlTaskEx</CODE></A> and sets the iteration order in the context.
22</P>
23
24<P>
25When <CODE>NWC24InitDlIterateContext</CODE> is called before <A href="NWC24IterateDlTaskEx.html"><CODE>NWC24IterateDlTaskEx</CODE></A> returns <CODE>NWC24_ERR_DONE</CODE>, the iteration is done over.
26</P>
27
28<H2>Arguments</H2>
29<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
30  <TR>
31<TD class="name"><code><VAR>context</VAR></code></TD>
32    <TD class="description">
33Pointer to the iteration context.
34    </TD>
35  </TR>
36  <TR>
37<TD class="name"><code><VAR>operation</VAR></code></TD>
38    <TD class="description">
39Iteration order.
40    </TD>
41  </TR>
42</TABLE>
43
44<h2>Return Values</h2>
45<P>
46<code>NWC24_OK</code>: Ended normally.<BR>
47</P>
48
49<H2>See Also</H2>
50<P>
51<A href="NWC24IterateDlTaskEx.html"><CODE>NWC24IterateDlTaskEx</CODE></A>
52</P>
53
54<H2>Revision History</H2>
55<P>
562007/09/20 Added text to cover initialization of context during iterations.
57<BR> 2006/12/05 Initial version.<BR></P>
58
59<hr><p>CONFIDENTIAL</p></body>
60</HTML>