Навигация

Служебные функции

JC_GetFunctionList

CK_RV JC_GetFunctionList(JC_FUNCTION_LIST_PTR_PTR ppFunctionList)
Параметры:
  • ppFunctionList (out) – двойной указатель на структуру типа JC_FUNCTION_LIST, которая содержит указатели на методы-расширения, не входящие в стандарт PKCS #11.

Примечание

Это функция может быть вызвана перед вызовом C_Initialize().

Метод для получения указателя на список с указателями на все методы Единой библиотеки, которые не входят в стандарт PKCS#11. ppFunctionList содержит указатель на структуру CK_FUNCTION_LIST библиотеки, которая в свою очередь содержит указатели на методы.

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

Результат:
  • CKR_ARGUMENTS_BAD – недопустимые аргументы.
  • CKR_FUNCTION_FAILED – выполнение функции было прервано или она не может быть выполнена.
  • CKR_GENERAL_ERROR – общий сбой при работе с библиотекой.
  • CKR_HOST_MEMORY – компьютер, на котором запущена библиотека, не имеет достаточно памяти для выполнения функции.
  • CKR_OK – функция выполнена успешно.

Совет

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

JC_GetReaderProperties

CK_RV JC_GetReaderProperties(CK_UTF8CHAR_PTR pReaderName, CK_ULONG ulReaderNameSize, JC_TOKEN_PROPERTIES_PTR pProperties)
Параметры:
  • pReaderName (in) – имя считывателя.
  • ulReaderNameSize (in) –

    размер имени считывателя в байтах.

    Примечание

    Значение параметра ulReaderNameSize может быть равно CK_UNAVAILABLE_INFORMATION, если имя считывателя заканчивается на 0.

  • pProperties (out) – информация о считывателе.

Получить информацию о считывателе с указанным именем. Метод возвращает указатель на структуру JC_TOKEN_PROPERTIES с информацией о считывателе.

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

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

Совет

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

JC_SetLabel

CK_RV JC_SetLabel(CK_SLOT_ID slotID, CK_UTF8CHAR_PTR pLabel, CK_ULONG ulLabelSize)
Параметры:
  • slotID (in) – идентификатор слота
  • pLabel (in) – метка
  • ulLabelSize (in) – размер метки в байтах (не более 32). Может принимать значение CK_UNAVAILABLE_INFORMATION, если метка заканчивается 0.

Установить метку для слота.

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

Результат:код ошибки

Совет

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

JC_GetISD

CK_RV JC_GetISD(CK_SLOT_ID slotID, JC_ISD_DATA_PTR pISD)
Параметры:
  • slotID (in) – идентификатор слота.
  • pISD (out) – информация о ридере.

Получить информацию о модели считывателя смарт-карт для указанного слота. Функция возвращает указатель на структуру JC_ISD_DATA с данными о модели считывателя.

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

Результат:код ошибки

Совет

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

JC_SD_SetMountPoint

CK_RV JC_SD_SetMountPoint(CK_UTF8CHAR_PTR pMountPoint, CK_ULONG ulMountPointSize)
Параметры:
  • pMountPoint (in) – абсолютный путь до точки монтирования Jacarta MicroSD.
  • ulMountPointSize (in) – длина пути в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если путь заканчивается 0.

Установить точку монтирования для Jacarta MicroSD.

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

Результат:код ошибки

Совет

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

JC_SD_GetMountPoint

CK_RV JC_SD_GetMountPoint(CK_UTF8CHAR_PTR pMountPoint, CK_ULONG_PTR pulMountPointSize)
Параметры:
  • pMountPoint (out) – указатель на буфер (массив байт) с абсолютным путем до точки монтирования Jacarta MicroSD.
  • pulMountPointSize (out) – длина массива байт (в байтах).

Получить точку монтирования для Jacarta MicroSD.

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

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

Совет

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

JC_SetLog

CK_RV JC_SetLog(JC_LOG_MODE mode, CK_UTF8CHAR_PTR pFileName, CK_ULONG ulFileNameLength)
Параметры:
  • mode (in) –

    режим логирования. Возможные значения:

    • JC_LOG_MODE_OFF – логирование отключено;
    • JC_LOG_MODE_DEBUG – логирование включено;
    • JC_LOG_MODE_DEBUG_APDU – логирование только APDU-команд.
  • pFileName (in/out) – имя файла для журнала операций. Указывается полный путь к файлу журнала, причем все каталоги должны существовать. Может быть указано значение stdout для вывода данных на консоль.
  • ulFileNameLength (out) – размер имени файла в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если имя файла заканчивается 0.

Установка режима логирования библиотеки. Функция определяет, какие данные будут записаны в журнал операций. Может быть вызвана до вызова C_Initialize().

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

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

Совет

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

JC_SetNotificationCallback

CK_RV JC_SetNotificationCallback(JC_NOTIFICATION_CALLBACK function, CK_VOID_PTR pApplication, CK_BBOOL callForOldEvents)
Параметры:
  • function (in) – функция обратного вызова. Если равна NULL, то текущая функция обратного вызова сбрасывается. Все данные переданные функции обратного вызова (за исключением pApplication) действительны только на время вызова.
  • pApplication (in) – указатель на произвольные данные, которые будут переданы в функцию.
  • callForOldEvents (in) – вызывать функцию для ранее зарегистрированных событий (CK_TRUE – вызвать, CK_FALSE – не вызывать).

Установить функцию обратного вызова для дополнительного информирования о событиях библиотеки. Может быть только одна функция обратного вызова.

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

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

Совет

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

JC_GetVersionInfo

CK_RV JC_GetVersionInfo(JC_VERSION_INFO_PTR pVersionInfo)
Параметры:
  • pVersionInfo (in) – информация о полном номере версии библиотеки.

Возвращает версию библиотеки.

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

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

Совет

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

Оглавление