QuickHash Library

Type Library

SHA384_FinalHex

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

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

Note. Before the first call to SHA384_Update, SHA384_UpdateStr, SHA384_Final or SHA384_FinalHex functions, the context must be initialized with SHA384_Init.

VB Example

Private Sub MyButton_Click()   

    Dim Context As SHA384_Context

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

    SHA384_Init Context

    'Update the context with first part

    Dim nFirstLen As Long

    nFirstLen = nLen / 3

    SHA384_Update Context, MyBinData(1), nFirstLen

    'Update the context with second part

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

    'Get the digest

    SHA384_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    SHA384_Final, SHA384_Update, SHA384_UpdateStr, SHA384_Init, QHASH_ASCIItoBSTR