--- title: "AAL2ChangeStaticPassword" slug: "a3s-cppprg-aal2changestaticpassword-4-0" updated: 2026-11-11T10:02:33Z published: 2026-11-11T10:02:33Z canonical: "docs.onespan.com/a3s-cppprg-aal2changestaticpassword-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. # AAL2ChangeStaticPassword ## Function prototype ```cpp aat_int32 AAL2ChangeStaticPassword ( TDigipassBlob* DPData, TKernelParms* CallParms, aat_ascii* NewStaticPassword1, aat_ascii* NewStaticPassword2); ``` ## Description This function is used with a Digipass authenticator that can use static passwords (e.g. Digipass GO 1). It allows administrators to provide a new static password on a mandatory basis. As this function is critical, only an authenticated user should be able to use it. For a list of the characters that can be used for the new static password, see [Supported new static password charset](/secsdks/docs/a3s-cppprg-aal2changestaticpassword-4-0#supported-new-static-password-charset). ## 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 * | NewStaticPassword1 | I | First entry of the password change trial. Up to 8 printable ASCII-EBCDIC invariant characters. Must be null-terminated. For a list of the characters that can be used for the new static password, see [Supported new static password charset](/secsdks/docs/a3s-cppprg-aal2changestaticpassword-4-0#supported-new-static-password-charset). | | aat_ascii * | NewStaticPassword2 | I | Second entry confirmation of the password change trial. Must be identical to NewStaticPassword1. | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 804 | New password too long | | 130 | Invalid response pointer | 805 | Password not equal | | 412 | Invalid checksum software | 1000 | Function does not support EMV-CAP | | 413 | Invalid Base64 format | 1103 | Unlock Version 2 not supported | | 510 | Invalid Digipass data pointer | 1118 | Unsupported BLOB | | 801 | Static password not supported | -1501 | Memory allocation failed | | 803 | New password too short | | | ## Supported new static password charset The following table lists the supported characters for the data fields of AAL2ChangeStaticPassword with associated hexadecimal values in ASCII and EBCDIC. | Character | Hex ASCII value | Hex EBCDIC value | Character | Hex ASCII value | Hex EBCDIC value | | --- | --- | --- | --- | --- | --- | | ! | 0x21 | 0x5A | P | 0x50 | 0xD7 | | “ | 0x22 | 0x7F | Q | 0x51 | 0xD8 | | # | 0x23 | 0x7B | R | 0x52 | 0xD9 | | $ | 0x24 | 0x5B | S | 0x53 | 0xE2 | | % | 0x25 | 0x6C | T | 0x54 | 0xE3 | | & | 0x26 | 0x50 | U | 0x55 | 0xE4 | | ' | 0x27 | 0x7D | V | 0x56 | 0xE5 | | ( | 0x28 | 0x4D | W | 0x57 | 0xE6 | | ) | 0x29 | 0x5D | X | 0x58 | 0xE7 | | * | 0x2A | 0x5C | Y | 0x59 | 0xE8 | | + | 0x2B | 0x4E | Z | 0x5A | 0xE9 | | , | 0x2C | 0x6B | [ | 0x5B | 0xAD | | - | 0x2D | 0x60 | \ | 0x5C | 0xE0 | | . | 0x2E | 0x4B | ] | 0x5D | 0xBD | | / | 0x2F | 0x61 | ^ | 0x5E | 0x5F | | 0 | 0x30 | 0xF0 | _ | 0x5F | 0x6D | | 1 | 0x31 | 0xF1 | ` | 0x60 | 0x79 | | 2 | 0x32 | 0xF2 | a | 0x61 | 0x81 | | 3 | 0x33 | 0xF3 | b | 0x62 | 0x82 | | 4 | 0x34 | 0xF4 | c | 0x63 | 0x83 | | 5 | 0x35 | 0xF5 | d | 0x64 | 0x84 | | 6 | 0x36 | 0xF6 | e | 0x65 | 0x85 | | 7 | 0x37 | 0xF7 | f | 0x66 | 0x86 | | 8 | 0x38 | 0xF8 | g | 0x67 | 0x87 | | 9 | 0x39 | 0xF9 | h | 0x68 | 0x88 | | : | 0x3A | 0x7A | i | 0x69 | 0x89 | | ; | 0x3B | 0x5E | j | 0x6A | 0x91 | | < | 0x3C | 0x4C | k | 0x6B | 0x92 | | = | 0x3D | 0x7E | l | 0x6C | 0x93 | | > | 0x3E | 0x6E | m | 0x6D | 0x94 | | ? | 0x3F | 0x6F | n | 0x6E | 0x95 | | @ | 0x40 | 0x7C | o | 0x6F | 0x96 | | A | 0x41 | 0xC1 | p | 0x70 | 0x97 | | B | 0x42 | 0xC2 | q | 0x71 | 0x98 | | C | 0x43 | 0xC3 | r | 0x72 | 0x99 | | D | 0x44 | 0xC4 | s | 0x73 | 0xA2 | | E | 0x45 | 0xC5 | t | 0x74 | 0xA3 | | F | 0x46 | 0xC6 | u | 0x75 | 0xA4 | | G | 0x47 | 0xC7 | v | 0x76 | 0xA5 | | H | 0x48 | 0xC8 | w | 0x77 | 0xA6 | | I | 0x49 | 0xC9 | x | 0x78 | 0xA7 | | J | 0x4A | 0xD1 | y | 0x79 | 0xA8 | | K | 0x4B | 0xD2 | z | 0x7A | 0xA9 | | L | 0x4C | 0xD3 | ( | 0x7B | 0xC0 | | M | 0x4D | 0xD4 | \| | 0x7C | 0x4F | | N | 0x4E | 0xD5 | ) | 0x7D | 0xD0 | | O | 0x4F | 0xD6 | ~ | 0x7E | 0xA1 |