QuickHash Library

Type Library

SHA256_FinalHex

void SHA256_FinalHex( [in,out]SHA256_Context* pContext,[out]SHA256_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(256) message digest from the pContext context. The digest is retrieved as an ASCII null-terminated hexadecimal string in the pDigest memory buffer.

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

Note. Before the first call to SHA256_Update, SHA256_UpdateStr, SHA256_Final or SHA256_FinalHex functions, the context must be initialized with SHA256_Init.

VB Example

Private Sub MyButton_Click()   

    Dim Context As SHA256_Context

    Dim Digest As SHA256_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

    SHA256_Init Context

    'Update the context with first part

    Dim nFirstLen As Long

    nFirstLen = nLen / 3

    SHA256_Update Context, MyBinData(1), nFirstLen

    'Update the context with second part

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

    'Get the digest

    SHA256_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    SHA256_Final, SHA256_Update, SHA256_UpdateStr, SHA256_Init, QHASH_ASCIItoBSTR