--- title: "AAL2DPXGetMessageVector" slug: "a3s-cppprg-aal2dpxgetmessagevector-4-0" updated: 2026-11-11T10:02:33Z published: 2026-11-11T10:02:33Z canonical: "docs.onespan.com/a3s-cppprg-aal2dpxgetmessagevector-4-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # AAL2DPXGetMessageVector ## Function prototype ```cpp 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](/secsdks/docs/a3s-product-guide-4-0). - 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](/secsdks/docs/a3s-product-guide-4-0). 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 | Type | Name | Use | Description | | --- | --- | --- | --- | | TDPXHandle * | dpx_Handle | I/O | Pointer to the handle used during the DPX file import operation. This block must be the one initialized by the AAL2DPXInit function. | | TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. | | aat_ascii * | MessageVector | O | String of 26+1 characters, null-terminated containing the message vector to use for all messages that will be generated by Authentication Suite Server SDK related to a license of the imported DPX file. | | aat_int32 * | MessageVectorLen | I/O | In input, this parameter must indicate the size of the allocated buffer for the MessageVector parameter (recommended 27 bytes). In output, this parameter indicates the length of the MessageVector string (without the null-terminated character). | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | -1504 | Invalid handle context eyecatcher | | -1500 | Cannot allocate memory | -1505 | Invalid handle key eyecatcher | | -1501 | Handle pointer is null | -1522 | Output buffer pointer is null | | -1502 | Handle context is pointer null | -1535 | Invalid message vector in DPX | | -1503 | Handle key is pointer null | -1536 | Invalid message vector length |