--- title: "AAL2DPXGetStaticVector" slug: "a3s-cppprg-aal2dpxgetstaticvector-4-0" updated: 2026-11-11T10:02:33Z published: 2026-11-11T10:02:33Z canonical: "docs.onespan.com/a3s-cppprg-aal2dpxgetstaticvector-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. # AAL2DPXGetStaticVector ## Function prototype ```cpp aat_int32 AAL2DPXGetStaticVector(                                  TDPXHandle*     dpx_Handle,                                  TKernelParms*   CallParms,                                  aat_ascii*      StaticVector,                                  aat_int32*      StaticVectorLength); ``` ## Description This function is used to retrieve the static vector (if present) from a DPX file, which holds the parameter settings necessary for activation of a certain category of Digipass devices: - Software Digipass authenticators compliant with the standard activation (in the context of single 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 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). In case of standard activation, the static vector is used by AALGenActivationCodeEx, AALGenActivationCodeXErc or AALGenActivationDataRndKey to generate activation data. In case of multi-device activation, the static vector is used by AAL2GenMessageActivation1 and AAL2GenMessageActivation2 to generate activation messages. AAL2DPXGetStaticVector must be called after AAL2DPXInit and before one of the following functions: - AAL2DPXGetToken - AAL2DPXGetTokenBLOBs - AAL2DPXGetTokenBLOBsEx, or - AAL2DPXGetTokenBLOBsEx2 The output static vector is a string of up to 4094+1 characters 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 * | StaticVector | O | String of up to 4094 +1 characters, null-terminated. This parameter holds the static vector to use with the software tokens. (StaticVector buffer must have at least 4095 bytes allocated). | | aat_int32 * | StaticVectorLen | I/O | In input, this parameter must indicate the size of the allocated buffer for the StaticVector parameter (recommended 4095 bytes). In output, this parameter indicates the length of the StaticVector 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 | -1520 | Invalid SV in DPX | | -1502 | Handle context is pointer null | -1521 | Invalid static vector length | | -1503 | Handle key is pointer null | -1522 | Output buffer pointer is null |