Developer Reference

Contents

AES_CCMInit

Initializes user-supplied memory as the
IppsAES_CCMState
context for future use.

Syntax

IppStatus ippsAES_CCMInit(const Ipp8u*
pKey
, int
keyLen
, IppsAES_CCMState*
pState
, int
ctxSize
);
Include Files
ippcp.h
Parameters
pKey
Pointer to the secret key.
keyLen
Length of the secret key.
pState
Pointer to the buffer being initialized as
IppsAES_CCMState
context.
ctxSize
Size of the buffer being initialized.
Description
The function initializes the memory pointed by
pState
as the
IppsAES_CCMState
context. In addition, the function uses the initialization variable and additional authenticated data to provide all necessary key material for both encryption and decryption.
If the
pKey
pointer is
NULL
, the function initializes the context with the zero key, which can help you to clean up the actual secret before releasing the context.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if the
pState
pointer is
NULL
.
ippStsLengthErr
Indicates an error condition an error condition if
keyLen
is not equal to 16, 24, or 32.
ippStsMemAllocErr
Indicates an error condition if the allocated memory is insufficient for the operation.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.