eRFID_NotificationAndErrorCodes

This page covers the description of the eRFID_NotificationAndErrorCodes enumeration

eRFID_NotificationAndErrorCodes enumeration contains a set of notification and error codes returned to the user application by calling the callback-function:

Constant	Description
RFID_NOTIFICATION_ERROR	error
RFID_NOTIFICATION_DOCUMENT_READY	event of appearance of RFID-chip in the scope of the reader antenna or its moving away from the scope of the reader
RFID_NOTIFICATION_READ_PROTOCOL4	event of the beginning/end of data reading from the RFID-chip via ISO/IEC 14443-4 protocol when working in the batch mode
RFID_NOTIFICATION_READ_PROTOCOL3	event of the beginning/end of data reading from the RFID-chip via ISO/IEC 14443-3 protocol.
RFID_NOTIFICATION_PROGRESS	indication of the progress of execution of data reading operation
RFID_NOTIFICATION_TA_STEP	indication of the next step of terminal authentication in Online-authentication mode
RFID_NOTIFICATION_SM_REQUIRED	event of detection of the need to organize a secure communication channel
RFID_NOTIFICATION_ISO_ERROR	event informing the user application on detection of data in compliance processed with the regulations of normative documents, errors when executing the current operation
RFID_NOTIFICATION_PA_REQUEST	request of the user-defined DS-certificate prior to the procedure of digital signature verification of EF.SOD document security object in the batch mode
RFID_NOTIFICATION_SM_ESTABLISHED	event of the result of the opening of a secure communication channel
RFID_NOTIFICATION_PCSC_READER_DISCONNECTED	event of unplugging of the RFID-chip reader
RFID_NOTIFICATION_PCSC_READER_LIST_CHANGED	event of the end of reorganization of the list of RFID-readers, working under PC/SC-driver control
RFID_NOTIFICATION_PCSC_BYTES_RECEIVED	transfer of the total amount of information received from the RFID-chip to the user application during execution of data reading operation
RFID_NOTIFICATION_PCSC_TOTAL_READING_TIME	transfer of the total time of execution of data reading operation to the user application
RFID_NOTIFICATION_PCSC_DATA_RECEIVED	transfer of the total amount of information and service groups data received from the RFID-chip to the user application during execution of data reading operation
RFID_NOTIFICATION_PCSC_BYTES_SENT	transfer of the total amount of information transmitted to the RFID-chip to the user application during execution of data reading operation
RFID_NOTIFICATION_PCSC_TOTAL_READING_SPEED	transfer of the average data reading rate to the user application
RFID_NOTIFICATION_PCSC_TOTAL_PROCESS_TIME	transfer of the total time of execution of data reading procedure to the user application
RFID_NOTIFICATION_PCSC_READER_LIST_CHANGING	event of the beginning of reorganization of the list of RFID-readers, working under PC/SC-driver control
RFID_NOTIFICATION_PCSC_EXT_LENGTH_SUPPORT	event of detection of extended length reading commands support by the RFID-chip
RFID_NOTIFICATION_PA_CERTIFICATE_CHAIN	event of the start/end of the certificate chain formation for the document security object digital signature verification as a part of passive authentication procedure
RFID_NOTIFICATION_PA_CERTIFICATE_CHAIN_ITEM	event that indicates a type of the current analyzed element of the certificate chain being composed
RFID_NOTIFICATION_SCENARIO	a request from the user application of some data or actions in a certain step of the scenario
RFID_NOTIFICATION_PCSC_READING_DATAGROUP	event of the beginning/end of file reading
RFID_NOTIFICATION_PCSC_FILE_NOT_FOUND	event of detection of file absence
RFID_NOTIFICATION_PCSC_END_OF_FILE	event of reaching the file end when performing its reading
RFID_NOTIFICATION_PCSC_FILE_ACCESS_DENIED	event of detection of absence of the file access rights
RFID_NOTIFICATION_PCSC_APPLICATION_SELECTED	event of the application selection operation
RFID_NOTIFICATION_AC_PROCEDURE_START	event of the beginning of the authentication or secure data access procedure
RFID_NOTIFICATION_AC_PROCEDURE_FINISH	event of the end of the authentication or secure data access procedure
RFID_NOTIFICATION_PA_SECURITY_OBJECT_CHECK	event of the data security object verification as part of PA
RFID_NOTIFICATION_PA_FILE_CHECK	event of the file data integrity checking as part of PA
RFID_NOTIFICATION_PCSC_UPDATING_DATAGROUP	event of the procedure of file contents updating
RFID_NOTIFICATION_AUXILIARY_DATA_VALIDATION	event of the auxiliary data verification
RFID_NOTIFICATION_RI_SECTOR_ID	event of the receiving of the sector identifier data during RI
RFID_NOTIFICATION_BIOMETRICS_EMPTY_PLACEHOLDER	event of the detection of real biometric data absence in DG3 or DG4 and random filling data usage [35, R7-p1_v2_sIII_0057, R7-p3_v2_sIII_0011]
RFID_ERROR_NO_ERROR	successful operation
RFID_ERROR_ALREADY_DONE	requested operation has already been performed
RFID_LAYER6_FILE_EOF1	attempt of reading outside the end of the file
RFID_LAYER6_PWD_DEACTIVATED	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
RFID_LAYER6_PWD_BLOCKED	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
RFID_LAYER6_PWD_SUSPENDED	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
RFID_LAYER6_PWD_BLOCKED_2	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
RFID_LAYER6_PWD_DEACTIVATED_2	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
RFID_LAYER6_PWD_SUSPENDED_2	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
RFID_LAYER6_MSE_SET_AT_FAILURE	error of MSE:Set AT APDU-command execution when performing the procedures: PACE TA CA RI
RFID_LAYER6_INCORRECT_PARAMS	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).
RFID_LAYER6_FILE_NOT_FOUND	file not found
RFID_LAYER6_NO_REFERENCE_DATA	unavailable data, pointed to by the APDU-command parameters
RFID_LAYER6_FILE_EOF2	attempt of reading outside the file end of the
RFID_Error_GraphManager	connection error
RFID_ERROR_NO_CHIP_DETECTED	RFID-chip is absent in the scope of the reader
RFID_ERROR_NOT_AVAILABLE	requested operation unavailable
RFID_ERROR_INVALID_PARAMETER	incorrect command parameter
RFID_ERROR_NOT_INITIALIZED	SDK control library was not initialized
RFID_Error_NotEnoughMemory	insufficient memory for command execution
RFID_ERROR_INVALID_DIRECTORY	incorrect directory name
RFID_ERROR_UNKNOWN_COMMAND	unknown command
RFID_ERROR_FILE_IO_ERROR	file input/output error
RFID_ERROR_BUSY	SDK control library is busy. Execution of the command is impossible
RFID_ERROR_OLD_FIRMWARE	it is required to update reader’s firmware
RFID_ERROR_PCSC_FAILED	error of command of data exchange with RFID-chip execution (common case)
RFID_ERROR_PCSC_READER_NOT_AVAILABLE	RFID-chip reader unavailable
RFID_ERROR_PCSC_CANT_CONNECT_CARD	failed to connect with RFID-chip
RFID_ERROR_PCSC_CARD_IS_NOT_CONNECTED	no active RFID-chip
RFID_ERROR_PCSC_OPERATION_CANCELLED	data reading operation cancelled by the user
RFID_ERROR_PCSC_CARD_IS_BUSY	data exchange with RFID-chip takes place. Execution of the command is impossible
RFID_ERROR_PCSC_FAILED_S_CARD	error of SCard service when data exchanging with RFID-chip
RFID_ERROR_PCSC_EXT_LE_FAILED	error of executing command of extended length reading. Full reinitialization of RFID-chip is required
RFID_LAYER6_PWD_FAILED	error of the execution of MSE:Set AT when performing PACE procedure or General Authenticate (variants of appearance are analogue to RFID_ LAYER6_GENERA L_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
RFID_ERROR_NOT_PERFORMED	operation was not performed
RFID_ERROR_SESSION_IS_CLOSED	session closed, operation impossible
RFID_ERROR_SESSION_TERMINAL_UNSUPPORTED_OPERATION	operation is not supported by the current type of terminal
RFID_ERROR_SESSION_TERMINAL_TYPE_UNKNOWN	unknown type of terminal
RFID_ERROR_SESSION_TERMINAL_TYPE_BAD_CERTIFICATE	error of reading or analysis of the terminal certificate data
RFID_ERROR_SESSION_TERMINAL_TYPE_NOT_SET	terminal type was not defined for the current session
RFID_ERROR_SESSION_PROCEDURE_TYPE_UNKNOWN	unknown authentication procedure type
RFID_ERROR_SESSION_PROCEDURE_TYPE_UNSUPPORTED	defined type terminal does not support this type of procedure
RFID_ERROR_SESSION_PROCEDURE_TYPE_NOT_SET	type of authentication procedure was not set for the current session
RFID_ERROR_SESSION_ACCESS_KEY_UNKNOWN_TYPE	unknown access key type
RFID_ERROR_SESSION_ACCESS_KEY_UNSUPPORTED_SM_TYPE	unsupported type of secure data access procedure
RFID_ERROR_SESSION_ACCESS_KEY_INCORRECT_SM_TYPE	secure data access procedure does not allow to use the given key type
RFID_ERROR_SESSION_ACCESS_KEY_RESTRICTED	key type is not supported by the current terminal type, or the rights to its use are insufficient
RFID_ERROR_SESSION_ACCESS_KEY_INCORRECT_DATA	incorrect key contents (empty or zero string)
RFID_ERROR_SESSION_ACCESS_KEY_NOT_SET	secure data access key was not set for the current session
RFID_ERROR_SESSION_PWD_MANAGEMENT_NOT_AUTHORIZED	operation of password management is not authorized for the current terminal type
RFID_ERROR_SESSION_ACCESS_CONTROL_UNKNOWN_TYPE	unknown type of the procedure of authentication or secure data access
RFID_ERROR_SESSION_ACCESS_CONTROL_REQUIRES_SM	preliminary opening of the secure data access session is required (PACE or BAC)
RFID_ERROR_SESSION_ACCESS_CONTROL_REQUIRES_PACE	preliminary opening of the secure data access session is required (PACE)
RFID_ERROR_SESSION_ACCESS_CONTROL_REQUIRES_CA_KEYS	execution of TA preliminary step (for version 2) is required – computing CA ephemeral public keys
RFID_ERROR_SESSION_ACCESS_CONTROL_REQUIRES_TA	preliminary TA procedure is required
RFID_ERROR_SESSION_ACCESS_CONTROL_REQUIRES_CA	preliminary CA procedure is required
RFID_ERROR_SESSION_ACCESS_CONTROL_INCORRECT_OPTION_CA	discrepancy between the selected CA variant on the preliminary and main stages
RFID_ERROR_SESSION_ACCESS_CONTROL_CA_FAILED	CA procedure failed
RFID_ERROR_SESSION_ACCESS_CONTROL_TA_FAILED	TA procedure failed
RFID_ERROR_SESSION_ACCESS_CONTROL_AA_FAILED	AA procedure failed
RFID_ERROR_SESSION_ACCESS_CONTROL_RI_FAILED	RI procedure failed
RFID_ERROR_SESSION_PA_SIGNATURE_CHECK_FAILED	document security object digital signature verification failed
RFID_ERROR_SESSION_PA_HASH_CHECK_FAILED	informational data group integrity verification failed
RFID_ERROR_SESSION_INVALID_AUX_DATA_DATE_OF_EXPIRY	verification of auxiliary data (date of expiry) failed
RFID_ERROR_SESSION_INVALID_AUX_DATA_DATE_OF_BIRTH	verification of auxiliary data (age) failed
RFID_ERROR_SESSION_INVALID_AUX_DATA_COMMUNITY_ID	verification of auxiliary data (Community ID) failed
RFID_ERROR_SESSION_E_SIGN_REQUIRES_APP_SELECTION	selection of eSign application is required to access its functionality
RFID_ERROR_SESSION_E_SIGN_PIN_NOT_SET	it is required to set the value of eSign-PIN for the current session
RFID_ERROR_SESSION_E_SIGN_PIN_NOT_VERIFIED	it is required to execute verification of eSign-PIN for the current session
RFID_ERROR_SESSION_INCORRECT_DATA	incorrect session object data
RFID_ERROR_SESSION_FILE_NOT_ENOUGH_DATA	no sufficient data for creation of the file contents ASN.1 object.
RFID_ERROR_SESSION_FILE_INCORRECT_DATA	incorrect data of the file contents ASN.1 object
RFID_ERROR_SESSION_FILE_UNEXPECTED_DATA	in compliance of the structure of the file contents ASN.1 object with the structure given in the respective specification
RFID_ERROR_SESSION_FILE_CONTENTS_UNEXPECTED_DATA	in compliance of the structure of the formed ASN.1-objects with the requirements of specification (in the context of specific file)
RFID_ERROR_SESSION_FILE_WRONG_TAG	incorrect value of the data group tag
RFID_ERROR_SESSION_FILE_CANT_USE_DATA	use of the read data is impossible
RFID_ERROR_SESSION_FILE_CANT_READ_DATA	error of physical data reading
RFID_ERROR_SESSION_FILE_ACCESS_DENIED	error of access to the protected data groups
RFID_LAYER6_SECURITY_MANAGER	secure communication channel organization is required to access data
RFID_LAYER6_APP_SELECTION_FAILURE	error of executing APDU-command of Master File or application selection
RFID_LAYER6_MUTUAL_AUTH_MAC_FAIL	error of the cryptogram checksum validation during BAC procedure
RFID_LAYER6_MUTUAL_AUTH_ENC_FAIL	error of the cryptogram validation during BAC
RFID_LAYER6_MUTUAL_AUTH_FAILURE	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
RFID_LAYER6_SM_DO8E_MISSING	absence of the checksum in the protected APDU-response from the RFID-chip (SM '8E' data object)
RFID_LAYER6_SM_DO87_MISSING	absence of the data padding object in the protected APDU-response from the RFID-chip (SM '87' data object)
RFID_LAYER6_SM_DO99_MISSING	absence of the command execution status in the protected APDU-response from the RFID- chip (SM '99' data object)
RFID_LAYER6_SM_MAC_INCORRECT	error of the checksum validation of the protected APDU-response from the RFID-chip
RFID_LAYER6_SM_DO87_INCORRECT	incorrect contents of the data padding object in the protected APDU-response from the RFID-chip (SM '87' data object)
RFID_LAYER6_NON_TLV_RESPONSE_DATA	response to Read Binary APDU-command, using 'B1' parameter for file data reading with an offset >32767, is not represented in the TLV-format
RFID_LAYER6_WRONG_RND_ICC_LENGTH	incorrect length of the data received as a result of Get Challenge APDU-command execution
RFID_LAYER6_INT_AUTH_FAILURE	error of Internal Authenticate APDU-command execution when performing AA procedure
RFID_LAYER6_MSE_SET_KAT_FAILURE	error of MSE:Set KAT APDU-command execution when performing CA procedure, version 1
RFID_LAYER6_MSE_SET_DST_FAILURE	error of MSE:Set DST APDU-command execution when performing TA procedure
RFID_LAYER6_PSO_CERTIFICATE_FAILURE	error of PSO:Verify Certificate APDU-command execution when performing TA procedure
RFID_LAYER6_GET_CHALLENGE_FAILURE	error of Get Challenge APDU-command execution
RFID_LAYER6_EXT_AUTH_FAILURE	error of External Authenticate APDU-command execution when performing TA procedure
RFID_LAYER6_GENERAL_AUTH_FAILURE	error of General Authenticate APDU-command execution when performing PACE procedure at steps 1-3
RFID_ERROR_FAILED	error of operation execution (common case)