CMACRijndael128Init, CMACSafeRijndael128Init

Initialize user-supplied memory as IppsCMACRijndael128State context for future use.

Syntax

IppStatus ippsCMACRijndael128Init(const Ipp8u* pKey, IppsRijndaelKeyLength keyLen, IppsCMACRijndael128State* pState);

IppStatus ippsCMACSafeRijndael128Init(const Ipp8u* pKey, IppsRijndaelKeyLength keyLen, IppsCMACRijndael128State* pState);

Parameters

pKey

Pointer to the Rijndael128 key.

keyLen

Key bytestream length (in bytes) defined by the IppsRijndaelKeyLength enumerator.

pState

Pointer to the IppsCMACRijndael128State being initialized.

Description

These functions are declared in the ippcp.h file. Each function initializes the memory at the address of pState as the IppsCMACRijndael128State context. In addition, each function uses the key to provide all necessary key material for both encryption and decryption operations. CMAC based on the Rijndael128 cipher scheme uses the AES algorithm. Depending upon whether you wish to employ fast or safe implementation of the AES algorithm, call CMACRijndael128Init or CMACSafeRijndael128Init, respectively. For more information, see Rijndael Functions.

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.

ippStsLengthErr

Indicates an error condition if keyLen is not equal to IppsRijndaelKey128, IppsRijndaelKey192, or IppsRijndaelKey256.

See Also

Submit feedback on this help topic

Copyright © 2000 - 2010, Intel Corporation. All rights reserved.