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

JC_GetFunctionList

JC_GetFunctionList(JC_FUNCTION_LIST_PTR_PTR ppFunctionList)
Параметры:
  • ppFunctionList (out) – указатель на структуру типа CK_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

JC_GetReaderProperties(CK_UTF8CHAR_PTR pReaderName, CK_ULONG ulReaderNameSize, JC_TOKEN_PROPERTIES_PTR pProperties)
Параметры:
  • pReaderName (in) – имя считывателя.
  • ulReaderNameSize (in) – размер имени считывателя в байтах.
  • pProperties (out) – информация о считывателе.

Примечание

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

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

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

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

Совет

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

JC_SetLabel

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

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

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

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

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

Совет

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

JC_SD_SetMountPoint

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

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

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

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

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

Совет

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

JC_SetLog

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.

Совет

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