CryptoSys API Library Manual

SHA1_BytesHexHash

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

VB6/VBA Syntax

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

nRet = SHA1_BytesHexHash(strDigest, abData(0), nDataLen)

Parameters

strDigest
[out] String to receive message digest.
abData
[in] Byte array containing the message to be hashed.
nDataLen
[in] Long containing number of bytes in the array.

C/C++ Syntax

long _stdcall SHA1_BytesHexHash(char *strDigest, const unsigned char *bytes, long len);

Returns (VB6/C)

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

.NET Equivalent

Sha1.HexHash Method (Byte[])

COM/ASP Equivalent

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

See sha1.HexHexHash.

Remarks

strDigest must be at least 40 (API_MAX_SHA1_CHARS) characters long (41 in a C program).

VB6/VBA users: Note the '(0)' in abData(0).

Example

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

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

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

This should result in output as follows:

 0 a9993e364706816aba3e25717850c26c9cd0d89d

See Also

SHA1_StringHexHash SHA1_FileHexHash

[Contents] [Index]

[HOME]   [NEXT: SHA1_FileHexHash...]

Copyright © 2001-11 D.I. Management Services Pty Ltd. All rights reserved.