AAL2DPXGetMessageVector

Function prototype

aat_int32 AAL2DPXGetMessageVector(
                                  TDPXHandle*     dpx_Handle,
                                  TKernelParms*   CallParms,
                                  aat_ascii*      MessageVector,
                                  aat_int32*      MessageVectorLength);

Description

This function is used to retrieve the message vector (if present) from a DPX file. It holds the message parameters settings necessary for message generation applicable with a certain category of Digipass devices:

• Software or hardware Digipass authenticators compliant with the multi-device activation (in the context of multi-device licensing). For more information, refer to the Authentication Suite Server SDK Product Guide.
• Software or hardware Digipass authenticators able to perform operations based on the Secure Channel protocol. For more information, refer to the Authentication Suite Server SDK Product Guide.

The message vector is used by:

• AAL2GenPayloadKeyBLOB, AAL2GenMessageActivation1, AAL2GenMessageActivation2, and AAL2GenMessageDeactivation to generate multi-device activations.
• AAL2GenMessageRequest to generate Secure Channel messages.

AAL2DPXGetMessageVector must be called after AAL2DPXInit and before AAL2DPXGetTokenBLOBsEx or AAL2DPXGetTokenBLOBsEx2.

The output message vector is a 26+1 character string ending with the null character.

Parameters

Return codes