CryptoSys API Library Manual

HASH_HexFromHex

Creates a message digest hash in hexadecimal format from data in a hexadecimal-encoded string. The hash algorithm to use is passed in the options parameter.

VB6/VBA Syntax

Public Declare Function HASH_HexFromHex Lib "diCryptoSys.dll" (ByVal strOutput As String, ByVal nMaxChars As Long, ByVal strMsgHex As String, ByVal nOptions As Long) As Long

nRet = HASH_HexFromHex(strOutput, nMaxChars, strMsgHex, nOptions)

Parameters

strOutput
[out] String to receive hash digest in hexadecimal format.
nMaxChars
[in] Long specifying the maximum number of characters to be received.
strMsgHex
[in] String containing the message data in hexadecimal-encoded format.
nOptions
[in] Long Option flags. Select one of:
API_HASH_SHA1 (0) to use the SHA-1 algorithm (default)
API_HASH_MD5 to use the MD5 algorithm
API_HASH_MD2 to use the MD2 algorithm
API_HASH_RMD160 to use the RIPEMD-160 algorithm
API_HASH_SHA224 to use the SHA-224 algorithm
API_HASH_SHA256 to use the SHA-256 algorithm
API_HASH_SHA384 to use the SHA-384 algorithm
API_HASH_SHA512 to use the SHA-512 algorithm

C/C++ Syntax

long _stdcall HASH_HexFromHex(char *szOutput, long nMaxChars, const char *szMsgHex, long nOptions);

Returns (VB6/C)

Long: If successful, the return value is the number of characters in the output string; otherwise it returns a negative error code.

.NET Equivalent

Hash.HexFromHex Method

Remarks

Specify a zero nOutChars or an empty ("") or NULL strOutput parameter to find out the required length of the output string. The maximum number of characters is API_MAX_HASH_CHARS. Hint: SHA-1 requires 40 (API_SHA1_CHARS) characters; MD5 and MD2 require 32 characters. C/C++ users should add one to this value before allocating memory. The final digest will be truncated to the specified length if less than the expected size. Only lower-case letters [a-f] are used in the output.

Example

Dim strDigest As String
Dim nRet As Long
Dim strData As String
strDigest = String(API_SHA1_CHARS, " ")
strData = "616263"
nRet = HASH_HexFromHex(strDigest, Len(strDigest), strData, API_HASH_SHA1)
Debug.Print strDigest

See Also

HASH_HexFromBytes HASH_Bytes

[Contents] [Index]

[HOME]   [NEXT: MAC_Bytes...]

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