JC_PKI_SetComplexity

CK_RV JC_PKI_SetComplexity(CK_SLOT_ID slotID, JC_PKI_PERSONALIZATION_INFO_PTR pInfo)

Параметры:    

• slotID (in) – идентификатор слота.
• pInfo (in) – параметры персонализации.

Установка параметров персонализации для приложения PKI. Функции передается указатель на структуру JC_PKI_PERSONALIZATION_INFO с параметрами персонализации.

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

JC_PKI_GetComplexity

CK_RV JC_PKI_GetComplexity(CK_SLOT_ID slotID, JC_PKI_PERSONALIZATION_INFO_PTR pInfo)

Параметры:    

• slotID (in) – идентификатор слота.
• pInfo (out) – параметры персонализации.

Получение параметров персонализации для приложения PKI. Функция возвращает указатель на структуру JC_PKI_PERSONALIZATION_INFO с параметрами персонализации.

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

JC_PKI_WipeCard

CK_RV JC_PKI_WipeCard(CK_SLOT_ID slotID)

Параметры:    

• slotID (in) – идентификатор слота.

Очистка содержимого приложения PKI.

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

JC_PKI_GetPINInfo

CK_RV JC_PKI_GetPINInfo(CK_SLOT_ID slotID, JC_PKI_PIN_INFO_PTR pInfo)

Параметры:    

• slotID (in) – идентификатор слота.
• pInfo (out) – счетчики PIN-кодов.

Получить счетчики PIN-кодов для приложения PKI. Функция возвращает указатель на структуру JC_PKI_PIN_INFO с данными счетчиков.

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

JC_PKI_UnlockUserPIN

CK_RV JC_PKI_UnlockUserPIN(CK_SLOT_ID slotID)

Параметры:    

• slotID (in) – идентификатор слота.

Функция разблокирует PIN-код пользователя приложения PKI или возвращает ошибку CKR_CANNOT_UNLOCK, если разблокировка невозможна.

Результат:    

• CKR_CANNOT_UNLOCK – разблокировка невозможна.

JC_PKI_ReadPinCounters

CK_RV JC_PKI_ReadPinCounters(CK_SLOT_ID slotID, CK_USER_TYPE userType, JC_PKI_PIN_COUNTERS_PTR pPinCounters)

Параметры:    

• slotID (in) – идентификатор слота.
• userType (in) – тип пользователя. Возможные значения:
  • CKU_USER – пользователь;
  • CKU_SO – администратор.
• pPinCounters (out) – информация о счетчиках PIN-кода.

Функция возвращает указатель на структуру типа JC_PKI_PIN_COUNTERS с информацией о PIN-коде для приложения PKI.

Результат:    

• CKR_SLOT_ID_INVALID – недопустимый идентификатор слота;
• CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.

JC_PKI_BIO_GetSupported

CK_RV JC_PKI_BIO_GetSupported(CK_SLOT_ID slotID, JC_PKI_BIO_SUPPORT_INFO_PTR pInfo)

Параметры:    

• slotID (in) – идентификатор слота.
• pInfo (out) – указатель на структуру, содержащую информацию о поддержке биометрии.

Функция возвращает указатель на структуру типа JC_PKI_BIO_SUPPORT_INFO с информацией о поддержке биометрии.

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

JC_PKI_BIO_GetFingerIndexes

CK_RV JC_PKI_BIO_GetFingerIndexes(CK_SLOT_ID slotID, CK_BYTE_PTR pFingers, CK_ULONG_PTR pulFingerCount)

Параметры:    

• slotID (in) – идентификатор слота.
• pFingers (out) – указатель на массив байт с буфером для идентификаторов пальцев.
• pulFingerCount (out) – количество идентификаторов пальцев.

Получить идентификаторы зарегистрированных пальцев.

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

JC_PKI_BIO_GetFingerPublicData

CK_RV JC_PKI_BIO_GetFingerPublicData(CK_SLOT_ID slotID, CK_BYTE fingerIndex, CK_BYTE_PTR pPublicData, CK_ULONG_PTR pulPublicDataSize)

Параметры:    

• slotID (in) – идентификатор слота.
• fingerIndex (in) – идентификатор пальца (от 1 до 10).
• pPublicData (out) – указатель на массив байт с буфером для публичной биометрической информации о пальце.
• pulPublicDataSize (out) – размер буфера в байтах.

Получить публичную биометрическую информацию о пальце по его идентификатору.

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

JC_PKI_BIO_SetFingerData

CK_RV JC_PKI_BIO_SetFingerData(CK_SLOT_ID slotID, CK_BYTE fingerIndex, CK_BYTE_PTR pPublicData, CK_ULONG ulPublicDataSize, CK_BYTE_PTR pPrivateData, CK_ULONG ulPrivateDataSize, CK_BYTE_PTR pDeviceName, CK_ULONG ulDeviceNameSize)

Параметры:    

• slotID (in) – идентификатор слота.
• fingerIndex (in) – идентификатор пальца (от 1 до 10).
• pPublicData (in) – указатель на массив байт с буфером публичной биометрической информации о пальце.
• ulPublicDataSize (in) – размер буфера публичной информации в байтах.
• pPrivateData (in) – указатель на массив байт с буфером закрытой биометрической информации о пальце.
• ulPrivateDataSize(in) – размер буфера закрытой информации в байтах.
• pDeviceName (in) – имя устройства для считывателя смарт-карт со встроенным сканером отпечатков пальцев, на которое будет записана биометрическая информация.
• ulDeviceNameSize (in) – размер имени устройства в байтах.

Функция записывает на устройство со сканером отпечатков пальцев биометрическую информацию о пальце по его идентификатору.

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

JC_PKI_BIO_DeleteFinger

CK_RV JC_PKI_BIO_DeleteFinger(CK_SLOT_ID slotID, CK_BYTE fingerIndex)

Параметры:    

• slotID (in) – идентификатор слота.
• fingerIndex (in) – идентификатор пальца (от 1 до 10).

Функция удаляет из памяти устройства, соответствующего идентификатору слота, данные об отпечатке пальца по его идентификатору.

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

JC_PKI_BIO_SetLibrary

CK_RV JC_PKI_BIO_SetLibrary(CK_UTF8CHAR_PTR pLibraryPath, CK_ULONG ulLibraryPathSize)

Параметры:    

• pLibraryPath (in) – абсолютный путь к файлу с биометрической библиотекой.
• ulLibraryPathSize (in) – размер пути до файла библиотеки в байтах или CK_UNAVAILABLE_INFORMATION, если путь заканчивается 0.

Установить путь к файлу биометрической библиотеки.

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

JC_PKI_BIO_EnrollPinWithResponse

CK_RV JC_PKI_BIO_EnrollPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength)

Параметры:    

• slotID (in) – идентификатор слота.
• pResponse (in) - ответ Администратора на запрос
• ulResponseLength (in) - длина ответа

Задать (сменить) отпечаток пальцев с использованием механизма Challenge-Response

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

JC_PKI_BIO_GetBioTicket

CK_RV JC_PKI_BIO_GetBioTicket (CK_SLOT_ID slotID, CK_BYTE_PTR pBioTicket, CK_ULONG_PTR pulTicketDataSize)

Параметры:    

• slotID (in) – идентификатор слота
• pBioTicket (out) - указатель на данные (тикет)
• pulTicketDataSize (out) - длина данных

Осуществить БИО-аутентификацию и получить данные аутентификации (тикет)

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

JC_PKI_BIO_GetSupportedEx

CK_RV JC_PKI_BIO_GetSupportedEx (CK_SLOT_ID slotID, JC_PKI_BIO_SUPPORT_INFO_EX_PTR pInfo)

Параметры:    

• slotID (in) – идентификатор слота
• pInfo (out) - указатель на структуру, содержащую расширенную информацию по биометрии

Получить расширенную информацию о поддержке биометрии

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

JC_PKI_GetPinPolicy

CK_RV JC_PKI_GetPinPolicy (CK_SESSION_HANDLE hSession, CK_USER_TYPE userType, JC_PKI_PIN_POLICY_PTR pPinPolicy)

Параметры:    

• hSession (in) – описатель сессии
• userType (in) - тип пользователя, поддерживается только CKU_USER
• pPinPolicy (out) - указатель на структуру, содержащую информацию о политике PIN-кода типа пользователя

Получение параметров политики PIN-кода

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

JC_PKI_ReadBioCounters

CK_RV JC_PKI_ReadBioCounters (CK_SLOT_ID slotID, JC_PKI_PIN_COUNTERS_PTR pPinCounters)

Параметры:    

• slotID (in) - дескриптор слота
• pPinCounters(in) - указатель на структуру, содержащую информацию о счетчиках

Получение параметров политики PIN-кода

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

JC_PKI_SetPinPolicy

CK_RV JC_PKI_SetPinPolicy (CK_SESSION_HANDLE hSession, CK_USER_TYPE userType, JC_PKI_PIN_POLICY_PTR pPinPolicy)

Параметры:    

• hSession (in) – описатель сессии
• userType (in) - тип пользователя, поддерживается только CKU_USER
• pPinPolicy (out) - указатель на структуру, содержащую информацию о политике PIN-кода типа пользователя

Установка параметров политики PIN-кода Пользователя

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

JC_PKI_SetUserPinToBeChanged

CK_RV JC_PKI_SetUserPinToBeChanged (CK_SESSION_HANDLE hSession, CK_BBOOL toBeChanged)

Параметры:    

• hSession (in) – описатель сессии
• toBeChanged (in) требовать (CK_TRUE) или не требовать (CK_FALSE) смены PIN-кода пользователя сразу после предъявления

Установка/сброс флага обязательной смены PIN-кода пользователя после первого предъявления

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

JC_PKI_SetUserPinWithResponse

CK_RV JC_PKI_SetUserPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength, CK_UTF8CHAR_PTR pNewUserPin, CK_ULONG ulNewUserPinLen)

Параметры:    

• slotID (in) - идентификатор слота
• pResponse (in) - ответ Администратора на запрос
• ulResponseLength (in) - длина ответа
• pNewUserPin (in) - указатель на новый ПИН пользователя
• ulNewUserPinLen (in) - длина нового ПИН пользователя

Задать PIN-код пользователя с использованием механизма "Запрос-Ответ"

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

JC_PKI_UnlockUserPinWithResponse

CK_RV JC_PKI_UnlockUserPinWithResponse (CK_SLOT_ID slotID, CK_BYTE_PTR pResponse, CK_ULONG ulResponseLength, CK_UTF8CHAR_PTR pNewUserPin, CK_ULONG ulNewUserPinLen)

Параметры:    

• slotID (in) - идентификатор слота
• pResponse (in) - ответ Администратора на запрос
• ulResponseLength (in) - длина ответа
• pNewUserPin (in) - указатель на новый ПИН пользователя
• ulNewUserPinLen (in) - длина нового ПИН пользователя

Разблокировать PIN-код пользователя с использованием механизма "Запрос-Ответ"

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