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>NWC24CreateDlVf</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>NWC24ExecDownloadTask</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> NWC24ExecDownloadTask( u32 <VAR>operationFlags</VAR>, u16 <VAR>taskId</VAR>, u32 <VAR>subTaskMask</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Immediately executes download tasks that are registered with the task list.<BR>Call this function when the library has not been opened. If an error occurs, a detailed error code can be obtained with <A href="../Misc/NWC24GetErrorCode.html"><CODE>NWC24GetErrorCode()</CODE></a>.
22</P>
23<P>
24When the flags are zero, download processing is started in the same manner as the <a href="../Scheduler/intro.html">scheduler</a>. In other words, the task that will be run is the task that should be executed next by the <a href="../Scheduler/intro.html">scheduler</a> (among the tasks whose scheduled time for an update check has already passed, the one that has the highest priority).<BR>
25</P>
26
27<P>
28<strong>Note: </strong>We do not recommend carrying out operations that accompany a firmware restart, such as <CODE>OSShutdownSystem()</CODE>, <CODE>OSRestart()</CODE>, and <CODE>OSReturnToMenu()</CODE>, while blocking due to an invocation of <CODE>NWC24ExecDownloadTask()</CODE>. If these operations are performed, debug carefully to avoid any problems.
29</P>
30
31
32<H2>Arguments</H2>
33<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
34  <TR>
35<TD class="name"><code><VAR>operationFlags</VAR></code></TD>
36    <TD class="description">
37Operation flags
38      <TABLE border="1" cellspacing="0.1" class="const">
39        <THEAD>
40          <tr>
41<TD class="name">Name</TD>
42<TD class="description">Description</TD>
43          </tr>
44        </THEAD>
45        <TBODY>
46          <tr>
47<TD class="name"><code>NWC24_SCD_DL_FLAG_SPECIFY_ID</code></TD>
48<TD class="description">Enables the value of the second argument, <code><VAR>taskId</VAR></code>.</TD>
49          </tr>
50          <tr class="reserved">
51<TD class="name"><code>NWC24_SCD_DL_FLAG_SPECIFY_SUBID</code></TD>
52<TD class="description">Enables the value of the third argument, <code><VAR>subTaskMask</VAR></code>. Will be used with future extensions. It will be ignored even if specified.)</TD>
53          </tr>
54          <tr>
55<TD class="name"><code>NWC24_SCD_DL_FLAG_REFRESH</code></TD>
56<TD class="description">Download unconditionally, without checking to see whether the server contents have been updated.</TD>
57          </tr>
58        </TBODY>
59      </TABLE>
60    </TD>
61  </TR>
62  <TR>
63<TD class="name"><code><VAR>taskId</VAR></code></TD>
64    <TD class="description">
65ID of the task to execute.
66    </TD>
67  </TR>
68  <TR class="reserved">
69<TD class="name"><code><VAR>subTaskMask</VAR></code></TD>
70    <TD class="description">
71ID of the subtask to execute. Will be used with future extensions. It will be ignored even if specified.)
72    </TD>
73  </TR>
74</TABLE>
75
76<h2>Return Values</h2>
77<P>
78<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library is not open.<BR> <code>NWC24_ERR_PROTECTED</code>: The system settings do not permit use of WiiConnect24.<BR><code>NWC24_ERR_NULL</code> The contents of the task or the downloaded file are invalid<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The contents of the task or parameters are invalid.<BR><code>NWC24_ERR_FILE_NOT_FOUND</code>Cannot find file needed to execute the task (Download Box, key, and so on.)<BR><code>NWC24_ERR_FILE_*</code>: Error related to internal file operations.<BR> <code>NWC24_ERR_INTERNAL_VF</code>: The VF library, which was called internally, returned an error.<BR> <code>NWC24_ERR_NAND_CORRUPT</code>: <CODE>NAND_RESULT_CORRUPT</CODE> was generated internally.<BR> <code>NWC24_ERR_SERVER</code>: A server error occurred.<BR> <code>NWC24_ERR_NETWORK</code>: There was a problem with the network.<BR> <code>NWC24_ERR_CONFIG_NETWORK</code>: The console network settings are inappropriate.<BR> <code>NWC24_ERR_VER_MISMATCH</code>: Settings must be updated.<BR> <code>NWC24_ERR_FATAL</code>: A fatal error has occurred.<BR> <code>NWC24_ERR_VERIFY_SIGNATURE</code>: Signature verification failed.<BR>
79</P>
80
81<H2>See Also</H2>
82<P>
83</P>
84
85<H2>Revision History</H2>
86<P>
872007/09/26  Corrected omissions of error values<BR>2007/07/25 Published manual as a public API.
88</P>
89
90<hr><p>CONFIDENTIAL</p></body>
91</HTML>