AAL2GetTokenInfo

Prev Next

Function prototype

aat_int32 AAL2GetTokenInfo (TDigipassBlob*   DPData,
                            TKernelParms*    CallParms,
                            TDigipassInfo*   DPInfo);

Description

This function is used to translate various authenticator application BLOB internal values into a readable format. These values may be used to display Digipass information to the administrator, or to trigger application behavior based on a specific Digipass-internal programming scheme.

The field ResponseLength of TDigipassInfo structure corresponds to the length of the response configured for the application and including the static PIN, if any.

Parameters

  Table: Parameters (AAL2GetTokenInfo)
TypeNameUseDescription
TDigipassBlob *DPDataIauthenticator application BLOB.
TKernelParms *CallParms IStructure of runtime parameters to use during this function call.
TDigipassInfo *DPInfoODigipass information return block. Upon return from the function call, this block contains useful information extracted from the TDigipassBlob data structure. The information is returned in zero-delimited strings.

Return codes

  Table: Return codes (AAL2GetTokenInfo)
CodeMeaningCodeMeaning
0Success514Invalid Digipass info pointer
412Invalid checksum1118Unsupported BLOB
413Invalid Base64 format-1501Memory allocation failed
510Invalid Digipass data pointer