QuickHash Library Type Library

HMAC_CalculateHex

void HMAC_CalculateHex( [ in ] int nAlgID, [ out ]HMAC_HexDigest* pDest, [ in, size_is( nSrcLength ) ] const void* pSrc, [ in ]int nSrcLength, [in,size_is( nKeyLength )]const void* pKey, [ in ]int nKeyLength, [ in ] boolean bUpper );

Parameters

nAlgID

    [in] The ID of the hash algorithm selected for calculations. For example, nAlgID has to be set to SHA1_ALGID when you need to calculate the HMAC using SHA-1 hash algorithm.

    Note. All supported hash algorithms with their corresponding IDs are specified in the Predefined Constants List.

 pDest

    [out] A memory buffer that will receive the HMAC as an ASCII null-terminated string.

     Note. All predefined types are specified in the Predefined Types List.

 pSrc

    [in] A continuous memory block for which to calculate the HMAC.

 nSrcLength

    [in] Length in bytes of the memory block.

 pKey

    [in] The key which represents a continuous memory block.

 nKeyLength

    [in] Length in bytes of the key.

 bUpper

    [in] Uppercase flag. If bUpper is False, the received HMAC represents a lowercase string, otherwise it represents an uppercase string.

Remarks

Calculates the HMAC for the pSrc memory block using the key specified by pKey. The HMAC is retrieved as an ASCII null-terminated hexadecimal string in the pDest memory buffer.

VB Example

Private Sub MyButton_Click()   
    Dim Hmac As HMAC_HexDigest
    Dim MyStrData As String
    MyStrData = "Hello World!"
    Dim MyStrKey As String
    MyStrKey = "password"
    Dim nLen As Long
    nLen = Len(MyStrData)
    Dim nLenKey As Long
    nLenKey = Len(MyStrKey)
    'Convert the string to byte array
    Dim MyBinData() As Byte
    ReDim MyBinData(1 To nLen)    
    For i = 1 To nLen
        MyBinData(i) = Asc(Mid(MyStrData, i, 1))
    Next i    
    'Convert the key to byte array
    Dim MyBinKey() As Byte
    ReDim MyBinKey(1 To nLenKey)    
    For i = 1 To nLenKey
        MyBinKey(i) = Asc(Mid(MyStrKey, i, 1))
    Next i    
    'Get the MD5-HMAC
    HMAC_CalculateHex MD5_ALGID, Hmac, MyBinData(1), nLen, MyBinKey(1), nLenKey, True
    'Show the hexadecimal representation of the MD5-HMAC
    MsgBox QHASH_ASCIItoBSTR(Hmac.Value(0))
End Sub

 

 

Type Library Overview   |   Type Library Functions   |   Useful Links   |   HashCalc

 

See Also    HMAC_Calculate, HMAC_CalculateStr, HMAC_CalculateStrHex, QHASH_ASCIItoBSTR


 

 

Send Feedback to SlavaSoft Inc. Tell a friend about QuickHash Library