--- title: "AAL2GenSignature" slug: "a3s-cppprg-hsm-aal2gensignature-4-0" updated: 2026-11-11T10:00:40Z published: 2026-11-11T10:00:40Z canonical: "docs.onespan.com/a3s-cppprg-hsm-aal2gensignature-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. # AAL2GenSignature ## Function prototype ```cpp aat_int32 AAL2GenSignature( TDigipassBlob* DPData, TKernelParms* CallParms, aat_ascii* Password, aat_ascii SignedDataFields[8][20], aat_int32 FieldCount, aat_int32 DeferrecSignatureDate); ``` ## Description If primary Virtual Mobile Authenticator is supported and activated for the given authenticator application BLOB, this function can be used to generate an e-signature. ## Parameters | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | DPData | I/O | 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_ascii * | Signature | O | String of up to 17 numeric or hexadecimal characters, left-justified, null-terminated, or right-padded with spaces. This is the dynamic password generated by the library (recommended buffer size is 18 bytes). | | aat_ascii * | SignedDataFields | I | Array of 8 left-justified, null-terminated, or space-padded strings of max. 20 characters. This parameter holds the 8 possible data fields that are entered into the Digipass authenticator to generate a signature. Digipass data fields are limited to 16 decimal, hexadecimal, or alphabetic characters. | | aat_int32 | FieldCount | I | Numeric value from 1 to 8 indicating the number of data fields to use from the aSignedDataFieldsIn array. | | aat_int32 | Deferred signature date | I | - Must be 0 if signature is generated in online mode (OnlineSG=1 or 2). - If signature is generated in offline mode with OnlineSG=0 or 3, this parameter can receive the date for the signature generation (number of elapsed seconds since January 1st 1970) or 0 (with 0, the current time is used). | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 1000 | Function does not support EMV-CAP | | 132 | Unsupported token type | 1103 | Unlock Version 2 not supported | | 139 | Invalid signature pointer | 1104 | Virtual token is not a primary token | | 141 | Invalid field count | 1116 | Response check digit not allowed | | 148 | Invalid data field pointer | 1117 | Challenge check digit not allowed | | 203 | Sign error threshold reached | 1118 | Unsupported BLOB | | 207 | Deferred signature not allowed with OnLineSG not Null | -101 | Challenge too short | | 208 | Application disabled | -102 | Challenge too long | | 209 | Grace period expired | -103 | Challenge check digit wrong | | 210 | Allowed use count reached | -105 | Challenge minimum length not allowed | | 211 | Virtual token not supported | -106 | Challenge maximum length not allowed | | 412 | Invalid checksum | -107 | Challenge number wrong | | 413 | Invalid Base64 format | -108 | Challenge character invalid | | 510 | Invalid Digipass data pointer | -1501 | Memory allocation failed |