AAL2DPXGetStaticVector
  • 22 Jan 2025
  • 1 Minute à lire
  • Sombre
    Lumière
  • PDF

AAL2DPXGetStaticVector

  • Sombre
    Lumière
  • PDF

The content is currently unavailable in French. You are viewing the default English version.
Résumé de l’article

Function prototype

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.
  • Software or hardware Digipass authenticators compliant with the multi-device activation (in the context of multi-device licensing). For more information, refer the Authentication Suite Server SDK Product Guide.

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

  Table: Parameters (AAL2DPXGetStaticVector)
TypeNameUseDescription
TDPXHandle *dpx_HandleI/OPointer to the handle used during the DPX file import operation. This block must be the one initialized by the AAL2DPXInit function.
TKernelParms *CallParmsIStructure of runtime parameters to use during this function call.
aat_ascii *StaticVectorO

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 *StaticVectorLenI/OIn 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

  Table: Return codes (AAL2DPXGetStaticVector)
CodeMeaningCodeMeaning
0Success-1504Invalid handle context eyecatcher
-1500Cannot allocate memory-1505Invalid handle key eyecatcher
-1501Handle pointer is null-1520Invalid SV in DPX
-1502Handle context is pointer null-1521Invalid static vector length
-1503Handle key is pointer null-1522Output buffer pointer is null

Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle