RGLRFIDErrorCodes

This page covers the description of the RGLRFIDErrorCodes enumeration

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