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>GetDigest</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/NsaList/Overview.html">NsaList</a>::GetDigest</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">nn::Result</a> GetDigest(
15     <a href="../../../nn_types/u8.html">u8</a> * pDigestBuf,
16     size_t digestBufSize
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><CODE>out</CODE></td>
32<th><CODE>pDigestBuf</CODE></th>
33<td>The buffer storing NSA digest information.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th><CODE>digestBufSize</CODE></th>
38<td>The size of <CODE>pDigestBuf</CODE>.</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> values listed below.<br /> <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>Result::IsSuccess</CODE></th>
52<td>Retrieval successful.</td>
53        </tr>
54        <tr>
55<th><CODE>ResultNSAListInvalidFormat</CODE></th>
56<td>The file format is invalid.</td>
57        </tr>
58        <tr>
59<th>A value other than the above.</th>
60<td>Unexpected error (see <CODE>boss_Result.h</CODE> for error details).</td>
61        </tr>
62      </table> </div>
63<h2>Description</h2>
64    <div class="section">
65<p>Gets the digest value included in an NSA list.</p><p>Gets the digest value included in the NSA list (in the <CODE><a href="../../../nn/boss/NsaList/CheckValidity.html">CheckValidity</a></CODE> function, compares this with the calculated digest value). One use of this is to check whether the NSA list has been updated. When NSA updates on the server are infrequent, this can be used to quickly check whether the NSA list has been updated, by recording the digest value of the downloaded NSA list obtained by this function, and then the next time the NSA list is downloaded, first only comparing the digest values.</p><!-- write here --></div>
66<h2>Revision History</h2>
67    <div class="section">
68      <dl class="history">
69        <dt>2011/10/27</dt>
70<dd>Initial version.<br />
71        </dd>
72      </dl>
73    </div>
74  <hr><p>CONFIDENTIAL</p></body>
75</html>