HMAC_Init
HMAC_Init
Initializes user-supplied memory as
IppsHMACState
or IppsHMACState_rmf
context for future use.Syntax
IppStatus ippsHMAC_Init(const Ipp8u *
pKey
, int
keyLen
, IppsHMACState *
pCtx
,
IppHashAlgId
hashAlg
);
IppStatus ippsHMACInit_rmf(const Ipp8u*
pKey
, int
keyLen
, IppsHMACState_rmf*
pCtx
, const IppsHashMethod*
pMethod
);
Include Files
ippcp.h
Parameters
- pKey
- Pointer to the user-supplied key.
- keyLen
- Key length in bytes.
- pCtx
- Pointer to theIppsHMACStateorIppsHMACState_rmfcontext being initialized.
- hashAlg
- Identifier of the hash algorithm.
- pMethod
- Pointer to the hash method.
Description
The function initializes the memory pointed to by
pCtx
as the IppsHMACState
or IppsHMACState_rmf
context. The function also sets up the initial chaining digest value according to the hash algorithm specified by the hashAlg
or pMethod
parameter and computes necessary key material from the supplied key pKey
. 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 ifkeyLenis less than one.
- ippStsNotSupportedModeErr
- Indicates an error condition if thehashAlgparameter does not match anyvalue of.IppHashAlglisted in table Supported Hash Algorithms