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>GetCecInfoBuffer</title>
8  </head>
9  <body>
10<h1><CODE>nn::cec::CTR::GetCecInfoBuffer</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">nn::Result</a> GetCecInfoBuffer(
15     u32 cecTitleId,
16     u8 pCecInfoBuffer[ ],
17     size_t size
18);
19</pre>
20    </div>
21<h2>Arguments</h2>
22    <div class="section">
23      <table class="arguments">
24        <thead>
25          <tr>
26            <td width="15" />
27<th>Name</th>
28<td>Description</td>
29          </tr>
30        </thead>
31        <tr>
32<td>in</td>
33<th>cecTitleId</th>
34<td>Specifies the StreetPass ID.</td>
35        </tr>
36        <tr>
37<td>out</td>
38<th>pCecInfoBuffer[]</th>
39<td>Specifies the buffer to receive the <a href="../../../nn/cec/CTR/CecNotificationData/Overview.html"><CODE>CecNotificationData</CODE></a>.</td>
40        </tr>
41        <tr>
42<td>in</td>
43<th>size</th>
44<td>Specifies the buffer size.</td>
45        </tr> </table>
46    </div>
47<h2>Return Values</h2>
48<div class="section"><a href="../../../nn/Result/Overview.html"><CODE>nn::Result</CODE></a><br /> <br />
49      <table class="arguments">
50        <thead>
51          <tr>
52<th>Value</th>
53<td>Description</td>
54          </tr>
55        </thead>
56        <tr>
57<th><CODE>ResultSuccess</CODE></th>
58<td>Process succeeded.</td>
59        </tr>
60        <tr>
61<th><CODE>ResultNoData</CODE></th>
62<td>There was no data that could be obtained.</td>
63        </tr>
64      </table> </div>
65<h2>Description</h2>
66    <div class="section">
67<p>Gets information about a message received in the previous communication.</p><p>After you receive a receipt notification using <a href="../../../nn/cec/CTR/GetCecRecvEventHandle.html"><CODE>GetCecRecvEventHandle</CODE></a>, you can use this function to, for example, check whether there is data addressed to the foreground application.<br />This function can get information only about messages received in the immediately previous round of communication. It cannot get any information about data received earlier. Also, this function only gets the information associated with a message at the time of receipt. This information does not reflect any subsequent changes that happen in the inbox. This function can only get information about one message, even when multiple messages are received as a group.(The maximum <a href="../../../nn/cec/CTR/CecNotificationData/Overview.html"><CODE>CecNotificationData.num</CODE></a> value is <CODE>1</CODE>.)<br /> In addition, the obtained data does not include information about received data that was discarded because it was duplicated. <br />The <a href="../../../nn/cec/CTR/CecNotificationData/Overview.html"><CODE>CecNotificationData</CODE></a> <SPAN class="argument">count</SPAN> value increments every time StreetPass data is exchanged. You can check for changes in this value to determine whether an exchange has occurred.</p></div>
68  <hr><p>CONFIDENTIAL</p></body>
69</html>