HMAC_Message
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.This function has a
reduced memory footprint
version. To learn more, see Reduced Memory Footprint 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 isNULL.
- ippStsLengthErr
- Indicates an error condition if:
- msgLenis less than zero
- mdLenis less than one or greater than the length of the hash value
- macLenis less than one or greater than the length of the hash value
- ippsStsNotSupportedModeErr
- Indicates an error condition if thehashAlgparameter does not match anyvalue of.IppHashAlglisted in table Supported Hash Algorithms