 |
|
SL_HMAC_Init int SL_HASHCALL SL_HMAC_Init( void* pContext, unsigned int nAlgID, const void* pKey, unsigned int nKeyLength ); Return value Nonzero if initialization is successful, otherwise 0. In particular, this function returns 0 when nAlgID is invalid. Parameters pContext [out] Pointer to the memory buffer that will be used as a context. nAlgID [in] The ID of the hash algorithm selected for calculations. For example, nAlgID has to be set to SLC_SHA1_ALGID when you need to calculate the HMAC using SHA-1 hash algorithm. All supported hash algorithms with their corresponding IDs are listed in Table1. pKey [in] Pointer to the key which represents a continuous memory block. nKeyLength [in] Length in bytes of the key. Remarks Initializes the context pointed by pContext with the key pointed by pKey. Before calling SL_HMAC_Init allocate at least SLC_HMAC_CONTEXTSIZE( CONTEXTSIZE, BLOCKSIZE ) bytes for the context. CONTEXTSIZE and BLOCKSIZE from the previous notation are predefined constants for the context size and the block size for a specific hash algorithm. For example, you have to allocate at least SLC_HMAC_CONTEXTSIZE( SLC_SHA1_CONTEXTSIZE, SLC_SHA1_BLOCKSIZE ) bytes for the context if you need to calculate the HMAC using SHA-1 hash algorithm. All supported hash algorithms with their corresponding CONTEXTSIZEs and BLOCKSIZEs are listed in Table1. Table1. Supported hash algorithms, their IDs, CONTEXTSIZEs and BLOCKSIZEs.
Example See the example for SL_HMAC_Final.
HMAC API Overview | HMAC API Functions | Useful Links | HashCalc
See Also SL_HMAC_InitKeyStr, SL_HMAC_Final, SL_HMAC_FinalHex, SL_HMAC_Update, SL_HMAC_UpdateStr
|
