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>NWC24SetDlOptOutFlags</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>NWC24SetDlOptOutFlags</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> NWC24SetDlOptOutFlags( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, u8 <VAR>optFlags</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Configures a task's Opt-Out settings.
22</P>
23<P>
24<STRONG>A normal application does not need to use Opt-Out settings unless it has particular specifications.</STRONG>
25</P>
26<P>
27These settings are used to collectively delete tasks when the user does not want to receive contents.
28</P>
29<P>
30When enabling Opt-Out settings, set <CODE><VAR>optFlags</VAR></CODE> to the value defined by the <CODE>NWC24_DL_OPTFLAG_OPT_OUT</CODE> macro.
31</P>
32
33<H2>Arguments</H2>
34<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
35  <TR>
36<TD class="name"><code><VAR>taskPublic</VAR></code></TD>
37    <TD class="description">
38Pointer to the download task.
39    </TD>
40  </TR>
41  <TR>
42<TD class="name"><code><VAR>optFlags</VAR></code></TD>
43    <TD class="description">
44Flags for the Opt-Out settings.
45    </TD>
46  </TR>
47</TABLE>
48
49<h2>Return Values</h2>
50<P>
51<code>NWC24_OK</code>: Ended normally.<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, the download task is invalid, or the value of <code><VAR>optFlags</VAR></code> is invalid.<BR>
52</P>
53
54<H2>See Also</H2>
55<P>
56<A href="NWC24GetDlOptOutFlags.html"><CODE>NWC24GetDlOptOutFlags</CODE></A>, <A href="NWC24DeleteDlTasksForOptOut.html"><CODE>NWC24DeleteDlTasksForOptOut</CODE></A>
57</P>
58
59<H2>Revision History</H2>
60<P>
612007/12/03 Added a note stating that normal applications does not need to use this function.<BR>2007/08/06 Initial version.
62</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</HTML>