This function processes a reply from the HSM to a response message processing command which has been generated with AAL2GenProcMessageResponseCmd.
If the response message was correctly processed and contains a Secure Channel request error that is detected by the device, the return code is dependent on the Secure Channel request error code byte (return code = offset + code byte with offset = 5000). See the list of return codes in Table: Return codes (AAL2ProcProcMessageResponseRpl) for more details.
The response message processing on the HSM is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Secure Channel Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.
This function serializes an important amount of data. The InReply buffer must be allocated with a sufficient size. For more information about the allocation of the Cmd and InReply buffers, refer to Cmd and InReply buffers allocation.
Up to 1046 bytes that contain the RESPONSE MESSAGE PROCESSING command type and the output data from the response message processing function on the HSM:
Command type - 2 bytes
Response Body - 1024 characters
Response Body Length - 4 bytes
Return code - 4 bytes
Plus 12 bytes for Authentication Suite Server SDK internal use.
aat_int32
ReplySize
I
The length of the InReply message.
aat_ascii *
ResponseBody
O
String of up to 1024+1 hexadecimal characters, null-terminated. In case of a successful operation, this parameter contains the clear response body extracted from the ResponseMessage.
aat_int32 *
ResponseBodyLength
I/O
In input, this parameter must indicate the size of the allocated buffer for the ResponseBody parameter (recommended are 1025 bytes).
In output, this parameter indicates the length of the RequestBody string (without the null-terminated character).