hu_AESEncryptKeySet()

Creates an AES key object from the given key value that can later be used for encryption.

Synopsis:

#include "huaes.h"

int hu_AESEncryptKeySet(sb_Params aesParams, size_t keyLen, const unsigned char *keyValue, sb_Key *aesKey, sb_GlobalCtx sbCtx)

Since:

BlackBerry 10.0.0

Arguments:

aesParams: The AES parameters object.

keyLen: The length (in bits) of the AES key value. The acceptable values are SB_AES_128_KEY_BITS, SB_AES_192_KEY_BITS, SB_AES_256_KEY_BITS, SB_AES_128_XTS_KEY_BITS and SB_AES_256_XTS_KEY_BITS.

keyValue: The key value.

aesKey: The AES key object pointer.

sbCtx: A global context.

Library:

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

Description:

If the key will be used for both encryption and decryption, then hu_AESKeySet() should be called instead of this function.

In XTS mode, two AES keys are used. Therefore, the key size for XTS mode is twice as large as an AES key.

Returns:

SB_ERR_NULL_PARAMS: The aesParams object is NULL.

SB_ERR_BAD_PARAMS: The tag for the params object is not of the expected type.

SB_ERR_BAD_KEY_LEN: keyLen is an invalid key length.

SB_ERR_NULL_INPUT_BUF: keyValue is NULL.

SB_ERR_NULL_KEY_PTR: The aesKey object pointer is NULL.

SB_FAIL_ALLOC: Memory allocation failure.

SB_SUCCESS: Success.