nn::http::CertStore::RegisterCert Member Function

Syntax

nn::Result RegisterCert(
     InternalCaCertId inCaCertName,
     CertId * pCertIdCourier = NULL
);

Arguments

Name Description
in inCaCertName The target device's built-in CA certificate. (The SSL library's nn::ssl::InternalCaCert value.)
out pCertIdCourier Used when unregistering a specific individual certificate by its ID (using the UnRegisterCert function). If this argument is not needed (such as when there is no need to unregister individual certificates; releasing a CertStore object unregisters all of its certificates at once), this can be left unspecified.

Return Values

Returns the function's execution result. Returns a Result listed below.
Value Description
ResultSuccess Process was successful.
ResultFailToCreateCertStoreErr Error indicating failure to create certificate store. The function returns this value when Initialize has not yet been called. You must call Initialize after creating an instance of this class in order to use it.
nn::ssl::ResultFailToCreateCertStoreErr 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.
ResultNotInitializedErr Error indicating that the library is not initialized. None of this library's functions can be used until you first call nn::http::Initialize.
A value other than the above. Unexpected error (See http_Result.h for details).

Description

Registers internal device CA certificates. Call this function multiple times to register multiple certificates.


CONFIDENTIAL