nn::boss::RegisterPrivateRootCa Function

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

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

Returns the function's execution result. Returns one of the Result values listed below.

Value	Description
Result::IsSuccess	Registration successful.
ResultIpcNotSessionInitialized	The session has not been initialized. This Result is returned if this function is called before the Initialize function is called. Always call the Initialize function before using the BOSS library.
A value other than the above.	Unexpected error (see boss_Result.h for error details).

Registers the independent root CA certificate in the BOSS library. They are used when using HTTPS communication as a connection when executing a task.
There is no need to call this function if an independent root CA certificate is not used.

Call nn::boss::TaskAction::SetPrivateRootCa to use a registered independent root CA certificate.

An independent certificate and the built-in device certificate can be used together.
Only one root CA certificate can be set as an independent certificate.
If settings are duplicated, the last set root CA certificate is valid.

Note: Currently, it is not permitted to register tasks that connect to servers other than the BOSS data server provided by Nintendo.

2010/09/16

Initial version.