This function processes a reply from the HSM to a command generated with either AAL2GenUnlockCmd or AAL2GenUnlockCmdEx.
Unlocking Digipass with the HSM module is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Management Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.
Parameters
Table: Parameters (AAL2ProcUnlockRepl)
Type
Name
Use
Description
aat_byte *
InReply
I
Up to 218 bytes that contain the UNLOCK command type and the output data from the unlock function on the HSM:
Command type - 2 bytes
An authenticator application BLOB - 192 bytes
Return code - 4 bytes
Unlock code - up to 8 characters
Plus 12 bytes for Authentication Suite Server SDK internal use.
aat_int32 *
ReplySize
I
The length of the InReply message.
TDigipassBlob *
DPData
O
authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
aat_ascii *
aUnlockCodeOut
O
String of 7 or 8 + 1 numeric characters, which the user needs to enter to unlock the Digipass authenticator (recommended buffer size is 9 bytes).
