nn::boss::RegisterPrivateRootCa Function

Syntax

nn::Result RegisterPrivateRootCa(
const u8 * pCertData,
size_t certDataSize
);

Arguments

Name Description
in pCertData Root certificate data. The data format conforms to the ASN.1 standard.
in certDataSize Specifies the size of the client certificate data.

Return Values

Returns the function's execution result. Returns one of the Result values listed below.
Value Description
ResultSuccess Registration successful.
ResultIpcNotSessionInitialized Either a session had not been initialized or there were incompatible permissions. This Result value is returned if you call this function before Initialize or InitializePrivileged. Always call Initialize or InitializePrivileged first when you use the BOSS library.
A value other than the above. Unexpected error (see boss_Result.h for details).

Description

Registers an independent root certificate with the library which can be used for HTTPS communications. To use a registered certificate in a task, call the SetPrivateRootCa function from either the DownloadAction or NsaDownloadAction class. Only one root certificate can be registered. If there is a duplication, the contents of the last to be registered is what becomes valid.

Revision History

2010/09/16
Initial version.

CONFIDENTIAL