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>NWC24SetMsgMBDelay</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24SetMsgMBDelay</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> NWC24SetMsgMBDelay( <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, u8 <EM>delayHours</EM> );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Specifies the amount of time to hide the message sent to the local Wii Message Board before actually showing it to users.
21</P>
22<P>
23The Wii Message Board will not get the message until the time specified by this function has passed since the creation of the message. Until that time, the message stays in the Inbox. During that time, if the message itself is deleted, its registration to the Wii Message Board will be cancelled as well. The message will take the real time of the calendar when it becomes displayable and registered to the calendar.
24</P>
25<P>
26<STRONG>Note: </STRONG> In version 3.0 and earlier of the Wii Menu, we determined that display may actually be suppressed for several hours more than the value that was set. Thus, if you cannot determine the version of the Wii menu, you should specify at least 24 hours for <EM><CODE>delayHours</CODE></EM> and avoid planning anything that depends on this feature for measuring time.
27</P>
28<P>
29In addition, this function cannot be used for messages sent to other Wii console's message boards. The same functionality is available through the use of <A href="../Message/NWC24SetMsgDesignatedTime.html"><CODE>NWC24SetMsgDesignatedTime</CODE></A>.
30</P>
31<P>
32The date and time set using the Wii console settings cannot be used to determine the passage of time. Therefore, even though the time of the console settings has advanced for the amount of time the display was not displayed, there may be cases where it may not be displayed.
33</P>
34
35
36<H2>Arguments</H2>
37<TABLE border="1" cellpadding="3" cellspacing="0.1">
38  <TR>
39<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD>
40    <TD width="520">
41Pointer to the message object to be set.
42    </TD>
43  </TR>
44  <TR>
45<TD width="120" bgcolor="#ffffe8"><code><em><strong>delayHours</strong></em></code></TD>
46    <TD width="520">
47Time with no display (in units of hours)<BR>Minimum: 24 (recommended), Maximum: 255
48    </TD>
49  </TR>
50</TABLE>
51
52<h2>Return Values</h2>
53<P>
54<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_PROTECTED</code>: Cannot change the message object.<BR> <code>NWC24_ERR_NOT_SUPPORTED</code>: A message type other than that used by the Wii Message Board is specified for <code><em><strong>obj</strong></em></code>, or an attempt was made to send a message to another Wii console over the network.<BR>
55</P>
56
57<H2>See Also</H2>
58<P>
59<A href="../Message/NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A> <A href="../Message/NWC24SetMsgDesignatedTime.html"><CODE>NWC24SetMsgDesignatedTime</CODE></A>
60</P>
61
62<H2>Revision History</H2>
63<P>
642007/11/08 Prohibited use when sending to another Wii console. <BR>2007/09/19 Added notes and a description of the range of values. <BR>2007/04/03 Added more information on the timing of message reception by the Wii Message Board. <BR>2006/10/06 Initial version.
65</P>
66
67<hr><p>CONFIDENTIAL</p></body>
68</HTML>