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>C Specification</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 sooner than 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">
37scheduled send time (number of minutes to elapse from now) <BR> Set a value larger than 0 and equal to or less 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 text indicating the maximum value for <code><em><strong>elapsedTime</strong></em></code>.
55<BR> 2007/07/26 Initial version.</P>
56
57<hr><p>CONFIDENTIAL</p></body>
58</HTML>