--- title: "AAL2GetTokenInfoEx" slug: "a3s-cppprg-aal2gettokeninfoex-4-0" updated: 2026-11-11T09:57:24Z published: 2026-11-11T09:57:24Z canonical: "docs.onespan.com/a3s-cppprg-aal2gettokeninfoex-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. # AAL2GetTokenInfoEx ## Function prototype ```cpp aat_int32 AAL2GetTokenInfoEx (TDigipassBlob *DPData, TKernelParms *CallParms, TDigipassInfoEx *DPInfo); ``` ## Description This function provides special, authenticator-specific operations. With this function, it is possible to extend the returned information list without changing the prototype definition. This function is deprecated and can be replaced by AAL2GetTokenProperty, which is easier to manage. ## Parameters | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | DPData | I | authenticator application BLOB. | | TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. | | TDigipassInfoEx * | DPInfo | I/O | Extended information structure. For more information, refer to [TDigipassInfoEx](/secsdks/docs/a3s-cppprg-tdigipassinfoex-4-0). | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 514 | Invalid Digipass info pointer | | 412 | Invalid checksum | 518 | Invalid property | | 413 | Invalid Base64 format | 1118 | Unsupported BLOB | | 510 | Invalid Digipass data pointer | -1501 | Memory allocation failed | ## Example ```cpp TData *DPInfo; TDigipassInfoEx *GenDPInfo; char tokenchar token_blobRO[24 + 224 ] = "0097123456APPL 1 10AFIAAAEAAAAAA AAAAAAAAAAAAAAAAAAAAAAAMAAEAAAAgICAAAAC x4bwOmbuF3T0+lHO9rb9BXnA89lgT9T6477A6cP ///wAAAAAAAAAAAAAAAAAAAAAAAAAA+RmOzmh1l FwAAP//AAAAAERQMzAwAAAAAAAAABYAAAAm843a bbj4K4vdBsXEX0OA"; /* allocate structures for 3 info. */ DPInfo = (TData *) malloc(sizeof(TData) * 3); DPInfo[0].Value = (aat_byte*)malloc(6); DPInfo[0].Size = 0; DPInfo[0].AllocatedSize = 6; DPInfo[0].Type = TOKEN_MODEL; DPInfo[1].Value = (aat_byte*)malloc(4); DPInfo[1].Size = 0; DPInfo[1].AllocatedSize = 4; DPInfo[1].Type = TIME_BASED_ALGO; DPInfo[2].Value = (aat_byte*)malloc(4); DPInfo[2].Size = 0; DPInfo[2].AllocatedSize = 4; DPInfo[2].Type = STATIC_PWD_SUPPORTED; /* create the authentication structure */ GenDPInfo = (TDigipassInfoEx*)malloc(sizeof(TDigipassInfoEx)); GenDPInfo->Info = DPInfo; GenDPInfo->Infos = 3; GenDPInfo->Size = 1; AAL2GetTokenInfoEx(token_blob, 0, GenDPInfo); ``` In addition, requested properties can be retrieved with their integer value instead of an ASCII value. To select the integer value output - Add the flag INT_VALUE to the requested property. For more information, refer to [AAL2GetTokenProperty](/secsdks/docs/a3s-cppprg-aal2gettokenproperty-4-0). AAL2GetTokenInfoEx can return the same properties as AAL2GetTokenProperty.