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>RegisterStorage</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/boss/Overview.html">boss</a>::RegisterStorage</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> RegisterStorage(
15     <a href="../../nn_types/bit32.html">bit32</a> storageId,
16     size_t storageSize,
17     <a href="../../nn/boss/StorageType.html">nn::boss::StorageType</a> storageType = nn::boss::USER_EXT_SAVEDATA_STORAGE
18);
19
20<a href="../../nn/Result/Overview.html">nn::Result</a> RegisterStorage(
21     <a href="../../nn_types/bit32.html">bit32</a> storageId,
22     size_t storageSize,
23     <a href="../../nn_types/u16.html">u16</a> entryCount,
24     <a href="../../nn/boss/StorageType.html">nn::boss::StorageType</a> storageType = nn::boss::USER_EXT_SAVEDATA_STORAGE
25);
26</pre>
27    </div>
28<h2>List of Overloaded Member Functions</h2>
29    <div class="section">
30      <table class="members">
31        <tr>
32          <td>
33<a href="./RegisterStorage(0).html"><CODE>RegisterStorage ( bit32, size_t, nn::boss::StorageType )</CODE> </a>
34          </td>
35<td>Registers BOSS storage.</td>
36        </tr>
37        <tr>
38          <td>
39<a href="./RegisterStorage(1).html"><CODE>RegisterStorage ( bit32, size_t, u16, nn::boss::StorageType )</CODE> </a>
40          </td>
41<td>Registers BOSS storage.</td>
42        </tr> </table>
43    </div>
44<h2>Description of <CODE>RegisterStorage ( bit32, size_t, nn::boss::StorageType )</CODE></h2>
45<div class="section"><p>BOSS storage must be registered before registering or executing NADL tasks.<br />NS data cannot be downloaded if the storage is not registered.</p><p>Before registering BOSS storage, you must first create an extended save data region in memory.<br />You must also create an expanded save data region, while specifying more than the total number of NS data files to be stored.<br />This function returns an error if you specify an expanded save data region ID in the <CODE>storageID</CODE> argument to which the application does not have access rights.</p><p>When downloading NS data, if the total size of NS data for BOSS storage exceeds the maximum data size, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted.</p><p>1) To get NS data without the application registering a task<br />If an application has already registered BOSS storage, and NS data addressed to that application is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.</p><p><B>2) To download NS data addressed to the application that registers a task<br /></B>If the application registers BOSS storage and then registers and runs a task, it can download NS data addressed to the application and store it in the BOSS storage specified when it registered the task. In addition, the same as with 1) above, if NS data addressed to the application that registered BOSS storage is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.</p><p>3) To share NS data with another application<br />You can get NS data downloaded to another application by registering BOSS storage ahead of time in the same extended save data region as that for another application. An application can even get this NS data from other applications when it downloads its own NS data. For more information on these operations, see the <a href="../../nn/boss/GetNsDataIdList.html"><CODE>GetNsDataIdList</CODE></a> and <a href="../../nn/boss/GetNewDataNsDataIdList.html"><CODE>GetNewDataNsDataIdList</CODE></a> functions.<br /><br /></p><!-- write here --></div>
46<h2>Description of <CODE>RegisterStorage ( bit32, size_t, u16, nn::boss::StorageType )</CODE></h2>
47<div class="section"><p>BOSS storage must be registered before registering or executing NADL tasks.<br />NS data cannot be downloaded if the storage is not registered.</p><p>Before registering BOSS storage, you must first create an extended save data region in memory.<br />You must also create an expanded save data region, while specifying more than the total number of NS data files to be stored.<br />This function returns an error if you specify an expanded save data region ID in the <CODE>storageID</CODE> argument to which the application does not have access rights.</p><p>When downloading NS data, if the total size of NS data for BOSS storage exceeds the maximum data size, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted. Similarly, even if the amount of NS data in BOSS storage exceeds <CODE>entryCount</CODE>, the NS data having the oldest serial ID (=the lowest serial ID) is automatically deleted. </p><p>1) To get NS data without the application registering a task<br />If an application has already registered BOSS storage, and NS data addressed to that application is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.</p><p><B>2) To download NS data addressed to the application that registers a task<br /></B>If the application registers BOSS storage and then registers and runs a task, it can download NS data addressed to the application and store it in the BOSS storage specified when it registered the task. In addition, the same as with 1) above, if NS data addressed to the application that registered BOSS storage is included in an NS archive downloaded by a task registered by another application, that NS data is automatically downloaded to the BOSS storage already registered.</p><p>3) To share NS data with another application<br />You can get NS data downloaded to another application by registering BOSS storage ahead of time in the same extended save data region as that for another application. An application can even get this NS data from other applications when it downloads its own NS data. For more information on these operations, see the <a href="../../nn/boss/GetNsDataIdList.html"><CODE>GetNsDataIdList</CODE></a> and <a href="../../nn/boss/GetNewDataNsDataIdList.html"><CODE>GetNewDataNsDataIdList</CODE></a> functions.<br /><br /></p><!-- write here --></div>
48  <hr><p>CONFIDENTIAL</p></body>
49</html>