1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>NETSHA256GetDigest</title>
8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9</head>
10
11<body>
12
13<h1 align="left">NETSHA256GetDigest</h1>
14<h2>Syntax</h2>
15
16<dl>
17  <dd>
18  <PRE><CODE>#include &lt;revolution/net.h&gt;
19
20void NETSHA256GetDigest(<A href="NETSHA256Context.html">NETSHA256Context</A>* context, void* digest);
21</CODE></PRE>
22  </dd>
23</dl><h2>Arguments</h2>
24
25<table border="1" width="100%">
26    <TR>
27      <TD width="176"><em><strong><font face="Courier New">context</font></strong></em></TD>
28      <TD width="670">Pointer to the context structure used for SHA-256 generation.</TD>
29    </TR>
30    <TR>
31      <TD width="176"><em><strong><font face="Courier New">digest</font></strong></em></TD>
32      <TD width="670">Pointer to the memory location that holds the message digest value.</TD>
33    </TR>
34  </table>
35<h2>Return Values</h2>
36<p>None.</p>
37<H2>Description</H2>
38<P>This function gets the digest value using SHA-256. You must use the <A href="NETSHA256Init.html"><CODE>NETSHA256Init</CODE></A> function to initialize the <em><strong><CODE>context</CODE></strong></em> argument in advance, and then use the <A href="NETSHA256Update.html"><CODE>NETSHA256Update</CODE></A> function to provide input data.<BR><br> This function rewrites <em><strong><CODE>context</CODE></strong></em> internally, so you cannot continue to use the same <em><strong><CODE>context</CODE></strong></em> in the <A href="NETSHA256Update.html"><CODE>NETSHA256Update</CODE></A> function.
39</p>
40<p>
41To store the hash length to be generated, be sure to pass a sufficient memory region in the <CODE>digest</CODE> argument. For details, see the &quot;SHA-256&quot; section of the <a href="hash_overview.html">hash algorithm</a>.
42</p>
43<h2>See Also</h2>
44<P><CODE><A href="NETSHA256Init.html">NETSHA256Init</A><BR><A href="NETSHA256Update.html">NETSHA256Update</A></CODE></P>
45<H2>Revision History</H2>
46<P>
472008/05/07 Initial version.<BR>
48</P>
49<hr><p>CONFIDENTIAL</p></body>
50</html>
51