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 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>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 that no target URL was assigned to the <CODE>Connection</CODE> object. No action performed because the <CODE>Connection</CODE> object has not been initialized by a successful call of <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>
78