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>SetRootCaStore</title>
8  </head>
9  <body>
10<h1><CODE>nn::http::Connection::SetRootCaStore</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> SetRootCaStore(
15     <a href="../../../nn/http/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 a <CODE><a href="../../../nn/Result/Overview.html">Result</A></CODE> 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>ResultNoCaCertStoreErr</th>
50<td>Error indicating that the specified CA certificate store has not been registered. Either <CODE>nn::CertStore::Initialize</CODE> has not yet been called for the instance of <a href="../../../nn/http/CertStore/Overview.html"><CODE>ClientStore</CODE></a> passed as an argument, or <CODE>nn::CertStore::Finalize</CODE> has already been called. Call this function again, passing in an instance of <CODE>Cert</CODE> for which you have already called <CODE>nn::CertStore::Initialize</CODE>.</td>
51        </tr>
52        <tr>
53<th>ResultNotConnectedErr</th>
54<td>Error indicating a <CODE>Connection</CODE> class instance for which the target URL is not assigned. 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/http/Connection/Initialize.html"><CODE>Initialize</CODE></a>.</td>
55        </tr>
56        <tr>
57<th>ResultNotInitializedErr</th>
58<td>Error indicating that the library is not initialized. None of this library's functions can be used until you first call <a href="../../../nn/http/Initialize.html"><CODE>nn::http::Initialize</CODE></a>.</td>
59        </tr>
60        <tr>
61<th>A value other than the above.</th>
62<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td>
63        </tr>
64      </table> </div>
65<h2>Description</h2>
66    <div class="section">
67<p>Sets the CA certificate store. (Use this to reuse the same set of CA certificates with multiple HTTPS communication sessions. Do not release the configured certificate store during HTTPS communication with the communication targets.</p><!-- write here --></div>
68<h2>Revision History</h2>
69    <div class="section">
70      <dl class="history">
71        <dt>2010/06/14</dt>
72<dd>Initial version.<br />
73        </dd>
74      </dl>
75    </div>
76  <hr><p>CONFIDENTIAL</p></body>
77</html>