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>NWC24SetMsgIconNewSign</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NWC24SetMsgIconNewSign</H1> 11 12<H2>C Specification</H2> 13<DL> 14<DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24SetMsgIconNewSign( <A HREF="../Types/NWC24MsgObj.html">NWC24MsgObj</A>* <EM>obj</EM>, BOOL <EM>enable</EM> );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20Specifies to a message whether a new arrival should be indicated using a channel icon in Wii Menu.<BR>When in the Inbox there exists a message for which the setting has been enabled by this function, a layout to indicate a new arrival is displayed with a channel icon when Wii Menu starts. Using this feature, it is possible to notify the user of the arrival of a new message before an application is started. 21</P> 22<P> 23<STRONG>Caution:</STRONG><BR> 24<UL> 25<LI>This feature is supported in Wii Menu version 3.0 and higher. This is simply ignored in prior versions.</LI> 26<LI>The only messages for which it is possible to specify a new arrival indication with a channel icon are messages that are to be sent to an application, which are of type <A HREF="../Types/NWC24MsgType.html"><CODE>NWC24_MSGTYPE_WII_APP</CODE></A> or <A HREF="../Types/NWC24MsgType.html"><CODE>NWC24_MSGTYPE_WII_APP_HIDDEN</CODE></A>.</LI> 27<LI>There is no effect if a new arrival indication layout has not been provided for the channel icon. Refer to the IconBannerTools manual for methods to set the new arrival indication layout.</LI> 28<LI>For a message that uses this setting, the new arrival indication will be preserved until the message is deleted from the Inbox.</LI> 29</UL> 30</P> 31 32<H2>Arguments</H2> 33<TABLE border="1" cellpadding="3" cellspacing="0.1"> 34 <TR> 35<TD width="120" bgcolor="#ffffe8"><code><em><strong>obj</strong></em></code></TD> 36 <TD width="520"> 37Pointer to the message object to be set. 38 </TD> 39 </TR> 40 <TR> 41<TD width="120" bgcolor="#ffffe8"><code><em><strong>enable</strong></em></code></TD> 42 <TD width="520"> 43Setting to enable and disable new arrival indication with a channel icon (disabled by default). 44 </TD> 45 </TR> 46</TABLE> 47 48<h2>Return Values</h2> 49<P> 50<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_PROTECTED</code>: Cannot change message object.<BR> <code>NWC24_ERR_NOT_SUPPORTED</code>: The message format in which the new arrival indication setting is not available.<BR> 51</P> 52 53<H2>See Also</H2> 54<P> 55<A href="NWC24InitMsgObj.html"><CODE>NWC24InitMsgObj</CODE></A>, <A href="NWC24CommitMsg.html"><CODE>NWC24CommitMsg</CODE></A> 56</P> 57 58<H2>Revision History</H2> 59<P> 602007/07/26 Initial version. 61</P> 62 63<hr><p>CONFIDENTIAL</p></body> 64</HTML>