1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" /> 7<title>UpdateGameModeDescription</title> 8 </head> 9 <body> 10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/friends/Overview.html">friends</a>::<a href="../../../nn/friends/CTR/Overview.html">CTR</a>::UpdateGameModeDescription</CODE> Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition"> 14<a href="../../../nn/Result/Overview.html">Result</a> UpdateGameModeDescription( 15 const char16 description[MODE_DESCRIPTION_SIZE] 16); 17</pre> 18 </div> 19<h2>Parameters</h2> 20 <div class="section"> 21 <table class="arguments"> 22 <thead> 23 <tr> 24 <td width="15" /> 25<th>Name</th> 26<td>Description</td> 27 </tr> 28 </thead> 29 <tr> 30<td>in</td> 31<th>description[MODE_DESCRIPTION_SIZE]</th> 32<td>Specifies a game mode description string.</td> 33 </tr> </table> 34 </div> 35<h2>Return Values</h2> 36<div class="section">Returns the result of the operation.<br /> <br /> 37 <table class="arguments"> 38 <thead> 39 <tr> 40<th>Value</th> 41<td>Description</td> 42 </tr> 43 </thead> 44 <tr> 45<th>Result::IsSuccess</th> 46<td>Succeeded.</td> 47 </tr> 48 <tr> 49<th><CODE>ResultRmcNotCalled</CODE></th> 50<td>Succeeded. Due to connection status and limitations of frequency of sending data, however, notification to the server and friends is delayed.</td> 51 </tr> 52 <tr> 53<th>ResultInvalidPointer</th> 54<td>Invalid pointer passed as argument.</td> 55 </tr> 56 <tr> 57<th>ResultNotInitialized</th> 58<td>The friend presence library is not initialized.</td> 59 </tr> 60 <tr> 61<th>Other</th> 62<td>Another result may be returned, depending on the internal state of the daemon and other factors.</td> 63 </tr> 64 </table> </div> 65<h2>Description</h2> 66 <div class="section"> 67<p>Updates the game mode description string.</p><p>The string configured here is sent to friends when you are online and is displayed in their friend lists.<br /><br /> If the configured string is simply displayed in their friend lists, you do not need to call the <a href="../../../nn/friends/CTR/Login.html"><CODE>nn::friends::CTR::Login</CODE></a> function in advance. Even if the string is updated while the system is offline, it is automatically sent by the presence feature as appropriate after the system can go online, as long as background operations have not been suspended by the <a href="../../../nn/ndm/Suspend.html"><CODE>nn::ndm::Suspend</CODE></a>, <a href="../../../nn/ndm/SuspendDaemons.html"><CODE>nn::ndm::SuspendDaemons</CODE></a>, or <a href="../../../nn/ndm/SuspendScheduler.html"><CODE>nn::ndm::SuspendScheduler</CODE></a> function. The size of the string that is passed to the argument can be as large as <CODE><a href="../../../nn/friends/CTR/MODE_DESCRIPTION_SIZE.html">nn::friends::CTR::MODE_DESCRIPTION_SIZE</a></CODE> characters, including newline and terminating characters, but the friend list is limited to the display of 16 double-byte characters x 2 lines, and anything exceeding that is cut off and not displayed.<br /><br />The strings that are displayed on other players' friend lists have the following relationship with the system region.<br /><br /><B>Japan, the Americas, and Europe:</B> The characters for Japan, the Americas, and Europe included in the internal fonts.<br /><br /><B>China:</B> Simplified Chinese characters included in the internal fonts.<br /><br /><B>Korea:</B> Hangul characters included in the internal fonts.<br /><br /><B>Taiwan:</B> Traditional Chinese characters included in the internal fonts.<br /><br />Characters that are not included here are replaced with the Nintendo extended character "?" (L'\xE011') for display. For details about the character sets included in each font, see the <I>CTR Overview</I>.<br /><br />For newlines, use <I>L'\n'</I>.<br /><br />This function will not change the game mode specified to the <a href="../../../nn/friends/CTR/UpdateGameMode.html"><CODE>nn::friends::CTR::UpdateGameMode</CODE></a> function.<br /><br />Follow the guidelines when determining how often to call this function.</p><!-- write here --></div> 68<h2>Revision History</h2> 69 <div class="section"> 70 <dl class="history"> 71 <dt>2011/11/07</dt> 72<dd>Noted that you do not need to call the <CODE>nn::friends::CTR::Login</CODE> function in advance.<br />Noted that you need to follow the guidelines when determining how often to call this function.<br /> 73 </dd> 74 <dt>2011/10/26</dt> 75<dd>Added that the game mode does not change. 76 </dd> 77 <dt>2011/09/15</dt> 78<dd>Fixed unintended deletion of description details. 79 </dd> 80 <dt>2011/03/11</dt> 81<dd>Added specific examples of return values.<br /> 82 </dd> 83 <dt>2010/08/16</dt> 84<dd>Initial version.<br /> 85 </dd> 86 </dl> 87 </div> 88 <hr><p>CONFIDENTIAL</p></body> 89</html> 90