Function prototype
aat_int32 AAL2SetTokenProperty (
TDigipassBlob* DPData,
TKernelParms* CallParms,
aat_int32 Property;
aat_int32 Value);
Description
This function can be used to set specific properties as described in Table: List of properties for AAL2SetTokenProperty.
Table: List of properties for AAL2SetTokenProperty | Information | Property | Description |
|---|
| Last time used | LAST_TIME_USED | Integer between 631152000 and 2147483647 Only a time later than the current LAST_TIME_USED can be set. |
| Last time shift | LAST_TIME_SHIFT | Integer between -100000 and 100000 |
| Enable static PIN | PIN_ENABLED | - Value = 1: Enabled
- Value = 2: Disabled
|
| Force PIN change | PIN_CH_FORCED | Value = 1: Force PIN |
| Minimum PIN length | PIN_MIN_LEN | Integer between 3 and 8 |
| Virtual authenticator grace period | VIRTUAL_TOKEN_GRACE_PERIOD | Value = 1 to 364 |
| Virtual authenticator remain use | VIRTUAL_TOKEN_REMAIN_USE | 0 disables the counter Value = 0 to 254 |
| Error count | ERROR_COUNT | Setting is possible (reset only): Value = 0 mandatory |
| Event value | EVENT_VALUE | Only events greater than the current EVENT_VALUE can be set. Integer between 0 and 4294967294 (this value must be cast as aat_int32-signed integer to be compliant with the function prototype). |
| Authenticator status | TOKEN_STATUS | Can be set only; possible values: - 0: Authenticator disabled
- 1: Primary application enabled only
- 2: Backup application enabled only
- 3: Primary and backup enabled
|
Parameters
Table: Parameters (AAL2SetTokenProperty) | Type | Name | Use | Description |
|---|
| TDigipassBlob * | DPData | I/O | This is the authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes. |
| TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. |
aat_int32 | Property | I | Indicates the property to set. |
| aat_int32 | Value | I | Value for the specified property as described in Table: List of properties for AAL2SetTokenProperty. |
Return codes
Table: Return codes (AAL2SetTokenProperty) | Code | Meaning | Code | Meaning |
|---|
| 0 | Success | 518 | Invalid property |
| 412 | Invalid checksum | 806 | Static password change not supported |
| 413 | Invalid Base64 format | 1118 | Unsupported BLOB |
| 510 | Invalid Digipass data pointer | -1501 | Memory allocation failed |
| 517 | Invalid property value | | |