SM3GetTag

Computes the current SM3 digest value of the processed part of the message.

Syntax

IppStatus ippsSM3GetTag(Ipp8u* pTag, Ipp32u tagLen, const IppsSM3State* pCtx);

Include Files

ippcp.h

Parameters

pTag

Pointer to the authentication tag.

tagLen

Length of the tag (in bytes).

pCtx

Pointer to the IppsSM3State context.

Description

The function computes the message digest based on the current context as specified in [SM3]. A call to this function retains the possibility to update the digest.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or warning.

ippStsNullPtrErr

Indicates an error condition if any of the specified pointers is NULL.

ippStsLengthErr

Indicates an error condition if tagLen < 1 or tagLen exceeds the maximal length of a particular digest.

ippStsContextMatchErr

Indicates an error condition if the context parameter does not match the operation.