nn::ssl::CertStore::RegisterCert Member Function

Syntax

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

Arguments

Name Description
in inCaCertName Name of internal CA certificate.
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 one of the Result values 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. When using this class, always call Initialize after instantiation. It may also be returned if the the total number of certificates registered in the SSL library is already at the maximum allowed by the system, or in other similar situations. 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 the functions in this library can be run without first running nn::ssl::Initialize.
A value other than the above. Unexpected error (see ssl_Result.h for error details).

Description

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


CONFIDENTIAL