AEAD_StartDecrypt

CryptoSys API Library Manual

AEAD_StartDecrypt

Start authenticated decryption (in incremental mode).

VBA/VB6 Syntax


Public Declare Function AEAD_StartDecrypt Lib "diCryptoSys.dll" (ByVal hContext As Long, ByRef lpTagToCheck As Byte, ByVal nTagLen As Long) As Long

nRet = AEAD_StartDecrypt(hContext, abTagToCheck(0), nTagLen)

C/C++ Syntax


long __stdcall  AEAD_StartDecrypt(long hContext, const unsigned char *lpTagToCheck, long nTagLen);

Parameters

hContext: [in] handle to the AEAD context set up by an earlier call to AEAD_InitKey.
lpTagToCheck: [in] byte array containing the tag to be checked.
nTagLen: [in] equal to length of the tag in bytes.

Returns (VBA/C)

If successful, the return value is zero; otherwise it returns a nonnegative error code.

.NET Equivalent

Aead.StartDecrypt Method

Remarks

May be followed by zero or more calls to AEAD_Update to decrypt data in chunks. Must eventually be followed by AEAD_FinishDecrypt. Returns MISUSE_ERROR if called out of sequence. Caution: do not trust decrypted data until final authentication.

Example

See the example in AEAD_InitKey.

[Contents] [Index]

[PREV: AEAD_SetNonce...] [Contents] [Index]

[NEXT: AEAD_StartEncrypt...]