--- title: "AAL2SetTokenProperty" slug: "a3s-cppprg-aal2settokenproperty-4-0" updated: 2026-11-11T09:54:58Z published: 2026-11-11T09:54:58Z canonical: "docs.onespan.com/a3s-cppprg-aal2settokenproperty-4-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # AAL2SetTokenProperty ## Function prototype ```cpp 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](/secsdks/docs/a3s-cppprg-aal2settokenproperty-4-0#TAB_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 | 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](/secsdks/docs/a3s-cppprg-aal2settokenproperty-4-0#TAB_List_of_properties_for_AAL2SetTokenProperty). | ## Return codes | 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 | | |