This function initiates the import process by opening the DPX file (pFileName), deriving the transport key (InitKey) through the operator key (OperKey) and the administrator key (AdminKey). It returns the number of applications defined in the DPX file, the list of applications names, and the total number of defined Digipass authenticators. AAL2DpxInitEx just adds an operator and admin key that may be added using the Digipass Programmer, which is a similar operating mode to AAL2DPXInit.
Parameters
Table: Parameters (AAL2DPXInitEx)
Type
Name
Use
Description
TDPXHandle *
dpx_Handle
I/O
Pointer to the handle used during the DPX file import operation.
This block must be acquired by the calling application and will be initialized by this function. It must be passed to the AAL2DPXGetToken and AAL2DPXClose functions.
aat_ascii *
pFileName
I
Path to the DPX file to open. Only characters of the 7-bit ASCII printable character set are supported.
aat_ascii *
InitKey
I
A string of 32 or 64 hexadecimal digits representing the DPX file software transport key.
aat_ascii *
OperKey
I
This is a string of 16 hexadecimal digits representing the operator encryption key. In the Digipass Programmer documentation, it is referred to as KEY 1.
aat_ascii *
AdminKey
I
This is a string of 16 hexadecimal digits representing the administrator encryption key. In the Digipass Programmer documentation, it is referred to as KEY 2.
aat_int16 *
appl_count
O
Points to a short integer where the function returns the number of applications described in the DPX file. The application names are listed in the appl_names argument.
aat_ascii *
appl_names
O
Points to a 96 + 1-byte area where the function returns the list of available application names. Each application name has a fixed length of 12 characters, left-aligned and padded with spaces if necessary. The list contains a maximum of 8 application names (recommended buffer size is 97 bytes).
aat_int16 *
token_count
O
Points to a short integer where the function returns the number of Digipass authenticators contained in this DPX file.
Return codes
Table: Return codes (AAL2DPXInitEx)
Code
Meaning
Code
Meaning
0
Success
-103
Error DH created by content
-10
Error null pointer
-200
Error DC HSH content
-11
Error bad argument
-201
Error DC DEL content
-12
Error DPX clear failed
-203
Error DEL value
-13
Error DES calculation
-300
Error DF field name
-14
Error InitKey length
-301
Error DF descriptor
-15
Error InitKey value
-400
Error DA record
-20
Error file open failed
-501
Error Digipass descriptor
-22
Error file rewind failed
-502
Error Digipass unknown descriptor
-23
Error file not open
-800
Error CT field type
-24
Error file not closed
-900
Error DE DEF records content
-30
Error fatal error
-901
Error DE data records content
-32
Error too many errors
-902
Error DE tokens content
-40
Error void text
-1500
Cannot allocate memory
-42
Error no DF records
-1501
Handle pointer is null
-45
Error unexpected content
-1508
InitKey pointer is null
-46
Error line exhausted
-1509
File name pointer is null
-47
Error missing quotes
-1511
Application count pointer is null
-48
Error missing field name
-1512
Application name pointer is null
-49
Error bad field name
-1513
Token count pointer is null
-50
Error bad field type
-1523
Invalid response length with Digipass algorithm in DPX
-51
Error field size
-1524
Invalid return host code length with Digipass algorithm in DPX
-100
Error DH file content
-1532
Invalid time step with OCRA
-101
Error DH date content
-1533
Invalid response or host code length in DPX
-102
Error DH version content
Cet article vous a-t-il été utile ?
Merci pour vos commentaires! Notre équipe vous répondra
