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    <style type="text/css"><!--
8      span.static_style
9      {
10        font-size			: 8pt;
11        color				: white;
12        font-weight			: bold;
13        background			: #44f;
14        border-left			: solid 1px #aaf;
15        border-top			: solid 1px #aaf;
16        border-right		: solid 1px #00c;
17        border-bottom		: solid 1px #00c;
18        padding-left		: 2px;
19        padding-right		: 2px;
20      }
21
22      span.virtual_style
23      {
24        font-size			 : 8pt;
25        color				 : white;
26        font-weight			: bold;
27        background			: #0a0;
28        border-left			: solid 1px #0f0;
29        border-top			: solid 1px #0f0;
30        border-right		: solid 1px #060;
31        border-bottom		: solid 1px #060;
32        padding-left		: 2px;
33        padding-right		: 2px;
34      }
35
36      span.protected_style
37      {
38        font-size			 : 8pt;
39        color				 : white;
40        font-weight			: bold;
41        background			: #444;
42        border-left			: solid 1px #ccc;
43        border-top			: solid 1px #ccc;
44        border-right		: solid 1px #222;
45        border-bottom		: solid 1px #222;
46        padding-left		: 2px;
47        padding-right		: 2px;
48      }
49        --></style>
50<title>nn::cfg::CTR::SimpleAddress</title>
51  </head>
52  <body>
53<h1><CODE><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/cfg/Overview.html">cfg</a>::<a href="../../../../nn/cfg/CTR/Overview.html">CTR</a>::SimpleAddress</CODE> Structure</h1>
54<h2>Syntax</h2>
55    <div class="section">
56      <pre class="definition">struct SimpleAddress
57{
58   <a href="../../../../nn_types/u32.html">u32</a> id;
59   wchar_t countryName[CFG_SIMPLE_ADDRESS_NUM_LANGUAGES][CFG_SIMPLE_ADDRESS_NAME_LENGTH];
60   wchar_t regionName[CFG_SIMPLE_ADDRESS_NUM_LANGUAGES][CFG_SIMPLE_ADDRESS_NAME_LENGTH];
61   <a href="../../../../nn_types/u16.html">u16</a> latitude;
62   <a href="../../../../nn_types/u16.html">u16</a> longitude;
63};
64</pre>
65    </div>
66<h2>Description</h2>
67    <div class="section">
68<p>Structure that represents the user's simple address information configured in the System Settings.</p><p>The size of this structure is at least 4 KB. Be careful not to exhaust the stack if the user's simple address information is placed in the stack. The country and region names in the simple address information retrieved from the <CODE><a href="../../../../nn/cfg/CTR/GetSimpleAddress.html">nn::cfg::CTR::GetSimpleAddress</a></CODE> function are guaranteed to be <CODE>NULL</CODE> terminated.</p>The country code is stored in the upper 8 bits of <SPAN class="argument">id</SPAN>, and the region code is stored in the following 8 bits. The lower 16 bits are reserved. The country code is the same value you can get using the <CODE><a href="../../../../nn/cfg/CTR/GetCountry.html">nn::cfg::CTR::GetCountry</a></CODE> function. For more information about the region code, click <a href="SimpleAddressIdList.html">here</a>.</div>
69    <a name="variable" id="variable">
70<h2>Member Variables</h2>
71      <div class="section">
72        <table class="members">
73          <tr>
74            <td width="100"> </td>
75            <th>
76<span class="argument"><CODE>id</CODE></span>
77            </th>
78<td width="100"><a href="../../../../nn_types/u32.html">u32</a></td>
79<td>Simple address information ID. The country code is stored in the upper 8 bits, and the region code is stored in the following 8 bits. The lower 16 bits are reserved.</td>
80          </tr>
81          <tr>
82            <td width="100"> </td>
83            <th>
84<span class="argument"><CODE>countryName</CODE></span>
85            </th>
86<td width="100">wchar_t</td>
87<td>Stores country names in each language.</td>
88          </tr>
89          <tr>
90            <td width="100"> </td>
91            <th>
92<span class="argument"><CODE>regionName</CODE></span>
93            </th>
94<td width="100">wchar_t</td>
95<td>Stores region names in each language (such as the names of states or prefectures).<br />If a region is not selected, stores &quot;&mdash;.&quot; If regions cannot be selected for the given country setting, stores the country name.</td>
96          </tr>
97          <tr>
98            <td width="100"> </td>
99            <th>
100<span class="argument"><CODE>latitude</CODE></span>
101            </th>
102<td width="100"><a href="../../../../nn_types/u16.html">u16</a></td>
103<td>The latitude. Values <CODE>0x0000</CODE>&ndash;<CODE>0x4000</CODE> represent the range from 0 to +90 degrees; <CODE>0xC000</CODE>&ndash;<CODE>0xFFFF</CODE> represent the range from -90 to -0.005 degrees. Positive angles indicate the northern hemisphere; negative angles indicate the southern hemisphere.</td>
104          </tr>
105          <tr>
106            <td width="100"> </td>
107            <th>
108<span class="argument"><CODE>longitude</CODE></span>
109            </th>
110<td width="100"><a href="../../../../nn_types/u16.html">u16</a></td>
111<td>The longitude. Values <CODE>0x0000</CODE>&ndash;<CODE>0x7FFF</CODE> represent the range from 0 to +179.995 degrees; <CODE>0x8000</CODE>&ndash;<CODE>0xFFFF</CODE> represent the range from -180 to -0.005 degrees. Positive angles indicate the eastern hemisphere; negative angles indicate the western hemisphere.</td>
112          </tr> </table>
113      </div>
114    </a>
115<h2>Revision History</h2>
116    <div class="section">
117      <dl class="history">
118        <dt>2011/12/14</dt>
119<dd>Added a link for details about region codes.<br />Added an explanation about the data stored for region names.<br />
120        </dd>
121        <dt>2011/10/19</dt>
122<dd>Added information specific to simple address information IDs.<br />
123        </dd>
124        <dt>2011/10/11</dt>
125<dd>Added a note specific to region names.<br />
126        </dd>
127        <dt>2010/05/27</dt>
128<dd>Initial version.<br />
129        </dd>
130      </dl>
131    </div>
132  <hr><p>CONFIDENTIAL</p></body>
133</html>