2.8.1.4 Crypto_Sym_AesKeyUnWrapDirect

crypto_Sym_Status_E Crypto_Sym_AesKeyUnWrapDirect(
    crypto_HandlerType_E handlerType_en, 
    uint8_t *ptr_inputData, 
    uint32_t inputLen, 
    uint8_t *ptr_outData, 
    uint8_t *ptr_key, 
    uint32_t keyLen, 
    uint8_t *ptr_initVect, 
    uint32_t sessionID
    );

Description

This API is used to unwrap the data using AES-KW in a single step without initializing context.

Parameters

No.Argument TypeArgument NameTypeDescription
1crypto_HandlerType_EhandlerType_enInputEnum for crypto operation handler i.e., SW, HW
2uint8_t*ptr_inputDataInputInput data to unwrap
3uint32_tinputLenInputInput length of cipher data in bytes
4uint8_t*ptr_outDataOutputPointer to store plain text as output
5uint8_t*ptr_keyInputKey for the Symmetric operation
6uint32_tkeyLenInputKey length for the Symmetric algorithm in bytes
7uint8_t*ptr_initVectInputInitialization vector
8uint32_tsessionIDInputIt defines the session ID, must be more than zero

Returns

Return TypeDescription
crypto_Sym_Status_EFunction returns the status of the API.

Example

#define sessionID 1
crypto_Sym_Status_E status;
crypto_HandlerType_E handlerType_en = CRYPTO_HANDLER_HW_INTERNAL;
uint8_t key[16] = {/*data*/};
uint32_t keyLen = sizeof(key);
uint8_t *ptr_initVect = NULL;
uint8_t inputData[64] = {/*data*/};
uint32_t dataLen = sizeof(inputData);
uint8_t outData[64];

status = Crypto_Sym_AesKeyUnWrapDirect(
    handlerType_en,
    inputData, 
    dataLen, 
    outData, 
    key, 
    keyLen, 
    ptr_initVect,
    sessionID
    );