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>RegisterCert</title>
8  </head>
9  <body>
10<h1><CODE>nn::http::CertStore::RegisterCert</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> RegisterCert(
15     <a href="../../../nn/http/InternalCaCertId.html">InternalCaCertId</a> inCaCertName,
16     <a href="../../../nn/http/CertId.html">CertId</a> * pCertIdCourier = NULL
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>inCaCertName</th>
33<td>The target device's built-in CA certificate. (The SSL library's <CODE><a href="../../../nn/ssl/InternalCaCert.html">nn::ssl::InternalCaCert</a></CODE> value.)</td>
34        </tr>
35        <tr>
36<td>out</td>
37<th>pCertIdCourier</th>
38<td>Used when unregistering a specific individual certificate by its ID (using the <a href="../../../nn/ssl/CertStore/UnRegisterCert.html"><CODE>UnRegisterCert</CODE></a> function). If this argument is not needed (such as when there is no need to unregister individual certificates; releasing a <CODE>CertStore</CODE> object unregisters all of its certificates at once), this can be left unspecified.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the function's execution result. Returns a <CODE><a href="../../../nn/Result/Overview.html">Result</A></CODE> listed below. <br />
43      <table class="arguments">
44        <thead>
45          <tr>
46<th>Value</th>
47<td>Description</td>
48          </tr>
49        </thead>
50        <tr>
51<th><CODE>ResultSuccess</CODE></th>
52<td>Process was successful.</td>
53        </tr>
54        <tr>
55<th>ResultFailToCreateCertStoreErr</th>
56<td>Error indicating failure to create certificate store. The function returns this value when <a href="../../../nn/http/CertStore/Initialize.html"><CODE>Initialize</CODE></a> has not yet been called. You must call <a href="../../../nn/http/CertStore/Initialize.html"><CODE>Initialize</CODE></a> after creating an instance of this class in order to use it.</td>
57        </tr>
58        <tr>
59<th>nn::ssl::ResultFailToCreateCertStoreErr</th>
60<td>Error indicating failure to create certificate store. The function returns this value in cases such as when the total number of certificates registered by the SSL library has reached the maximum allowed by the system. Unregistering a locally registered certificate or trying again later (provided another module unregisters a certificate in the meantime) may succeed.</td>
61        </tr>
62        <tr>
63<th>ResultNotInitializedErr</th>
64<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>
65        </tr>
66        <tr>
67<th>A value other than the above.</th>
68<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td>
69        </tr>
70      </table> </div>
71<h2>Description</h2>
72    <div class="section">
73<p>Registers internal device CA certificates. Call this function multiple times to register multiple certificates.</p>
74    </div>
75  <hr><p>CONFIDENTIAL</p></body>
76</html>