RegisterPrivateClientCert

nn::boss::RegisterPrivateClientCert Function

Syntax

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

Parameters

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