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>NWC24AddDlTask</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>NWC24AddDlTask</H1> 12 13<H2>C Specification</H2> 14<DL> 15<DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 16<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24AddDlTask( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <EM>taskPublic</EM> );</CODE></PRE> 17</DL> 18 19<H2>Description</H2> 20<P> 21Adds a download task to the task list. An ID is assigned to a newly created task when it is added. Tasks which have already been added are overwritten in the same way as <A href="NWC24UpdateDlTask.html"><CODE>NWC24UpdateDlTask()</CODE></A>, but the next scheduled download time will be reset. 22</P> 23 24<P> 25There is a limit to how many tasks can be registered to the task list, and there cannot be more tasks than this maximum value, so the developer must always be careful with this. If there are no free entries when a task is registered, the oldest task (that is, the one that has not been called by <CODE>NWC24AddDltask()</CODE> or <CODE>NWC24UpdateDlTask()</CODE> in the longest time) will be automatically deleted. 26</P> 27 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 download task. 35 </TD> 36 </TR> 37</TABLE> 38 39<h2>Return Values</h2> 40<P> 41<code>NWC24_OK</code>: ended normally.<BR> <code>NWC24_ERR_BROKEN</code>: the header of the download task is corrupt<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: the library has not been 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> <code>NWC24_ERR_FILE_*</code>: internal file operation error.<BR> <code>NWC24_ERR_NOT_READY</code>: WiiConnect24 has not been initialized.<BR> <code>NWC24_ERR_FATAL</code>: a fatal error has occurred.<BR> 42</P> 43 44<H2>See Also</H2> 45<P> 46<A href="NWC24UpdateDlTask.html"><CODE>NWC24UpdateDlTask</CODE></A>, <A href="NWC24DeleteDlTask.html"><CODE>NWC24DeleteDlTask</CODE></A> 47</P> 48 49<H2>Revision History</H2> 50<P> 512007/06/06 Added text about the maximum number of registered tasks. <BR>2006/12/05 Initial version.<BR> 52</P> 53 54<hr><p>CONFIDENTIAL</p></body> 55</HTML>