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>ReadData</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/boss/Overview.html">boss</a>::<a href="../../../nn/boss/NsData/Overview.html">NsData</a>::ReadData</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn_types/s32.html">s32</a> ReadData(
15     <a href="../../../nn_types/u8.html">u8</a> * pDataBuf,
16     size_t bufLen
17);
18</pre>
19    </div>
20<h2>Parameters</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>out</td>
32<th>pDataBuf</th>
33<td>Specifies the NS data buffer.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>bufLen</th>
38<td>Specifies the NS data buffer length.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the size in bytes of the read data. Returns <CODE>0</CODE> if it reached the end of the data. <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>NN_BOSS_NSDATA_READ_ERROR_GET_HEADER</CODE></th>
52<td>Failed to get NS data header.</td>
53        </tr>
54        <tr>
55<th><CODE>NN_BOSS_NSDATA_READ_ERROR_READ_DATA</CODE></th>
56<td>Failed to load NS data.</td>
57        </tr>
58        <tr>
59<th><CODE>NN_BOSS_NSDATA_READ_ERROR_IPC</CODE></th>
60<td>Internal error occurred.</td>
61        </tr>
62        <tr>
63<th><CODE>NN_BOSS_NSDATA_READ_ERROR_UPDATED</CODE></th>
64<td>The target NS data version was updated since the last time data was obtained.</td>
65        </tr>
66      </table> </div>
67<h2>Description</h2>
68    <div class="section">
69<p>Reads the NSD data block.</p><p>After preparing an adequately sized buffer in advance, call this function multiple times to read an entire NS data file.<br />Returns <CODE>0</CODE> upon reaching end of file, indicating that the read is finished. <br />An application can only load one NS data file at a time, but even if it loads a large NSD, other applications are not blocked from loading NS data as long as the other applications do not try to access the same NS data.<br /><B>Note:</B> An error will be returned if the target NS data cannot be found, whether it is because another application has already deleted the NS data, there was not enough space available when downloading the NS archive, or the data was automatically deleted. The function returns <CODE>NN_BOSS_NSDATA_READ_ERROR_UPDATED</CODE> in those rare instances where the specified NS data version has been updated since the last time the data was obtained. In such cases, call the <a href="../../../nn/boss/NsData/Initialize.html"><CODE>Initialize</CODE></a> function and then read the data again.<br /></p><!-- write here --></div>
70<h2>Revision History</h2>
71    <div class="section">
72      <dl class="history">
73        <dt>2010/09/16</dt>
74<dd>Initial version.<br />
75        </dd>
76      </dl>
77    </div>
78  <hr><p>CONFIDENTIAL</p></body>
79</html>