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>NWC24IterateDlTaskEx</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>NWC24IterateDlTaskEx</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> NWC24IterateDlTaskEx( <A HREF="../Types/NWC24DlIterateContext.html">NWC24DlIterateContext</A>* <VAR>context</VAR>, u16* <VAR>id</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Iterates through the tasks registered in the task list in the specified order.
22</P>
23<P>
24Before using this function you need to call <A href="NWC24InitDlIterateContext.html"><CODE>NWC24InitDlIterateContext</CODE></A> to set the order of iteration and initialize the context.
25</P>
26<P>
27Once the iteration is complete, <CODE>NWC24_ERR_DONE</CODE> is returned as a return value.
28</P>
29
30
31<H2>Arguments</H2>
32<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
33  <TR>
34<TD class="name"><code><VAR>context</VAR></code></TD>
35    <TD class="description">
36Pointer to the iteration context.
37    </TD>
38  </TR>
39  <TR>
40<TD class="name"><code><VAR>id</VAR></code></TD>
41    <TD class="description">
42The ID of the iterated download task.
43    </TD>
44  </TR>
45</TABLE>
46
47<h2>Return Values</h2>
48<P>
49<code>NWC24_OK</code>: Normal termination (iteration not completed). <BR> <code>NWC24_ERR_DONE</code>: Iteration of all download tasks has completed.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: Either the context or the sort order set for the context is invalid.<BR>
50</P>
51
52<H2>See Also</H2>
53<P>
54<A href="NWC24InitDlIterateContext.html"><CODE>NWC24InitDlIterateContext</CODE></A>
55</P>
56
57<H2>Revision History</H2>
58<P>
592007/09/20 Added text about initialization of the context.<BR>2006/12/05 Initial version.<BR>
60</P>
61
62<hr><p>CONFIDENTIAL</p></body>
63</HTML>