Функции для работы с апплетом Криптотокен 2

JC_CT2_IsPersonalized

JC_CT2_IsPersonalized(CK_SLOT_ID slotID, CK_BBOOL_PTR pPersonalized)
Параметры:
  • slotID (in) – идентификатор слота.
  • pPersonalized (out) – признак персонализации, принимает значение CK_TRUE, если Криптотокен-2 персонализирован, значение CK_FALSE в ином случае.

Проверить, персонализирован ли Криптотокен-2.

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

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

Совет

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

JC_CT2_ReadExtInfo

JC_CT2_ReadExtInfo(CK_SLOT_ID slotID, JC_CT2_EXTENDED_INFO_PTR pInfo)
Параметры:
  • slotID (in) – идентификатор слота.
  • pInfo (out) – дополнительная информацию о Криптотокен-2.

Получить дополнительную информацию о Криптотокен-2. Функция возвращает указатель на структуру JC_CT2_EXTENDED_INFO с информацией об апплете Криптотокен-2.

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

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

Совет

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

JC_CT2_CalcCheckSum

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

Рассчитать контрольную сумму апплета Криптотокен-2.

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

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

Совет

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

JC_CT2_SetSignaturePIN

JC_CT2_SetSignaturePIN(CK_SLOT_ID slotID, CK_UTF8CHAR_PTR pPin, CK_ULONG ulPinSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pPin (in) – PIN-код подписи.
  • ulPinSize (out) – длина PIN-кода подписи в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если PIN-код подписи заканчивается 0.

Установить PIN-код подписи для апплета Криптотокен-2. Требуется аутентификация пользователем.

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

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

Совет

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

JC_CT2_ChangeSignaturePIN

JC_CT2_ChangeSignaturePIN(CK_SLOT_ID slotID, CK_UTF8CHAR_PTR pOldPin, CK_ULONG ulOldPinSize, CK_UTF8CHAR_PTR pNewPin, CK_ULONG ulNewPinSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pOldPin (in) – старый PIN-код подписи.
  • ulOldPinSize (out) – длина старого PIN-кода подписи в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если PIN-код подписи заканчивается 0.
  • pNewPin (in) – новый PIN-код подписи.
  • ulNewPinSize (out) – длина нового PIN-кода подписи в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если PIN-код подписи заканчивается 0.

Изменить PIN-код подписи для апплета Криптотокен-2. Требуется аутентификация пользователем.

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

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

Совет

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

JC_CT2_SetPUK

JC_CT2_SetPUK(CK_SLOT_ID slotID, CK_UTF8CHAR_PTR pPuk, CK_ULONG ulPukSize)
Параметры:
  • slotID (in) – идентификатор слота.
  • pPuk (in) – PUK-код.
  • ulPukSize (out) – длина PUK-кода в байтах. Может принимать значение CK_UNAVAILABLE_INFORMATION, если PUK-код заканчивается 0.

Установить PUK-код для апплета Криптотокен-2. Требуется аутентификация администратором.

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

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

Совет

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

JC_CT2_SetPINPolicy

JC_CT2_SetPINPolicy(CK_SLOT_ID slotID, JC_CT2_PIN_TYPE pinType, JC_CT2_PIN_POLICY_PTR pPinPolicy)
Параметры:
  • slotID (in) – идентификатор слота.
  • pinType (in) – тип PIN-кода. Может принимать следующие значения: 1 – PIN-код пользователя, 2 – PIN-код подписи.
  • pPinPolicy (in) – указатель на структуру JC_CT2_PIN_POLICY с данными политики PIN-кода.

Функция устанавливает политику PIN-кода пользователя или подписи (в зависимости от переданного значения типа PIN-кода). Параметры полиики PIN-кода, такие как минимальная длина, наличие определенных символов и т.д., указываются в структуре типа JC_CT2_PIN_POLICY. Требуется аутентиикация администратором.

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

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

Совет

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

JC_CT2_SetSecureMessaging

JC_CT2_SetSecureMessaging(CK_SESSION_HANDLE hSession, CK_BBOOL bEnabled, CK_BBOOL bExclusive, CK_OBJECT_HANDLE hPublicKey, CK_BYTE_PTR pPrivateKeyValue, CK_ULONG ulPrivateKeyValueSize)
Параметры:
  • hSession (in) – дескриптор сессии.
  • bEnabled (in) – принимает значение CK_TRUE для установления секретного канала, CK_FALSE - для запрещения.
  • bExclusive (in) – принимает значение CK_TRUE, если секретный канал требуется в эксклюзивном режиме.
  • hPublicKey (in) – дескриптор открытого ключа, если секретный канал должен быть установлен на ключевых парах. Иначе принимает значение CK_INVALID_HANDLE.
  • pPrivateKeyValue (in) – буфер значения закрытого ключа, если секретный канал должен быть установлен на ключевых парах. Иначе принимает значение NULL.
  • ulPrivateKeyValueSize (in) – размер буфера значения закрытого ключа в байтах, если секретный канал должен быть установлен на ключевых парах. Иначе - 0.

Управление защищенным каналом передачи сообщений. Функция устанавливает нужное статус защищенного канала и возвращает значение типа JC_CT2_SECURE_MESSAGING_STATE:

  • 0 – Защищенный канал выключен;
  • 1 – Защищенный канал в процессе установки;
  • 2 – Защищенный канал включен;
  • 3 – Защищенный канал включен в эксклюзивном режиме.

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

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

Совет

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

Оглавление