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>NWC24SetMsgDesignatedTime</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24SetMsgDesignatedTime</H1>
11
12<H2>Syntax</H2>
13<DL>
14<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24SetMsgDesignatedTime( <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, s32 <EM>elapsedTime</EM> );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Specifies the scheduled send time for a message in minutes elapsed from the present.<BR>Normally when a message is placed in the Outbox, it will be sent the first time the automatic send and receive process starts. However, if a scheduled send time has been configured, the message will not be sent until that scheduled time.
21</P>
22<P>
23<STRONG>Note: </STRONG> This feature only ensures that a message will not be sent before the specified time; it does not ensure that a message will be sent precisely at the specified time. If the console's power is off, the WiiConnect24 scheduler is stopped, or other similar situations occur when the specified time is reached, the actual sending time may be delayed.
24</P>
25
26<H2>Arguments</H2>
27<TABLE border="1" cellpadding="3" cellspacing="0.1">
28  <TR>
29<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD>
30    <TD width="520">
31Pointer to the message object to be set.
32    </TD>
33  </TR>
34  <TR>
35<TD width="120" bgcolor="#ffffe8"><code><em><strong>elapsedTime</strong></em></code></TD>
36    <TD width="520">
37Expected transmission time (in minutes elapsed from now). <BR>Set a value greater than 0 and no more than 14,400. (14,400 minutes = 10 days.)
38    </TD>
39  </TR>
40</TABLE>
41
42<h2>Return Values</h2>
43<P>
44<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_PROTECTED</code>: Cannot change message object.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: Invalid value specified for <code><em><strong>elapsedTime</strong></em></code>.<BR>
45</P>
46
47<H2>See Also</H2>
48<P>
49<A href="NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A>, <A href="NWC24CommitMsg.html"><CODE>NWC24CommitMsg</CODE></A>
50</P>
51
52<H2>Revision History</H2>
53<P>
542007/11/5 Added a description of the maximum value for <code><em><strong>elapsedTime</strong></em></code>. <BR>2007/07/26 Initial version.
55</P>
56
57<hr><p>CONFIDENTIAL</p></body>
58</HTML>