This function is deprecated! It does not support the new AES-encrypted DPX files introduced in Authentication Suite 4.0.
Function prototype
aat_int32 AAL2DPXInitEx( TDPXHandle* dpx_Handle,
aat_ascii* pFileName,
aat_ascii* InitKey,
aat_ascii* OperKey,
aat_ascii* AdminKey,
aat_int16* appl_count,
aat_ascii* appl_names,
aat_int16* token_count);
Description
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 | | |