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>GetNewDataNsDataIdList</title>
8  </head>
9  <body>
10<h1><CODE>nn::boss::GetNewDataNsDataIdList</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> GetNewDataNsDataIdList(
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>Specifies the data type and gets a list of NS new arrival content from the registered storage expanded save region. The new arrival flag is cleared if this function is used to get all lists. 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