cipherEncryptBytes

CryptoSys PKI Pro Manual

cipherEncryptBytes

Encrypt data in a byte array using the specified block cipher algorithm, mode and padding. The key and initialization vector are passed as byte arrays.

Syntax

[VBA]

Public Function cipherEncryptBytes ( _
    lpInput() As Byte, _
    lpKey() As Byte, _
    lpIV() As Byte, _
    szAlgModePad As String, _
    Optional nOptions As Long = 0 _
) As Byte()

Parameters

lpInput

Input data to be encrypted.

lpKey

Key of exact length for block cipher algorithm.

lpIV

Initialization Vector (IV) of exactly the block size, empty array for ECB mode, or 12 bytes for AES-GCM.

szAlgModePad

String with block cipher algorithm, mode and padding, e.g. "aes128/cbc/pkcs5"

Alg:  aes128|aes192|aes256|tdea|3des|desede3
Mode: ecb|cbc|ofb|cfb|ctr|gcm
Pad:  pkcs5|nopad|oneandzeroes|ansix923|w3c

nOptions

Add PKI_IV_PREFIX to prepend the IV before the ciphertext in the output (ignored for ECB mode).

Return Value

Byte(): Ciphertext in byte array or empty array on error.

Remarks

Default padding is Pkcs5 for ECB and CBC mode and NoPad for all other modes. GCM mode is only available with AES. The IV must be exactly 12 bytes long for GCM.

[PREV: cipherEncryptAEAD...] [Contents] [Index]

[NEXT: cipherEncryptHex...]