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>GetOwnNsDataIdList</title>
8  </head>
9  <body>
10<h1><CODE>nn::boss::GetOwnNsDataIdList</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> GetOwnNsDataIdList(
15     u32 dataType,
16     <a href="../../nn/boss/NsDataIdList/Overview.html">NsDataIdList</a> * pNsDataId
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>dataType</th>
33<td>Specifies the data type. (Use <CODE>DATA_TYPE_ALL</CODE> to specify all data types.)</td>
34        </tr>
35        <tr>
36<td>out</td>
37<th>pNsDataId</th>
38<td>Specifies an object storing a list of content data.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the function's execution result. Returns one of the <a href="../../nn/Result/Overview.html"><CODE>Result</CODE></A></a> values listed below. <br />
43      <table class="arguments">
44        <thead>
45          <tr>
46<th>Value</th>
47<td>Description</td>
48          </tr>
49        </thead>
50        <tr>
51<th><CODE>ResultSuccess</CODE></th>
52<td>Retrieval successful.</td>
53        </tr>
54        <tr>
55<th><CODE>ResultNsDataListSizeShortage</CODE></th>
56<td>Size of <CODE>NsDataIdList</CODE> is insufficient (could not store all the NSD serial IDs). Continue calling repeatedly until you get all the NSD serial IDs.</td>
57        </tr>
58        <tr>
59<th><CODE>ResultNsDataListUpdated</CODE></th>
60<td>The target NSD group for BOSS storage was updated since the last time a list was obtained.</td>
61        </tr>
62        <tr>
63<th><CODE>ResultInvalidNsDataIdList</CODE></th>
64<td>The pointer to NS data list information is <CODE>NULL</CODE>.</td>
65        </tr>
66        <tr>
67<th><CODE>ResultStorageNotFound</CODE></th>
68<td>Storage has not been registered for the corresponding application ID. Confirm whether any storage has been registered yet.</td>
69        </tr>
70        <tr>
71<th><CODE>ResultIpcNotSessionInitialized</CODE></th>
72<td>Either the session is not initialized or there are incompatible permissions. This <CODE>Result</CODE> is returned if this function is called before the <a href="../../nn/boss/Initialize.html"><CODE>Initialize</CODE></A> or the <CODE>InitializePriviledged</CODE> function is called. Always call the <a href="../../nn/boss/Initialize.html"><CODE>Initialize</CODE></a> or <CODE>InitializePrivileged</CODE> function first when you use the BOSS library.</td>
73        </tr>
74        <tr>
75<th>A value other than the above.</th>
76<td>Unexpected error (see <CODE>boss_Result.h</CODE> for error details).</td>
77        </tr>
78      </table> </div>
79<h2>Description</h2>
80    <div class="section">
81<p>Excludes the shared NS data and gets the application's list of NS content from the expanded save region registered as storage. In other words, only NS data for the invoked application is included in the list, even if there is shared NS data. The return value is <CODE>ER_NSDATA_LIST_SIZE_SHORTAGE</CODE> if the entire list could not be obtained. If you call this function more than once and an update in the list's content, such as a new download, is detected, <CODE>ER_NSDATA_LIST_UPDATED</CODE> is returned and you must start over. In this case, re-call this function after initializing the instance of <a href="../../nn/boss/NsDataIdList/Overview.html"><CODE>NsDataIdList</CODE></A>.</p><!-- write here --></div>
82<h2>Revision History</h2>
83    <div class="section">
84      <dl class="history">
85        <dt>2010/09/16</dt>
86<dd>Initial version.<br />
87        </dd>
88      </dl>
89    </div>
90  <hr><p>CONFIDENTIAL</p></body>
91</html>
92