Навигация

Функции Антифрод-терминала

JC_AFT_GetReaderVersion

CK_RV JC_AFT_GetReaderVersion(CK_SLOT_ID slotID, CK_ULONG_PTR pulOSVersion, CK_ULONG_PTR pulApplicationVersion)
Параметры:
  • slotID (in) – идентификатор слота.
  • pulOSVersion (out) – версия ОС.
  • pulApplicationVersion (out) – версия приложения.

Получить данные о прошивке Атнифрод-терминала (версии ОС и версии приложения).

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_IsCardlessSupported

CK_RV JC_AFT_IsCardlessSupported(CK_SLOT_ID slotID, CK_BBOOL_PTR pSupported)
Параметры:
  • slotID (in) – идентификатор слота.
  • pSupported (out) – признак поддержки бескарточного режима. Равен CK_TRUE, если бескарточный режим поддерживается.

Получить данные о поддержке работы Атнифрод-терминала в бескарточном режиме.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_SWYX_Start

CK_RV JC_SWYX_Start(CK_SLOT_ID slotID)
Параметры:
  • slotID (in) – идентификатор слота.

Включить SWYX-режим работы Атнифрод-терминала.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_SWYX_StartEx

CK_RV JC_SWYX_StartEx(CK_SLOT_ID slotID, CK_BYTE_PTR pReference, CK_ULONG ulReferenceLen)
Параметры:
  • slotID (in) – идентификатор слота.
  • pReference (in) – параметр для добавления в журнал операций. Представляет собой массив из 8 байт.
  • ulReferenceLen (in) – длина параметра в байтах. Всегда должна быть равна 8 байт.

Включить SWYX-режим с защитой от попыток повторного навязывания перехваченного журнала вместе с копией уже однажды одобренного сервером документа.

Запускается в режимах

Результат:
  • CKR_GENERAL_ERROR – общий сбой при работе с библиотекой;
  • CKR_ARGUMENTS_BAD – недопустимые аргументы.

Совет

Полный список ошибок см. в приложении.

JC_SWYX_Display

CK_RV JC_SWYX_Display(CK_SLOT_ID slotID, CK_ULONG language, CK_ULONG ulTimeout, CK_ULONG ulDisplayIndex, CK_UTF8CHAR_PTR pText, CK_ULONG ulTextSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • language (in) – Код языка. 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – значение тайм-аута.
  • ulDisplayIndex (in) – индекс дисплея.
  • pText (in/out) – текст для отображения на экране считывателя в кодировке UTF8 длиной от 5 до 400 символов.
  • ulTextSize (out) – длина текста в байтах.

Отобразить текст на экране терминала и предложить пользователю подписать его. В случае, если пользователь отменит операцию подписи, метод возвращает значение CKR_FUNCTION_REJECTED (0x00000200), в случае тайм-аута - CKR_FUNCTION_CANCELED (0x00000050).

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_SWYX_Stop

CK_RV JC_SWYX_Stop(CK_SLOT_ID slotID, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pSignature (out) – буфер для подписи.
  • pulSignatureSize (out) – размер буфера для подписи в байтах.

Выключить SWYX-режим.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_InitCard

CK_RV JC_AFT_InitCard(CK_SLOT_ID slotID, CK_ULONG ulLanguageId, CK_ULONG ulTimeout)
Параметры:
  • slotID (in) – идентификатор слота.
  • ulLanguageId (in) – Код языка. 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.

Инициализировать карту, вставленную в Антифрод-терминал (при работе с апплетом Криптотокен).

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_GetSerialNumber

CK_RV JC_AFT_GetSerialNumber(CK_SLOT_ID slotID, CK_BYTE_PTR pSerial, CK_ULONG_PTR pulSerialSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pSerial (out) – буфер для серийного номера.
  • pulSerialSize (out) – размер буфера для серийного номера в байтах.

Получить серийный номер апплета, находящегося внутри Антифрод-терминала.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_InitUserPin

CK_RV JC_AFT_InitUserPin(CK_SLOT_ID slotID, CK_ULONG ulLanguageId, CK_ULONG ulTimeout, CK_BBOOL bConfirmRequired)
Параметры:
  • slotID (in) – идентификатор слота.
  • ulLanguageId (in) – код языка: 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.
  • bConfirmRequired (in) – требовать ли повторного ввода PIN-кода для подтверждения. Возможные значения: CK_TRUE - требовать, CK_FALSE - не требовать.

Инициализировать PIN-код пользователя на карте в Антифрод-считывателе (при работе с апплетом Криптотокен).

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_VerifyPin

CK_RV JC_AFT_VerifyPin(CK_SLOT_ID slotID, CK_USER_TYPE userType, CK_ULONG ulLanguageId, CK_ULONG ulTimeout)
Параметры:
  • slotID (in) – идентификатор слота.
  • userType (in) – тип PIN-кода.
  • ulLanguageId (in) – код языка. 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.

Запросить PIN-код и проверить его на карте.

Запускается в режимах

Результат:
  • CKR_FUNCTION_REJECTED – пользователь отменил операцию.

Совет

Полный список ошибок см. в приложении.

JC_AFT_ModifyPin

CK_RV JC_AFT_ModifyPin(CK_SLOT_ID slotID, CK_USER_TYPE userType, CK_ULONG ulLanguageId, CK_ULONG ulTimeout, CK_BBOOL bConfirmRequired)
Параметры:
  • slotID (in) – идентификатор слота.
  • userType (in) – тип PIN-кода.
  • ulLanguageId (in) – код языка. 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.
  • bConfirmRequired (in) – требовать ли повторного ввода PIN-кода для подтверждения. Возможные значения: CK_TRUE - требовать, CK_FALSE - не требовать.

Сменить PIN-код.

Запускается в режимах

Результат:
  • CKR_FUNCTION_REJECTED – пользователь отменил операцию.

Совет

Полный список ошибок см. в приложении.

JC_AFT_GetProperties

CK_RV JC_AFT_GetProperties(CK_SLOT_ID slotID, SWYX_PROPERTIES_RESPONSE_PTR pPropeties)
Параметры:
  • slotID (in) – идентификатор слота.
  • pPropeties (out) – характеристики Антифрод-терминала.

Получить характеристики Антифрод-терминала.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_Personalize

CK_RV JC_AFT_Personalize(CK_SLOT_ID slotID)
Параметры:
  • slotID (in) – идентификатор слота.

Сгенерировать новую ключевую пару на считывателе. Карта может отсутствовать.

Запускается в режимах

Результат:
  • CKR_FUNCTION_REJECTED – пользователь отменил операцию.

Совет

Полный список ошибок см. в приложении.

JC_AFT_GetPublicKey

CK_RV JC_AFT_GetPublicKey(CK_SLOT_ID slotID, CK_BYTE_PTR pPublicKey, CK_ULONG_PTR pulPublicKeySize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pPublicKey (out) – открытый ключ.
  • pulPublicKeySize (out) – размер открытого ключа в байтах.

Получить открытый ключ считывателя. Карта может отсутствовать.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_EnterLocalPin

CK_RV JC_AFT_EnterLocalPin(CK_SLOT_ID slotID, CK_ULONG ulLanguageId, CK_ULONG ulTimeout, CK_BBOOL bConfirmRequired)
Параметры:
  • slotID (in) – идентификатор слота.
  • ulLanguageId (in) – код языка. 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.
  • bConfirmRequired (in) – требовать ли повторного ввода PIN-кода для подтверждения. Возможные значения: CK_TRUE - требовать, CK_FALSE - не требовать.

Запросить у пользователя PIN-код и сохранить его внутри считывателя (но не на карте). Карта может отсутствовать.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_WriteLocalPin

CK_RV JC_AFT_WriteLocalPin(CK_SLOT_ID slotID, CK_ULONG ulLanguageId, CK_ULONG ulTimeout, CK_BYTE_PTR pPin, CK_ULONG ulPinLength)
Параметры:
  • slotID (in) – идентификатор слота.
  • ulLanguageId (in) – код языка: 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.
  • pPin (in) – PIN-код.
  • ulPinLength (in/out) – размер PIN-кода в байтах.

Записать PIN-код переданный приложением внутрь считывателя (но не на карту). Карта может отсутствовать.

Запускается в режимах

Результат:Функция возвращает стандартные ошибки, предусмотренные спецификацией PKCS #11.

Совет

Полный список ошибок см. в приложении.

JC_AFT_EnterAndReadPin

CK_RV JC_AFT_EnterAndReadPin(CK_SLOT_ID slotID, CK_USER_TYPE userType, CK_ULONG ulLanguageId, CK_ULONG ulTimeout, JC_CONFIRM_MODE confirmMode, CK_BYTE_PTR pPin, CK_ULONG_PTR pulPinLength)
Параметры:
  • slotID (in) – идентификатор слота.
  • userType (in) – тип пользователя, принимает значение CK_UNAVAILABLE_INFORMATION, если тип пользователя неизвестен.
  • ulLanguageId (in) – код языка: 0x0409 - английский, 0x0419 - русский.
  • ulTimeout (in) – тайм-аут.
  • confirmMode (in) –

    режим подтверждения ввода. Возможные значения:

    • 1 – ввод без подтверждения;
    • 2 – ввод с подтверждением;
    • 3 – запрос только подтверждения.
  • pPin (in) – PIN-код.
  • pulPinLength (in/out) – входной - размер буфера для PIN-кода в байтах, выходной - размер PIN-кода в байтах.

Функция запрашивает PIN-код и возвращает его значение.

Запускается в режимах

Результат:
  • CKR_BUFFER_TOO_SMALL – буфер указан (pPin != NULL) и его размер слишком мал для PIN-кода.

Совет

Полный список ошибок см. в приложении.

Оглавление