Function prototype
aat_int32 AAL2ProcResetStaticPasswordRpl(
aat_byte *InReply,
aat_int32 ReplySize,
TDigipassBlob *DPData);
Description
This function processes a reply from the HSM to a command generated either with AAL2GenResetStaticPasswordCmd or AAL2GenResetStaticPasswordCmdEx.
The Digipass static PIN management on the HSM 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 (AAL2ProcResetStaticPasswordRpl) | Type | Name | Use | Description |
|---|
| aat_byte * | InReply | I | - Up to 206 bytes that contain the RESET STATIC PASSWORD command type and the output data from the reset static password function on the HSM:
- Command type - 2 bytes
- An authenticator application BLOB - 192 bytes
- Return code - 4 bytes
Plus 8 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. |
Return codes
Table: Return codes (AAL2ProcResetStaticPasswordRpl) | Code | Meaning | Code | Meaning |
|---|
| 0 | Success | 912 | HSM invalid BLOB status |
| 272 | Invalid wrapped key | 913 | Invalid HSM key property |
| 412 | Invalid checksum (software) | 951 | Invalid HSM key type for HSM decryption |
| 413 | Invalid Base64 format | 1009 | Invalid TLV total length |
| 414 | Invalid checksum (HSM) | 1018 | Invalid TLV item pointer |
| 510 | Invalid Digipass data pointer | 1019 | Missing mandatory TLV item |
| 701 | Invalid input buffer pointer | 1025 | Data buffer too small |
| 801 | Static password not supported | 1103 | Unlock Version 2 not supported |
| 806 | Static password change not supported | 1118 | Unsupported BLOB |
| 910 | Invalid command type in reply | | |