AAL2SetTokenProperty

Mis à jour le 22 Jan 2025
1 Minute à lire

Partager
Sombre
Lumière
PDF

The content is currently unavailable in French. You are viewing the default English version.

Résumé de l’article

Avez-vous trouvé ce résumé utile ?

Merci pour vos commentaires

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

Cet article vous a-t-il été utile ?

What's Next

AAL2SyncTokenAndHost

Table des matières

Function prototype
Description
Parameters
Return codes