Skip to content

RGLRFIDErrorCodes

RGLRFIDErrorCodes enumeration contains a set of error codes returned by the MCL functions or transferred to the user application by the callback-function:

Constant Description
NoError successful operation
AlreadyDone requested operation has already been performed
Failed error of operation execution (common case)
NoChipDetected RFID-chip is absent in the scope of the reader
NotAvailable requested operation unavailable
InvalidParameter incorrect command parameter
NotInitialized SDK control library was not initialized
NotEnoughMemory insufficient memory for command execution
InvalidDirectory incorrect directory name
UnknownCommand unknown command
FileIOError file input/output error
Busy SDK control library is busy. Execution of the command is impossible
OldFirmware it is required to update reader’s firmware
PCSCFailed error of command of data exchange with RFID-chip execution (common case)
PCSCReaderNotAvailable RFID-chip reader unavailable
PCSCCantConnectCard failed to connect with RFID-chip
PCSCCardIsNotConnected no active RFID-chip
PCSCOperationCancelled data reading operation cancelled by the user
PCSCCardIsBusy data exchange with RFID-chip takes place. Execution of the command is impossible
PCSCFailedSCard error of SCard service when data exchanging with RFID-chip
PCSCExtLeFailed error of executing command of extended length reading. Full reinitialization of RFID-chip is required
Layer6SecurityManager secure communication channel organization is required to access data
Layer6AppSelectionFailure error of executing APDU-command of Master File or application selection
Layer6MutualAuthMacFail error of the cryptogram checksum validation during BAC procedure
Layer6MutualAuthEncFail error of the cryptogram validation during BAC
Layer6MutualAuthFailure

one of the errors of the APDU-commands:

  • Mutual Authenticate - performing the BAC
  • General Authenticate - at the 4th step of PACE performance
  • General Authenticate - performing the CA
Layer6MutualAuthFailureData
Layer6SmDo8eMissing absence of the checksum in the protected APDU-response from the RFID-chip (SM '8E' data object)
Layer6SmDo87Missing absence of the data padding object in the protected APDU-response from the RFID-chip (SM '87' data object)
Layer6SmDo99Missing absence of the command execution status in the protected APDU-response from the RFID- chip (SM '99' data object)
Layer6SmMacIncorrect error of the checksum validation of the protected APDU-response from the RFID-chip
Layer6SmDo87Incorrect incorrect contents of the data padding object in the protected APDU-response from the RFID-chip (SM '87' data object)
Layer6NonTlvResponseData response to Read Binary APDU-command, using 'B1' parameter for file data reading with an offset >32767, is not represented in the TLV-format
Layer6WrongRndIccLength incorrect length of the data received as a result of Get Challenge APDU-command execution
Layer6IntAuthFailure error of _Internal Authenticate _APDU-command execution when performing AA procedure
Layer6MseSetKatFailure error of MSE:Set KAT APDU-command execution when performing CA procedure, version 1
Layer6MseSetDstFailure error of MSE:Set DST APDU-command execution when performing TA procedure
Layer6PsoCertificateFailure error of PSO:Verify Certificate APDU-command execution when performing TA procedure
Layer6MseSetAtFailure

error of MSE:Set AT APDU-command execution when performing the procedures:

  • PACE
  • TA
  • CA
  • RI
Layer6GetChallengeFailure error of Get Challenge APDU-command execution
Layer6ExtAuthFailure error of _External Authenticate _APDU-command execution when performing TA procedure
Layer6GeneralAuthFailure error of _General Authenticate _APDU-command execution when performing PACE procedure at steps 1-3
Layer6FileNotFound file not found
Layer6FileEof1 attempt of reading outside the end of the file
Layer6FileEof2 attempt of reading outside the file end of the
Layer6IncorrectParams error of the execution of MSE:Set AT (variants of appearance – see RFID_LAYER6_- MSE_SET_AT_- FAILURE _description) or _General Authenticate (variants of appearance – see _RFID_LAYER6_- GENERAL_AUTH_- FAILURE _description).
Layer6NoReferenceData unavailable data, pointed to by the APDU-command parameters
Layer6PwdSuspend error of the execution of MSE:Set AT (when performing PACE) or General Authenticate (variants of appearance are analogue to _RFID_LAYER6_GE- NERAL_AUTH_ FAILURE). _It means that the selected password is suspended. It is required to perform a procedure of password resuming
Layer6PwdBlocked error of the execution of MSE:Set AT (when performing PACE) or General Authenticate (variants of appearance are analogue to _RFID_LAYER6_GE- NERAL_AUTH_ FAILURE). _It means that the selected password is blocked. It is required to perform a procedure of password unblocking
Layer6PwdDeactivated error of the execution of MSE:Set AT (when performing PACE). It means that the selected password is deactivated. It is required to perform a procedure of password activation
Layer6PwdBlocked2 error of the execution of General Authenticate _APDU-command or commands of work with _eSign application. It means that the selected password is blocked. It is required to perform procedure of password unblocking
Layer6PwdDeactivated2 error of the execution of General Authenticate _APDU-command when performing PACE procedure or commands of work with _eSign application. It means that the selected password is deactivated. It is required to perform procedure of password activation
Layer6PwdSuspend2 error of _General Authenticate _APDU-command execution when performing PACE. It means that the selected password is suspended. It is required to perform procedure of password resuming
Layer6PwdFailed error of the execution of MSE:Set AT when performing PACE procedure or General Authenticate (variants of appearance are analogue to RFID_LAYER6_GENERAL_AUTH_FAILURE ). It means that incorrect password value has been used. Low order 8 bits of code contain the remaining number of attempts for this password. The user application may try to repeat an attempt of performing the required procedure with other values
NotPerformed operation was not performed
SessionIsClosed session closed, operation impossible
SessionTerminalUnsupportedOperation operation is not supported by the current type of terminal
SessionTerminalTypeUnknown unknown type of terminal
SessionTerminalTypeBadCertificate error of reading or analysis of the terminal certificate data
SessionTerminalTypeNotSet terminal type was not defined for the current session
SessionProcedureTypeUnknown unknown authentication procedure type
SessionProcedureTypeUnsupported defined type terminal does not support this type of procedure
SessionProcedureTypeNotSet type of authentication procedure was not set for the current session
SessionAccessKeyUnknownType unknown access key type
SessionAccessKeyUnsupportedSMType unsupported type of secure data access procedure
SessionAccessKeyIncorrectSMType secure data access procedure does not allow to use the given key type
Session_AccessKey_Restricted key type is not supported by the current terminal type, or the rights to its use are insufficient
SessionAccessKeyIncorrectData incorrect key contents (empty or zero string)
SessionAccessKeyNotSet secure data access key was not set for the current session
SessionPwdManagementNotAuthorized operation of password management is not authorized for the current terminal type
SessionAccessControlUnknownType unknown type of the procedure of authentication or secure data access
SessionAccessControlRequiresSM preliminary opening of the secure data access session is required (PACE or BAC)
SessionAccessControlRequiresPACE preliminary opening of the secure data access session is required (PACE)
SessionAccessControlRequiresCAKeys execution of TA preliminary step (for version 2) is required – computing CA ephemeral public keys
SessionAccessControlRequiresTA preliminary TA procedure is required
SessionAccessControlRequiresCA preliminary CA procedure is required
SessionAccessControlIncorrectOptionCA discrepancy between the selected CA variant on the preliminary and main stages
SessionAccessControlCaFailed CA procedure failed
SessionAccessControlTaFailed TA procedure failed
SessionAccessControlAaFailed AA procedure failed
SessionAccessControlRiFailed RI procedure failed
SessionPaSignatureCheckFailed document security object digital signature verification failed
SessionPaHashCheckFailed informational data group integrity verification failed
SessionInvalidAuxDataDateOfExpiry verification of auxiliary data (date of expiry) failed
SessionInvalidAuxDataDateOfBirth verification of auxiliary data (age) failed
SessionInvalidAuxDataCommunityID verification of auxiliary data (Community ID) failed
SessionESignRequiresAppSelection selection of eSign application is required to access its functionality
SessionESignPinNotSet it is required to set the value of eSign-PIN for the current session
SessionESignPinNotVerified it is required to execute verification of _eSign-PIN _for the current session
SessionIncorrectData incorrect session object data
SessionFileNotEnoughData no sufficient data for creation of the file contents ASN.1 object
SessionFileIncorrectData incorrect data of the file contents ASN.1 object
SessionFileUnexpectedData in compliance of the structure of the file contents ASN.1 object with the structure given in the respective specification
SessionFileContentsUnexpectedData in compliance of the structure of the formed ASN.1-objects with the requirements of specification (in the context of specific file)
SessionFileWrongTag incorrect value of the data group tag
SessionFileCantUseData use of the read data is impossible
SessionFileCantReadData error of physical data reading
SessionFileAccessDenied error of access to the protected data groups