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>GetApproachContextScreenName</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>::GetApproachContextScreenName</CODE> Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">Result</a> GetApproachContextScreenName(
15     <a href="../../../nn_types/char16.html">char16</a> screenName[SCREEN_NAME_SIZE],
16     const <a href="../../../nnfriendsApproachContext/Overview.html">ApproachContext</a> & approachContext,
17     bool replaceForeignCharacters = true,
18     <a href="../../../nn_types/u8.html">u8</a> * pFontRegion = NULL
19);
20</pre>
21    </div>
22    <h2>Parameters</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <td width="15" />
28            <th>Name</th>
29            <td>Description</td>
30          </tr>
31        </thead>
32        <tr>
33          <td>out</td>
34          <th>screenName[SCREEN_NAME_SIZE]</th>
35          <td>Specifies a pointer to a buffer that stores acquired screen names.</td>
36        </tr>
37        <tr>
38          <td>in</td>
39          <th>approachContext</th>
40          <td>Specifies the approach context of the user for which to get the display name.</td>
41        </tr>
42        <tr>
43          <td>in</td>
44          <th>replaceForeignCharacters</th>
45          <td>Specifies whether to convert non-ASCII characters to ? when the local host's font region differs from the one for the display name included in the approach context.</td>
46        </tr>
47        <tr>
48          <td />
49          <th>pFontRegion</th>
50          <td>
51            </td>
52        </tr>
53        <tr>
54          <td>in</td>
55          <th>pFontRegionList</th>
56          <td>Specifies a pointer to a buffer that stores the font region of the display name included in the approach context. Specify <CODE>NULL</CODE> if not needed.</td>
57        </tr> </table>
58    </div>
59    <h2>Return Values</h2>
60    <div class="section">Returns the result of the operation.<br /> <br />
61      <table class="arguments">
62        <thead>
63          <tr>
64            <th>Value</th>
65            <td>Description</td>
66          </tr>
67        </thead>
68        <tr>
69          <th><CODE>Result::IsSuccess</CODE></th>
70          <td>Process succeeded.</td>
71        </tr>
72        <tr>
73          <th><CODE>ResultInvalidPointer</CODE></th>
74          <td>Invalid pointer passed as argument.</td>
75        </tr>
76        <tr>
77          <th><CODE>ResultNotInitialized</CODE></th>
78          <td>The friend presence library is not initialized.</td>
79        </tr>
80        <tr>
81          <th><CODE>ResultInvalidArgument</CODE></th>
82          <td>Approach context decryption failed.</td>
83        </tr>
84        <tr>
85          <th>Other</th>
86          <td>Another result may be returned, depending on the internal state of the daemon and other factors.</td>
87        </tr>
88      </table> </div>
89    <h2>Description</h2>
90    <div class="section">
91      <p>Gets the user's display name included in the approach context.</p><!-- write here --></div>
92    <h2>Revision History</h2>
93    <div class="section">
94      <dl class="history">
95        <dt>2011/12/16</dt>
96        <dd>Initial version.<br />
97        </dd>
98      </dl>
99    </div>
100  <hr><p>CONFIDENTIAL</p></body>
101</html>