Function prototype
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.
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. |
| aat_ascii * | NewStaticPassword2 | I | Second entry confirmation of the password change trial. Must be identical to NewStaticPassword1. |
Return codes
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.