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>GetSimpleAddress</title> 8 </head> 9 <body> 10<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>::GetSimpleAddress</CODE> Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition">#include <nn/cfg.h> 14 15void GetSimpleAddress( 16 <a href="../../../nn/cfg/CTR/SimpleAddress/Overview.html">SimpleAddress</a> * pSimpleAddress 17); 18 19<a href="../../../nn/Result/Overview.html">nn::Result</a> GetSimpleAddress( 20 <a href="../../../nn/cfg/CTR/SimpleAddress/Overview.html">SimpleAddress</a> * pSimpleAddress, 21 <a href="../../../nn/cfg/CTR/SimpleAddressId/Overview.html">SimpleAddressId</a> simpleAddressId, 22 <a href="../../../nn_types/uptr.html">uptr</a> pWorkMemory, 23 <a href="../../../nn_types/u32.html">u32</a> workMemorySize 24); 25</pre> 26 </div> 27<h2>List of Overloaded Member Functions</h2> 28 <div class="section"> 29 <table class="members"> 30 <tr> 31 <td> 32<a href="./GetSimpleAddress(0).html"><CODE>GetSimpleAddress ( SimpleAddress * )</CODE> </a> 33 </td> 34<td>Gets the simple address information (such as the country and region name) that has been set by System Settings.</td> 35 </tr> 36 <tr> 37 <td> 38<a href="./GetSimpleAddress(1).html"><CODE>GetSimpleAddress ( SimpleAddress *, SimpleAddressId, uptr, u32 )</CODE> </a> 39 </td> 40<td>Gets the simple address information (such as the country and region name) having the specified ID.</td> 41 </tr> </table> 42 </div> 43<h2>Description of <CODE>GetSimpleAddress ( SimpleAddress * )</CODE></h2> 44<div class="section"><p>The size of the <a href="../../../nn/cfg/CTR/SimpleAddress/Overview.html">SimpleAddress</a> structure is at least 4 KB. Be careful not to exhaust the stack if it is allocated on the stack. The country and region names in the simple address information are guaranteed to be NULL terminated.</p><!-- write here --></div> 45<h2>Description of <CODE>GetSimpleAddress ( SimpleAddress *, SimpleAddressId, uptr, u32 )</CODE></h2> 46<div class="section"><p>Before calling this function, you must initialize the <a href="../../../nn/fs/Overview.html"><CODE>FS</CODE></a> library by calling the <CODE><a href="../../../nn/fs/Initialize.html">nn::fs::Initialize</a></CODE> function.<br />Do not call this function simultaneously from multiple threads.<BR></p><p>This function uses the memory buffer given by <CODE>pWorkMemory</CODE> as working memory. The required memory size is given by <a href="../../../nn/cfg/CTR/CFG_SIMPLE_ADDRESS_WORKMEMORY_SIZE.html"><CODE>nn::cfg::CTR::CFG_SIMPLE_ADDRESS_WORKMEMORY_SIZE</CODE></a>. Do not write to or free the specified working memory during execution of this function. Furthermore, make sure the application frees the specified working memory after it is finished being used.<BR></p><p>The size of the <a href="../../../nn/cfg/CTR/SimpleAddress/Overview.html">SimpleAddress</a> structure is at least 4 KB. Be careful not to exhaust the stack, if it is allocated on the stack. The country and region names in the simple address information are guaranteed to be <CODE>NULL</CODE> terminated.<BR></p><p>Country and region IDs may be added later. If you get detailed information regarding country and region ID received from a peer, you must keep in mind cases where that ID is unknown.<BR><a href="../../../nn/cfg/CTR/ResultNotFound/Overview.html"><CODE>ResultNotFound</CODE></a> is returned if you specify an unknown ID to this function. This return value must always be handled.</p><!-- write here --></div> 47 <hr><p>CONFIDENTIAL</p></body> 48</html>