Computes the MAC value of the entire message.
IppStatus ippsCMACRijndael128MessageDigest(const Ipp8u *pMsg, int msgLen, const Ipp8u *pKey, IppsRijndaelKeyLength keyLen, Ipp8u *pMD, int mdLen);
pMsg |
Pointer to the input message. |
msgLen |
Message length in bytes. |
pKey |
Pointer to the user-supplied key. |
keyLen |
Key length. |
pMD |
Pointer to the resulting MAC value. |
mdLen |
Specified MAC length. |
This function is declared in the ippcp.h file. The function takes the input key pKey of the specified key length keyLen and applies keyed cipher-based message authentication code scheme to transform the entire input message into the respective message authentication code pMAC of the specified length mdLen.
The function is actually a wrapper around the CMACRijndael128Init, CMACSafeRijndael128Init, CMACRijndael128Update, and CMACRijndael128Final functions. If your application has no access to all the necessary data, you can compute the MAC using a typical sequence of invoking the primitives, like the one described at the beginning of the Keyed Hash Functions section. CMACMessageDigest is convenient when the application can access the entire message. In this case, you can use this function to compute the result in a single call.
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 msgLen is less than zero, mdLen is less than 1 or greater than cipher's data block length, or keyLen value is illegal. |
Copyright © 2000 - 2010, Intel Corporation. All rights reserved.