Visible to Intel only — GUID: GUID-885A851B-522F-4930-ACDE-9FAE13CDFEAE
Visible to Intel only — GUID: GUID-885A851B-522F-4930-ACDE-9FAE13CDFEAE
HMAC_Message
Computes the HMAC value of an entire message.
Syntax
IppStatus ippsHMAC_Message(const Ipp8u *pMsg, int msgLen, const Ipp8u *pKey, int keyLen, Ipp8u *pMD, int mdLen, IppHashAlgId hashAlg);
IppStatus ippsHMACMessage_rmf(const Ipp8u *pMsg, int msgLen, const Ipp8u *pKey, int keyLen, Ipp8u *pMAC, int macLen, const ippsHashMethod *pMethod);
Include Files
ippcp.h
Parameters
pMsg |
Pointer to the input message. |
msgLen |
Message length in bytes. |
pKey |
Pointer to the user-supplied key. |
keyLen |
Key length in bytes. |
pMD, pMAC |
Pointer to the resultant HMAC value. |
mdLen, macLen |
Specified HMAC length. |
hashAlg |
Identifier of the hash algorithm. |
pMethod |
Pointer to the hash method. |
Description
The function takes the input secret key pKey of the specified key length keyLen and applies the keyed hash-based message authentication code scheme to transform the input message into the respective message authentication code pMD or pMAC of the specified length mdLen or macLen. The hashAlg and pMethod parameters define the hash algorithm applied. The hashAlg parameter can take one of the values listed in table Supported Hash Algorithms. To get a value for the pMethod parameter, call one of the HashMethod 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:
|
ippsStsNotSupportedModeErr |
Indicates an error condition if the hashAlg parameter does not match any value of IppHashAlg listed in table Supported Hash Algorithms. |