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>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> 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, it was determined that a lag of several hours may occur for the hidden time when compared to the set value. 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
32
33<H2>Arguments</H2>
34<TABLE border="1" cellpadding="3" cellspacing="0.1">
35  <TR>
36<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD>
37    <TD width="520">
38Pointer to the message object to be set.
39    </TD>
40  </TR>
41  <TR>
42<TD width="120" bgcolor="#ffffe8"><code><em><strong>delayHours</strong></em></code></TD>
43    <TD width="520">
44Time to hide display (in hours). <BR> Minimum: 24 (recommended). Maximum: 255.
45    </TD>
46  </TR>
47</TABLE>
48
49<h2>Return Values</h2>
50<P>
51<code>NWC24_OK</code>: completed normally.
52<BR> <code>NWC24_ERR_PROTECTED</code>: message object is protected (i.e., cannot be changed).<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 another Wii on the network is attempting to send a message.<BR></P>
53
54<H2>See Also</H2>
55<P>
56<A href="../Message/NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A> <A href="../Message/NWC24SetMsgDesignatedTime.html"><CODE>NWC24SetMsgDesignatedTime</CODE></A>
57</P>
58
59<H2>Revision History</H2>
60<P>
612007/11/18 Prohibition against use for sending to other Wii consoles.
62<BR> 2007/09/19 Added text to the notes and for the range of values. <BR> 2007/04/03 Added more information on the timing for getting the Wii Message Board. <BR> 2006/10/06 Initial version.</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</HTML>