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>NWC24SetDlParameter</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>NWC24SetDlParameter</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> NWC24SetDlParameter( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, u32 <VAR>param</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Sets an optional parameter value that can be used to identify the task. The user can set this parameter to any desired value, since it has absolutely no impact on the performance of the task itself.
22</P>
23
24<H2>Arguments</H2>
25<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
26  <TR>
27<TD class="name"><code><VAR>taskPublic</VAR></code></TD>
28    <TD class="description">
29Pointer to the download task.
30    </TD>
31  </TR>
32  <TR>
33<TD class="name"><code><VAR>parameter</VAR></code></TD>
34    <TD class="description">
35An optional parameter.
36    </TD>
37  </TR>
38</TABLE>
39
40<h2>Return Values</h2>
41<P>
42<code>NWC24_OK</code>: Normal termination.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library is not  opened.<BR> <code>NWC24_ERR_PROTECTED</code>: The download task is write protected.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The value of <code><VAR>taskPublic</VAR></code> is NULL, or the download task is invalid.<BR>
43</P>
44
45<H2>See Also</H2>
46<P>
47<A href="NWC24GetDlParameter.html"><CODE>NWC24GetDlParameter</CODE></A>, <A href="NWC24GetDlTaskMine.html"><CODE>NWC24GetDlTaskMineEx</CODE></A>, <A href="NWC24GetDlTaskByAppId.html"><CODE>NWC24GetDlTaskByAppIdEx</CODE></A>, <A href="NWC24GetDlTaskIdByAppId.html"><CODE>NWC24GetDlTaskIdByAppIdEx</CODE></A>
48</P>
49
50<H2>Revision History</H2>
51<P>
522007/08/29 Initial version.
53</P>
54
55<hr><p>CONFIDENTIAL</p></body>
56</HTML>