CIPHER_InitHex

Initialize the CIPHER context with hex-encoded key, iv, algorithm and mode ready for repeated update operations. The key and IV data are passed as hexadecimal-encoded strings.

VBA/VB6 Syntax

hContext = CIPHER_InitHex(fEncrypt, strAlgAndMode, strKeyHex, strIvHex, nOptions)

C/C++ Syntax

Parameters

fEncrypt

[in] Direction flag: set as ENCRYPT (True) to encrypt or DECRYPT (False) to decrypt.

szAlgAndMode

[in] String specifying the block cipher algorithm and mode, e.g. "aes128/cbc" (see Specifying the algorithm and mode for generic block cipher functions).

szKeyHex

[in] Hex-encoded key of exact length for block cipher algorithm.

szIvHex

[in] Hex-encoded Initialization Vector (IV) of exactly the block size, or "" for ECB mode.

nOptions

[in] Option flags: zero (0) for default options.

Returns (VBA/C)

Non-zero handle of the CIPHER context, or zero if an error occurs.

.NET Equivalent

Cipher.InitEncrypt Method (String, String, CipherAlgorithm, Mode)
Cipher.InitDecrypt Method (String, String, CipherAlgorithm, Mode)

Remarks

This function is the equivalent of CIPHER_Init except it passes the key and IV parameters as hexadecimal-encoded strings.

Example

See CIPHER_UpdateHex.

See Also

CIPHER_Init

[Contents] [Index]