AESInit

Developer Reference for Intel® Integrated Performance Primitives Cryptography

Initializes user-supplied memory as IppsAESSpec context for future use.

Syntax

IppStatus ippsAESInit(const Ipp8u* pKey, int keylen, IppsAESSpec* pCtx, int ctxSize);

Include Files

ippcp.h

Parameters

pKey	Pointer to the AES key.
keylen	Key byte stream length in bytes defined by the IppsRijndaelKeyLength enumerator.
pCtx	Pointer to the buffer being initialized as IppsAESSpec context.
ctxSize	Available size of the buffer being initialized.

Description

This function initializes the memory pointed by pCtx as IppsAESSpec. The key is used to provide all necessary key material for both encryption and decryption operations.

Note

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 pCtx pointer is NULL.
ippStsLengthErr	Returns 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.