nn::boss::RegisterPrivateClientCert Function

Syntax

nn::Result RegisterPrivateClientCert(
     const u8 * pCertData,
     size_t certDataSize,
     const u8 * pPrivateKeyData,
     size_t privateKeyDataSize
);

Arguments

Name Description
in pCertData Client certificate data. The data format conforms to the ASN.1 standard.
in certDataSize Specifies the size of the client certificate data.
in pPrivateKeyData Private key data. The data format conforms to the ASN.1 standard.
in privateKeyDataSize Specifies the size of the private key data.

Return Values

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).

Description

Registers the independent client certificate and private key in the BOSS library. They are used when using HTTPS communication for the connection when executing a task
There is no need to call this function if an independent client certificate is not used.

Call nn::boss::TaskAction::SetPrivateClientCert to use a registered independent client certificate.

An independent certificate and the built-in device certificate can be used together.
Only one client certificate can be set as an independent certificate.
If settings are duplicated, the last set client 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.

Revision History

2010/09/16
Initial version.

CONFIDENTIAL