AAL2ResetTokenInfo

Prev Next

Function prototype

aat_int32 AAL2ResetTokenInfo (TDigipassBlob*   DPData,
                              TKernelParms*    CallParms);

Description

This function is used to reset the error counter. If the IThreshold or SThreshold runtime parameters are used and greater than zero during calls of AAL2VerifyPassword or AAL2VerifySignature, the current authenticator application BLOB error counter is checked to see if it is greater than or equal to the given threshold value. If it is, AAL2VerifyPassword and AAL2VerifySignature return 202 or 203. This function will reset the internal authenticator application BLOB error counter to zero.

After a call to AAL2ResetTokenInfo, the synchronization time window will be used for the following password (or signature) validation.

Parameters

  Table: Parameters (AAL2ResetTokenInfo)
TypeNameUseDescription
TDigipassBlob *DPDataI/Oauthenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
TKernelParms *CallParmsIStructure of runtime parameters to use during this function call.

Return codes

  Table: Return codes (AAL2ResetTokenInfo)
CodeMeaningCodeMeaning
0Success1103Unlock Version 2 not supported
412Invalid checksum1118Unsupported BLOB
413Invalid Base64 format-1501Memory allocation failed
510Invalid Digipass data pointer