AES_CCMStart#

Starts the process of authenticated encryption/decryption for a new message.

Syntax#

IppStatus ippsAES_CCMStart(const Ipp8u* pIV, int ivLen, const Ipp8u* pAD, int adLen, IppsAES_CCMState* pCtx);

Include Files#

ippcp.h

Parameters#

pIV

Pointer to the initialization vector.

ivLen

Length of the initialization vector *pIV (in bytes).

pAD

Pointer to the additional authenticated data.

adLen

Length of additional authenticated data *pAAD (in bytes).

pCtx

Pointer to the IppsAES_CCMState context.

Description#

The function resets internal counters and buffers of the *pCtx context.

Return Values#

ippStsNoErr

Indicates no error. Any other value indicates an error or warning.

ippStsNullPtrErr

Indicates an error condition if any of the specified pointers is NULL.

ippStsContextMatchErr

Indicates an error condition if the context parameter does not match the operation.

ippStsLengthErr

Indicates an error condition if ivLen < 7 or ivLen > 13, if adLen is less than zero, or if the message length specified in the previous call to AES_CCMMessageLen does not fit into 15 - ivLen bytes or exceeds (232 - 1) * 16 bytes.