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>SetServerCertStore</title> 8 </head> 9 <body> 10<h1><CODE>nn::ssl::Connection::SetServerCertStore</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> SetServerCertStore( 15 <a href="../../../nn/ssl/CertStore/Overview.html">CertStore</a> & certStore 16); 17</pre> 18 </div> 19<h2>Arguments</h2> 20 <div class="section"> 21 <table class="arguments"> 22 <thead> 23 <tr> 24 <td width="15" /> 25<th>Name</th> 26<td>Description</td> 27 </tr> 28 </thead> 29 <tr> 30<td>in</td> 31<th>certStore</th> 32<td>Certificate store to set.</td> 33 </tr> </table> 34 </div> 35<h2>Return Values</h2> 36<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 /> 37 <table class="arguments"> 38 <thead> 39 <tr> 40<th>Value</th> 41<td>Description</td> 42 </tr> 43 </thead> 44 <tr> 45<th><CODE>ResultSuccess</CODE></th> 46<td>Process was successful.</td> 47 </tr> 48 <tr> 49<th>ResultIpcSessionErr</th> 50<td>Error indicating an uninitialized connection. The function has not done anything as it has been called on a <CODE>Connection</CODE> instance for which you have not yet successfully called <a href="../../../nn/ssl/Connection/Initialize.html"><CODE>Initialize</CODE></a>.</td> 51 </tr> 52 <tr> 53<th>ResultNotInitializedErr</th> 54<td>Error indicating that the library is not initialized. None of the functions in this library can be run without first running <a href="../../../nn/ssl/Initialize.html"><CODE>nn::ssl::Initialize</CODE></a>.</td> 55 </tr> 56 <tr> 57<th>A value other than the above.</th> 58<td>Unexpected error (see <CODE>ssl_Result.h</CODE> for error details).</td> 59 </tr> 60 </table> </div> 61<h2>Description</h2> 62 <div class="section"> 63<p>Sets the certificate store to use in SSL communication. This API function is provided to allow API users to set their own certificate stores.</p><p>The certificate that is set using this function is recognized as a trusted certificate. If a CA certificate is set, the CA of the certificate that was configured is registered as a candidate for successful verification during root CA verification of the certificate chain sent from the server. (In other words, root CA verification will succeed for any CAs that are set by the the root CA.）<br /> If a server certificate is set, the certificate verification will succeed if the certificate in question corresponds with the certificate sent from the server. <B>Note:</B> If a server certificate is set, no verification will be done on the content of the server certificate. This is because verification will succeed as long as the data of the certificate path matches. (For example, even if you were to specify the <CODE>nn::ssl::VERIFY_DATE</CODE> option, as long as the data matches, the expiration wouldn't be checked.)<br /> If a CA certificate is set, all certificates within the certificate chain sent from the server except the CA certificate will have their content verified. (For example, if the <CODE>nn::ssl::VERIFY_DATE</CODE> option is specified, the expiration dates of the certificates will be verified based on the time of the device's clock.)<br /></p><!-- write here --></div> 64<h2>Revision History</h2> 65 <div class="section"> 66 <dl class="history"> 67 <dt>2010/06/14</dt> 68<dd>Initial version.<br /> 69 </dd> 70 </dl> 71 </div> 72 <hr><p>CONFIDENTIAL</p></body> 73</html> 74