AAL2DPXGetStaticVector

Prev Next

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:

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