QuickHash Library

Type Library

SHA512_FinalHex

void SHA512_FinalHex( [in,out]SHA512_Context* pContext,[out]SHA512_HexDigest* pDigest, [ in ]boolean bUpper );
 

Parameters

pContext

    [in/out] A memory buffer that is used as the context.

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

 pDigest

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

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

 bUpper

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

Remarks

Call this function to retrieve the SHA-2(512) message digest from the pContext context. The digest is retrieved as an ASCII null-terminated hexadecimal string in the pDigest memory buffer.

After the SHA512_FinalHex function  is performed, the context is initialized for new calculations, as it would be called SHA512_Init again.

Note. Before the first call to SHA512_Update, SHA512_UpdateStr, SHA512_Final or SHA512_FinalHex functions, the context must be initialized with SHA512_Init.

VB Example

Private Sub MyButton_Click()   

    Dim Context As SHA512_Context

    Dim Digest As SHA512_HexDigest

    Dim MyStrData As String

    MyStrData = "Hello World!"

    Dim nLen As Long

    nLen = Len(MyStrData)

    '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    

    'Initialize the context

    SHA512_Init Context

    'Update the context with first part

    Dim nFirstLen As Long

    nFirstLen = nLen / 3

    SHA512_Update Context, MyBinData(1), nFirstLen

    'Update the context with second part

    SHA512_Update Context, MyBinData(nFirstLen + 1), nLen - nFirstLen

    'Get the digest

    SHA512_FinalHex Context, Digest, True

    'Show the hexadecimal representation of the digest

    MsgBox QHASH_ASCIItoBSTR(Digest.Value(0))

End Sub

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

See Also    SHA512_Final, SHA512_Update, SHA512_UpdateStr, SHA512_Init, QHASH_ASCIItoBSTR