AEAD_SetNonce

CryptoSys API Library Manual

Set the nonce (in incremental mode).


Public Declare Function AEAD_SetNonce Lib "diCryptoSys.dll" (ByVal hContext As Long, ByRef lpNonce As Byte, ByVal nNonceLen As Long) As Long

nRet = AEAD_SetNonce(hContext, abNonce(0), nNonceLen)


long __stdcall  AEAD_SetNonce(long hContext, const unsigned char *lpNonce, long nNonceLen);

hContext: [in] handle to the AEAD context set up by an earlier call to AEAD_InitKey.
lpNonce: [in] containing the nonce of exact length for the given algorithm (currently always 12 bytes).
nNonceLen: [in] equal to length of the nonce in bytes.

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

Must be followed by zero or more calls to AEAD_AddAAD and then either AEAD_StartEncrypt or AEAD_StartDecrypt. Returns MISUSE_ERROR if called out of sequence.

See the example in AEAD_InitKey.