AAL2GenResetStaticPasswordCmd

  • Published on Jul 9, 2025
  • 1 minute(s) read
Prev Next

Function prototype

aat_int32 AAL2GenResetStaticPasswordCmd(
                                        aat_byte           *Cmd,
                                        aat_int32          *CmdSize,
                                        TDigipassBlob      *DPData,
                                        TKernelParms       *CallParms);

Description

This function creates a command that directs the HSM to reset the static password using the given data and to return a result in the form of a reply.

The Digipass static PIN management on the HSM is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Management Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.

This function must be used with the post-HSM API AAL2ProcResetStaticPasswordRpl.

Parameters

  Table: Parameters (AAL2GenResetStaticPasswordCmd)
TypeNameUseDescription
aat_byte *CmdO

282 bytes that serialize the RESET STATIC PASSWORD command type and the input data to the reset static password function on the HSM:

  • Command type - 2 bytes
  • An authenticator application BLOB - 192 bytes
  • Runtime parameters - 80 bytes

Plus 8 bytes for Authentication Suite Server SDK internal use.

aat_int32 *CmdSizeI/O

On entry, this parameter contains the size of the Cmd buffer.On exit, this parameter contains the length of the Cmd message.

TDigipassBlob *DPDataIauthenticator application BLOB.
TKernelParms *CallParmsI

Structure of runtime parameters to use during this function call.

Return codes

  Table: Return codes (AAL2GenResetStaticPasswordCmd)
CodeMeaningCodeMeaning
0Success706Invalid data buffer pointer
412Invalid checksum (software)1000Function does not support EMV-CAP
413Invalid Base64 format1018Invalid TLV item pointer
510Invalid Digipass data pointer1025Data buffer too small
590Invalid command pointer