Function prototype
aat_int32 AAL2ProcChangeStaticPasswordRpl(
aat_byte *InReply,
aat_int32 ReplySize,
TDigipassBlob *DPData);
Description
This function processes a reply from the HSM to a command generated either with AAL2GenChangeStaticPasswordCmd or AAL2GenChangeStaticPasswordCmdEx.
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 (AAL2ProcChangeStaticPasswordRpl) | Type | Name | Use | Description |
|---|
| aat_byte * | InReply | I | Up to 206 bytes that contain the CHANGE STATIC PASSWORD command type and the output data from the change 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 (AAL2ProcChangeStaticPasswordRpl) | Code | Meaning | Code | Meaning |
|---|
| 0 | Success | 910 | Invalid command type in reply |
| 272 | Invalid wrapped key | 912 | HSM invalid BLOB status |
| 412 | Invalid checksum (software) | 913 | Invalid HSM key property |
| 413 | Invalid Base64 format | 951 | Invalid HSM key type for HSM decryption |
| 414 | Invalid checksum (HSM) | 1009 | Invalid TLV total length |
| 510 | Invalid Digipass data pointer | 1018 | Invalid TLV item pointer |
| 701 | Invalid input buffer pointer | 1019 | Missing mandatory TLV item |
| 801 | Static password not supported | 1025 | Data buffer too small |
| 803 | New password too short | 1103 | Unlock Version 2 not supported |
| 804 | New password too long | 1118 | Unsupported BLOB |
| 805 | Password not equal | | |