hu_KSGetShare()

Returns the share corresponding to the index.

Synopsis:

#include "huks.h"

int hu_KSGetShare(sb_Context ksContext, size_t index, size_t *shareLen, unsigned char *share, sb_GlobalCtx sbCtx)

Since:

BlackBerry 10.0.0

Arguments:

ksContext: A Key Split context.

index: Index of share. Index must be greater than zero.

shareLen: Size of share in bytes.

share: Value of share.

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 share must be sufficiently large, and the size must be indicated in shareLen.

If NULL is passed in as the value of share, this function will return the buffer length required to store the requested share. The size/length of the output buffer will be returned in shareLen.

Returns:

SB_ERR_BAD_PARAMETER: index is zero.

SB_ERR_NULL_CONTEXT: Key Split context is NULL.

SB_ERR_BAD_CONTEXT: Key Split context is invalid.

SB_ERR_NULL_OUTPUT_BUF_LEN: shareLen is NULL.

SB_ERR_BAD_OUTPUT_BUF_LEN: Insufficient output buffer.

SB_SUCCESS: Success.