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>NWC24GetDlTaskByAppId</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>NWC24GetDlTaskByAppId</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> NWC24GetDlTaskByAppId( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, u32 <VAR>appId</VAR> );
17<A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24GetDlTaskByAppIdEx( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, u32 <VAR>appId</VAR>, u32 <VAR>param</VAR> );</CODE></PRE>
18</DL>
19
20<H2>Description</H2>
21<P>
22Gets the download task registered by the application specified by <CODE><VAR>appId</VAR></CODE>.<BR>If multiple tasks are registered, the function always gets the task with the most recent ID.
23</P>
24
25<P>
26The target for <CODE>NWC24GetDlTaskByAppIdEx</CODE> can be narrowed to only those that match the value of the user parameter. This is useful when a single application is handling multiple tasks.
27</P>
28
29<H2>Arguments</H2>
30<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
31  <TR>
32<TD class="name"><code><VAR>taskPublic</VAR></code></TD>
33    <TD class="description">
34Pointer to the location where the download task will be stored.
35    </TD>
36  </TR>
37  <TR>
38<TD class="name"><code><VAR>appId</VAR></code></TD>
39    <TD class="description">
40Application ID.
41    </TD>
42  </TR>
43  <TR>
44<TD class="name"><code><VAR>param</VAR></code></TD>
45    <TD class="description">
46The value of the user parameter.
47    </TD>
48  </TR>
49</TABLE>
50
51<h2>Return Values</h2>
52<P>
53<code>NWC24_OK</code>: Acquired normally (the value is returned in *<code><VAR>taskPublic</VAR></code>)<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The value of <code><VAR>taskPublic</VAR></code> is NULL, or <code><VAR>appId</VAR></code>is 0.<BR> <code>NWC24_ERR_NOT_FOUND</code>: The download task was not found.<BR>
54</P>
55
56<H2>See Also</H2>
57<P>
58<A href="NWC24GetDlTaskIdByAppId.html"><CODE>NWC24GetDlTaskIdByAppId</CODE></A>, <A href="NWC24GetDlTask.html"><CODE>NWC24GetDlTask</CODE></A>, <A href="NWC24InitDlTask.html"><CODE>NWC24InitDlTask</CODE></A>
59</P>
60
61<H2>Revision History</H2>
62<P>
632007/08/29 Added <CODE>NWC24GetDlTaskByAppIdEx</CODE>.<BR> 2006/12/05 Initial version.<BR>
64</P>
65
66<hr><p>CONFIDENTIAL</p></body>
67</HTML>