Function Prototype
aat_int32 AAL2ProcMigratePKBlobRpl(
aat_byte *InReply,
aat_int32 ReplySize,
aat_int32 *PKBlob);
Description
This function processes a reply from the HSM to a command generated with AAL2GenMigratePKBlobCmd or AAL2GenMigratePKBlobCmdEx.
Parameters
Table: Parameters (AAL2ProcMigratePKBlobRpl) | Type | Name | Use | Description |
|---|
| aat_byte * | InReply | I | Up to 82 bytes that contain the MIGRATE BLOB command type and the output data from the migrate BLOB function in the HSM: - Command type - 2 bytes
- PayloadKey BLOB - 72 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. |
| aat_ascii * | PKBlob | O | String of 88+1 characters, null-terminated. Contains the payload key BLOB to migrate. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes. (Recommended buffer size is 89 bytes.) |
Return codes
Table: Return codes (AAL2ProcMigratePKBlobRpl) | Code | Meaning | Code | Meaning |
|---|
| 0 | Success | 917 | Key type inconsistent |
| 272 | Invalid wrapped key | 951 | Invalid HSM key type for HSM decryption |
| 412 | Invalid checksum (software) | 1007 | Invalid TLV tag field |
| 413 | Invalid Base64 format | 1009 | Invalid TLV total length |
| 414 | Invalid checksum (HSM) | 1018 | Invalid TLV item pointer |
| 701 | Invalid input buffer pointer | 1019 | Missing mandatory TLV item |
| 910 | Invalid command type in reply | 1025 | Data buffer too small |
| 911 | HSM invalid key KCV | 1286 | Invalid payload key pointer |
| 913 | Invalid HSM key property | | |