This function processes a reply from the HSM to a request message generation command which has been generated with AAL2GenGenMessageRequestCmd.
The request message generation 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.
Parameters
Table: Parameters (AAL2ProcGenMessageRequestRpl)
Type
Name
Use
Description
aat_byte *
InReply
I
Up to 1092 bytes that contain the REQUEST MESSAGE GENERATION command type and the output data from the request message generation function on the HSM:
Command type - 2 bytes
Request Message - 1070 characters
Request Message 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 *
RequestMessage
O
A string of up to 1070+1 hexadecimal characters, null-terminated. In case of a successful operation, this parameter contains the generated RequestMessage.
aat_int32 *
RequestMessageLength
I/O
In input, this parameter must indicate the size of the allocated buffer for the RequestMessage parameter (recommended 1071 bytes).
In output, this parameter indicates the length of the RequestMessage string (without the null-terminated character).
