hu_KSGetSecret()

Recovers the secret.

Synopsis:

#include "huks.h"

int hu_KSGetSecret(sb_Context ksContext, size_t *secretLen, unsigned char *secret, sb_GlobalCtx sbCtx)

Since:

BlackBerry 10.0.0

Arguments:

ksContext: A Key Split context.

secretLen: Size of secret in bytes.

secret: Value of secret.

sbCtx: A global context.

Library:

libhuapi (For the qcc command, use the -l huapi option to link against this library)

Description:

The size of output buffer specified in secret must be sufficiently large, and the size must be indicated in secretLen.

If NULL is passed in as the value of secret, this function will return the buffer length required to store secret. The length will be returned in secretLen.

Returns:

SB_ERR_NULL_CONTEXT: Key Split context is NULL.

SB_ERR_BAD_CONTEXT: Key Split context is invalid.

SB_ERR_NULL_OUTPUT_BUF_LEN: secretLen is NULL.

SB_ERR_BAD_OUTPUT_BUF_LEN: Insufficient output buffer.

SB_SUCCESS: Success.