--- title: "AAL2MXGenAuthCar" slug: "a3s-cppprg-aal2mxgenauthcar-4-0" updated: 2026-11-11T09:57:24Z published: 2026-11-11T09:57:24Z canonical: "docs.onespan.com/a3s-cppprg-aal2mxgenauthcar-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. # AAL2MXGenAuthCar ## Function prototype ```cpp aat_int32 AAL2MXGenAuthCar ( TDigipassBlob* MXCardBlob, TKernelParms* CallParms, aat_int32 MXCardSequenceNumber, aat_int32 RowIndex, aat_int32 ColumnIndex, aat_ascii* UserAuthChar, aat_ascii* HostAuthChar); ``` ## Description This function generates the content of matrix card cells and the associated return host code based on the matrix card BLOB. ## Parameters | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | MXXCardBlob | I/O | Matrix Card 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 | MXCard Sequence Number | I | Sequence number of the matrix card on up to four digits. | | aat_int32 | RowIndex | I | Index of the matrix card cell row. | | aat_int32 | ColumnIndex | I | Index of the matrix card cell column. | | aat_ascii * | UserAuthChar | O | User authentication character. This is the content of the matrix card cell. Its length is determined by the response length field in MXCardBlob (recommended buffer size is 18 bytes). | | aat_ascii * | HostAuthChar | O | Host authentication character. Optionally given in the matrix card cell. Its length is determined by HostKeyDataLength in the BLOB (recommended buffer size is 18 bytes). | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 1116 | Response check digit not allowed | | 132 | Unsupported token type | 1117 | Challenge check digit not allowed | | 211 | Virtual token not supported | 1118 | Unsupported BLOB | | 412 | Invalid checksum | -101 | Challenge too short | | 413 | Invalid Base64 format | -102 | Challenge too long | | 510 | Invalid Digipass data pointer | -103 | Challenge check digit wrong | | 560 | Null output buffer | -105 | Challenge minimum length not allowed | | 561 | Invalid matrix card sequence number | -106 | Challenge maximum length not allowed | | 562 | Invalid row number | -107 | Challenge number wrong | | 563 | Invalid column number | -108 | Challenge character invalid | | 1000 | Function does not support EMV-CAP | -1501 | Memory allocation failed | | 1103 | Unlock Version 2 not supported | | |