TDEA_Init

Initialises the context with the key, direction and mode ready for repeated operations of the TDEA function. The key and IV data are provided in byte arrays.

VBA/VB6 Syntax

hContext = TDEA_Init(lpKey(0), bEncrypt, strMode, lpIV(0))

C/C++ Syntax

Parameters

lpKey

[in] containing the key in hexadecimal representation.

fEncrypt

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

szMode

[in] specifying the confidentiality mode:
"ECB" for Electronic Codebook mode,
"CBC" for Cipher Block Chaining mode,
"CFB" for 64-bit Cipher Feedback mode,
"OFB" for Output Feedback mode, or
"CTR" for Counter mode.

lpIV

[in] containing the initialization vector in hexadecimal. Set as zero (0) for ECB mode.

Returns (VBA/C)

Non-zero handle of the context hContext to be used in subsequent calls to the functions TDEA_Update, TDEA_UpdateHex or TDEA_Final. Returns zero if an error occurs.

.NET Equivalent

Tdea.InitEncrypt Method (Byte[], Mode, Byte[])
Tdea.InitDecrypt Method (Byte[], Mode, Byte[])

Remarks

The key lpKey must be exactly 24 bytes long and the IV, if required, exactly 8 bytes long. Unlike most other functions in this API, TDEA_Init returns zero if an error occurs. It is important to check that the value of hContext returned is not equal to zero before calling a TDEA function.

Example

See TDEA_Update.

See Also

TDEA_InitHex TDEA_UpdateHex TDEA_Update TDEA_Final

[Contents] [Index]