CryptoSys API Library Manual

SHA2_BytesHexHash

Creates a SHA-256 message digest in hexadecimal format from a message in Byte array format.

VBA/VB6 Syntax

Public Declare Function SHA2_BytesHexHash Lib "diCryptoSys.dll" (ByVal strDigest As String, ByRef lpData As Byte, ByVal nDataLen As Long) As Long

nRet = SHA2_BytesHexHash(strDigest, abData(0), nDataLen) ' Note the "(0)" after the byte array parameters

C/C++ Syntax

long __stdcall SHA2_BytesHexHash(char *szDigest, const unsigned char *lpData, long nDataLen);

Parameters

szDigest
[out] to receive message digest.
lpData
[in] array containing the message to be hashed.
nDataLen
[in] containing number of bytes in the array.

Returns (VBA/C)

If successful, the return value is 0; otherwise it returns a non-zero error code.

.NET Equivalent

Sha256.HexHash Method (Byte[])

COM/ASP Equivalent

sha256.HexHexHash
Public Function HexHexHash(ByVal strHexData As String) As String

See sha256.HexHexHash.

Remarks

szDigest must be at least 64 (API_MAX_SHA2_CHARS) characters long (65 in a C program).

Example

    Dim nRet As Long
    Dim abData(2) As Byte   ' Create 3-byte array (NB zero-based)
    ' Alternative way of making sure string is 64 chars long
    Dim strDigest As String * 64

    ' Setup byte array with "abc"
    abData(0) = Asc("a")
    abData(1) = Asc("b")
    abData(2) = Asc("c")

    nRet = SHA2_BytesHexHash(strDigest, abData(0), 3)
    Debug.Print nRet; strDigest

This should result in output as follows:

 0 ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

See Also

SHA2_StringHexHash SHA2_FileHexHash

[Contents] [Index]

[PREV: SHA2_BytesHash...]   [Contents]   [Index]   
   [NEXT: SHA2_FileHexHash...]

Copyright © 2001-24 D.I. Management Services Pty Ltd. All rights reserved. Generated 2024-01-07T07:42:00Z.