1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<!--==========================================================================
3  Copyright 2008 Nintendo.  All rights reserved.
4
5  These coded instructions, statements, and computer programs contain
6  proprietary information of Nintendo of America Inc. and/or Nintendo
7  Company Ltd., and are protected by Federal copyright law.  They may
8  not be disclosed to third parties or copied or duplicated in any form,
9  in whole or in part, without the prior written consent of Nintendo.
10 ==========================================================================-->
11<HTML>
12<HEAD>
13	<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
14	<META http-equiv="Content-Style-Type" content="text/css">
15	<TITLE>CRYPTO_SIGN_GetModulus</TITLE>
16	<LINK rel="stylesheet" href="../../css/nitro.css">
17	<BASE target="main">
18</HEAD>
19<BODY>
20<H1>CRYPTO_SIGN_GetModulus <IMG src="../../image/NTR.gif" width="23" height="12" border="0" align="middle"><IMG src="../../image/TWL.gif" width="23" height="12" border="0" align="middle"></H1>
21<H2>Syntax</H2>
22<DL>
23	<DD>
24		<PRE><CODE>
25#include &lt;nitro/crypto/sign.h&gt;
26
27int CRYPTO_SIGN_GetModulus(
28const void* pub_ptr
29);
30		</CODE></PRE>
31	</DD>
32</DL>
33<H2>Arguments</H2>
34<TABLE border="1">
35	<TBODY>
36		<TR>
37			<TD width="25%"><EM><STRONG><CODE>pub_ptr</CODE></STRONG></EM></TD>
38			<TD width="75%">Specifies the pointer to the public key.</TD>
39		</TR>
40	</TBODY>
41</TABLE>
42<H2>Return Values</H2>
43<P>
44	Returns one of the following process results.
45</P>
46<TABLE border="1">
47	<TBODY>
48		<TR>
49			<TD width="25%"><EM><STRONG><CODE>Not NULL</CODE></STRONG></EM></TD>
50			<TD width="75%">The analysis succeeded, and a pointer to the modulus of the public key is returned.</TD>
51		</TR>
52		<TR>
53			<TD><EM><STRONG><CODE>NULL</CODE></STRONG></EM></TD>
54			<TD>Analysis failed.</TD>
55		</TR>
56	</TBODY>
57</TABLE>
58<H2>Description</H2>
59<P>
60	Analyzes the location of the modulus of the public key, and returns a pointer to that location. In <EM><STRONG>pub_ptr</STRONG></EM>, provide a pointer to the public key to use during signature verification. The pointer that is returned can be specified for the <CODE>mod_ptr</CODE> argument of functions such as <A href="CRYPTO_VerifySignature.html">CRYPTO_VerifySignature</A> or <A href="CRYPTO_VerifySignatureWithHash.html">CRYPTO_VerifySignatureWithHash</A>.
61</P>
62<P>
63	Using this function makes it unnecessary to search for the modulus of the public key.
64</P>
65<H2>See Also</H2>
66<P>
67	<CODE><A href="CRYPTO_VerifySignature.html">CRYPTO_VerifySignature</A><BR> <A href="CRYPTO_VerifySignatureWithHash.html">CRYPTO_VerifySignatureWithHash</A></CODE>
68</P>
69<H2>Revision History</H2>
70<P>
71	2008/09/16 Initial version.
72</P>
73<hr><p>CONFIDENTIAL</p></body>
74</HTML>
75