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>NewMessage</title>
8  </head>
9  <body>
10    <h1><CODE>nn::cec::CTR::Message::NewMessage</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../../nn/Result/Overview.html">nn::Result</a> NewMessage(
15     <a href="../../../../nn/cec/CTR/TitleId.html">TitleId</a> cecTitleId,
16     u32 groupId,
17     <a href="../../../../nn/cec/CTR/MessageTypeFlag.html">MessageTypeFlag</a> messageTypeFlag,
18     <a href="../../../../nn/cec/CTR/SendMode.html">SendMode</a> sendMode,
19     u8 sendCount,
20     u8 propagationCount,
21     void * icon,
22     size_t iconSize,
23     wchar_t * infoTextData,
24     size_t infoTextSize
25);
26</pre>
27    </div>
28    <h2>Arguments</h2>
29    <div class="section">
30      <table class="arguments">
31        <thead>
32          <tr>
33            <td width="15" />
34            <th>Name</th>
35            <td>Description</td>
36          </tr>
37        </thead>
38        <tr>
39          <td>in</td>
40          <th>cecTitleId</th>
41          <td>Unique title ID.</td>
42        </tr>
43        <tr>
44          <td>in</td>
45          <th>groupId</th>
46          <td>The <a href="../../../../nn/cec/CTR/Message/Overview.html">message</a> group ID is the value set by the <a href="../../../../nn/cec/CTR/Message/SetGroupID.html"><CODE>SetGroupID</CODE> function</a>.</td>
47        </tr>
48        <tr>
49          <td>in</td>
50          <th>messageTypeFlag</th>
51          <td>Specifies whether the recipient is a <I>friend</I> or a <I>non-friend</I> using the <a href="../../../../nn/cec/CTR/MessageTypeFlag.html"><CODE>MessageTypeFlag</CODE></a> enumerated type.</td>
52        </tr>
53        <tr>
54          <td>in</td>
55          <th>sendMode</th>
56          <td>Specifies the send mode (receive only, send only, send and receive, or exchange) using the <CODE><a href="../../../../nn/cec/CTR/SendMode.html">SendMode</a></CODE> enumerated type. Use the value set by the <a href="../../../../nn/cec/CTR/Message/SetSendMode.html"><CODE>SetSendMode</CODE></a> function.</td>
57        </tr>
58        <tr>
59          <td>in</td>
60          <th>sendCount</th>
61          <td>The <CODE>sendCount</CODE> and <CODE>propagationCount</CODE> values cannot both be set to greater than 1 at the same time.</td>
62        </tr>
63        <tr>
64          <td>in</td>
65          <th>propagationCount</th>
66          <td>The <CODE>sendCount</CODE> and <CODE>propagationCount</CODE> values cannot both be set to greater than 1 at the same time.</td>
67        </tr>
68        <tr>
69          <td>in</td>
70          <th>icon</th>
71          <td>Specifies an icon.<br /> Format: RGB565 (little-endian)<br /> Size: 40 x 40 (3200 B)<br /></td>
72        </tr>
73        <tr>
74          <td>in</td>
75          <th>iconSize</th>
76          <td>Specifies the size of the icon data.</td>
77        </tr>
78        <tr>
79          <td>in</td>
80          <th>infoTextData</th>
81          <td>Sets the information text of a <a href="../../../../nn/cec/CTR/Message/Overview.html">Message</a>. Encoding UTF16-LE<br /> Display size: The number of characters displayable as two lines of 16 double-byte characters<br />Maximum buffer size: 128 x 2 B (including line breaks and the <CODE>NULL</CODE> terminator)<br /></td>
82        </tr>
83        <tr>
84          <td>in</td>
85          <th>infoTextSize</th>
86          <td>Specifies the data size for the information text of a <a href="../../../../nn/cec/CTR/Message/Overview.html">Message</a>.</td>
87        </tr> </table>
88    </div>
89    <h2>Return Values</h2>
90    <div class="section"><a href="../../../../nn/Result/Overview.html"><CODE>nn::Result</CODE></a> </div>
91    <h2>Description</h2>
92    <div class="section">
93      <p>Creates a new <a href="../../../../nn/cec/CTR/Message/Overview.html">message</a>.</p><p>This function sets the basic parameters. A message is sent during StreetPass communication after the message body is set by the <a href="../../../../nn/cec/CTR/Message/SetMessageBody.html"><CODE>SetMessageBody</CODE></a> function and the message is written to the outbox by the <a href="../../../../nn/cec/CTR/MessageBox/WriteMessage.html"><CODE>MessageBox::WriteMessage</CODE></a> function.</p><!-- write here --></div>
94    <h2>Revision History</h2>
95    <div class="section">
96      <dl class="history">
97        <dt>2010/08/16</dt>
98        <dd>Initial version.<br />
99        </dd>
100      </dl>
101    </div>
102  <hr><p>CONFIDENTIAL</p></body>
103</html>