Перейти к содержимому
Аладдин Р.Д.Аладдин Р.Д.Аладдин Р.Д.

Нестандартные служебные функции

USB-токены и смарт-карты JaCartaAPI и SDKUSB-токены и смарт-карты JaCarta

JC_GetFunctionList

Заголовок раздела «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

Заголовок раздела «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

Заголовок раздела «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

Заголовок раздела «JC_GetISD»

CK_RV JC_GetISD(CK_SLOT_ID slotID, JC_ISD_DATA_PTR pISD) Параметры:

  • slotID (in) – идентификатор слота.
  • pISD (out) – информация о ридере. Получить информацию о модели считывателя смарт-карт для указанного слота. Функция возвращает указатель на структуру JC_ISD_DATA с данными о модели считывателя. Запускается в режимах:
  • Администратор;
  • Пользователь;
  • Гость. Результат: код ошибки Совет: Полный список ошибок см. в приложении.

JC_SetLog

Заголовок раздела «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

Заголовок раздела «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 – не вызывать). Установить функцию обратного вызова для дополнительного информирования о событиях библиотеки. Может быть только одна функция обратного вызова.

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

JC_GetVersionInfo

Заголовок раздела «JC_GetVersionInfo»

CK_RV JC_GetVersionInfo(JC_VERSION_INFO_PTR pVersionInfo) Параметры:

  • pVersionInfo (in) – информация о полном номере версии библиотеки. Возвращает версию библиотеки.

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