Anchor

	1
	1

Table of Contents

maxLevel	2
outline	true
style	none

...

CKR_OPERATION_NOT_INITIALIZED.

к содержанию ↑

Функции для работы с флеш-памятью
AUI Button
button-style Primary
button-text подробнее про управление памятью
button-url https://dev.rutoken.ru/pages/viewpage.action?pageId=13795364#id-%D0%92%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D1%87%D0%B5%D1%80%D0%B5%D0%B7PKCS#11-%D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%D0%BF%D0%B0%D0%BC%D1%8F%D1%82%D1%8C%D1%8E%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D0%AD%D0%A6%D0%9FFlash

C_EX_GetDriveSize()

Назначение

...

Code Block

collapse	true

printf("\nChanging volume attributes");
rv = pFunctionListEx->C_EX_ChangeVolumeAttributes(aSlots[0],        // Идентификатор слота с подключенным токеном
                                                    CKU_SO,         // Владелец раздела
                                                    SO_PIN,         // PIN-код владельца раздела
                                                    sizeof(SO_PIN), // Длина PIN-кода владельца раздела
                                                    VolumeRO,       // Идентификатор раздела
                                                    ACCESS_MODE_RW, // Новые права доступа к разделу
                                                    CK_TRUE);       // CK_TRUE - постоянное изменение атрибутов, CK_FALSE - временное изменение атрибутов
if (rv != CKR_OK)
    printf(" -> Failed\n");
else
    printf(" -> OK\n");

к содержанию ↑

Функции для работы с

...

журналом
AUI Button
button-style Primary
button-text подробнее про журнал
button-url https://dev.rutoken.ru/pages/viewpage.action?pageId=13795364#id-%D0%92%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D1%87%D0%B5%D1%80%D0%B5%D0%B7PKCS#11-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%D1%81%D0%B6%D1%83%D1%80%D0%BD%D0%B0%D0%BB%D0%BE%D0%BC%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BDPINPad

C_EX_GetJournal()

Назначение

...

Code Block

collapse	true

CK_BYTE_PTR           pJournal = NULL_PTR;          // Указатель на значение журнала
CK_ULONG              ulJournalSize = 0;            // Размер журнала
  
while(TRUE)
{
...
    /* Получить размер журнала */
    printf("Getting journal size");
    rv = pFunctionListEx->C_EX_GetJournal(aSlots[0],      // Хэндл слота с подключенным токеном
                                          NULL_PTR,       // Указатель на журнал
                                          &ulJournalSize);// Размер журнала
    if (rv != CKR_OK)
    {
        printf(" -> Failed\n");
        break;
    }
    printf(" -> OK\n");
  
    pJournal = (CK_BYTE*)malloc(ulSlotCount * sizeof(CK_BYTE));
    if (pJournal == NULL)
    {
        printf("Memory allocation for pJournal failed! \n");
        break;
    }
    memset(pJournal, 0, (ulJournalSize * sizeof(CK_BYTE)));
  
    /* Получить журнал */
    printf("Getting journal");
    rv = pFunctionListEx->C_EX_GetJournal(aSlots[0],       // Хэндл слота с подключенным токеном
                                          pJournal,       // Указатель на журнал
                                          &ulJournalSize);// Размер журнала
    if (rv != CKR_OK)
    {
        printf(" -> Failed %X\n", (int)rv);
        break;
    }
    printf(" -> OK\n");
  
    ...
    break;
}

к содержанию ↑

Функции для работы с подписью без

...

отображения
AUI Button
button-style Primary
button-text подробнее про подпись без отображения
button-url https://dev.rutoken.ru/pages/viewpage.action?pageId=13795364#id-%D0%92%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D1%87%D0%B5%D1%80%D0%B5%D0%B7PKCS#11-%D0%9E%D1%81%D0%BE%D0%B1%D0%B5%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D0%B8%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85%D0%BD%D0%B0%D0%A0%D1%83%D1%82%D0%BE%D0%BA%D0%B5%D0%BDPINPad

C_EX_SignInvisibleInit()

Назначение

Функция инициализирует процесс подписи сообщения без отображения на экране.

Синтаксис

Code Block

C_EX_SignInvisibleInit()

Назначение

Функций инициализирует процесс подписи сообщения без отображения на экране.

Синтаксис

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisibleInit)( CK_SESSION_HANDLE hSession, CK_MECHANISM_PTR pMechanism, CK_OBJECT_HANDLE hKey );

Параметры

hSession	[in]	дескриптор сессии
pMechanism	[in]	механизм подписи
hKey	[in]	дескриптор ключа для подписи

...

C_EX_SignInvisible()

Назначение

Функций Функция осуществляет процесс подписи сообщения без отображения на экране, вызывается после функции C_EX_SignInvisibleInit.

Синтаксис

...

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisible)( CK_SESSION_HANDLE hSession, CK_BYTE_PTR pData, CK_ULONG ulDataLen, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureLen );

...

Параметры

...

hSession
[in] дескриптор сессии
pData
[in] указатель на буфер данных для подписи
ulDataLen
[in] размер данных для подписи в байтах
pSignature
[out] указатель на буфер с подписью
pulSignatureLen
[out] размер буфера с подписью
...
подписью

Возвращаемые значения

...

CKR_OK – функция выполнена успешно.

Пример

Code Block

collapse	true

/* Данные для подписи в виде двоичной строки */
CK_BYTE pbtData[] = { 0x3C, 0x21, 0x50, 0x49, 0x4E, 0x50, 0x41, 0x44, 0x46, 0x49, 0x4C, 0x45, 0x20, 0x52, 0x55, 0x3E,
                      0x3C, 0x21, 0x3E, 0xED, 0xE5, 0xE2, 0xE8, 0xE4, 0xE8, 0xEC, 0xFB, 0xE9, 0x20, 0xF2, 0xE5, 0xEA,
                      0xF1, 0xF2, 0x3C, 0x4E, 0x3E, 0xD4, 0xC8, 0xCE, 0x3A, 0x3C, 0x56, 0x3E, 0xCF, 0xE5, 0xF2, 0xF0,
                      0xEE, 0xE2, 0x20, 0xCF, 0xE5, 0xF2, 0xF0, 0x20, 0xCF, 0xE5, 0xF2, 0xF0, 0xEE, 0xE2, 0xE8, 0xF7,
                      0x20, 0xCC, 0xEE, 0xF1, 0xEA, 0xE2, 0xE0, 0x2C, 0x20, 0xCF, 0xE8, 0xEE, 0xED, 0xE5, 0xF0, 0xF1,
                      0xEA, 0xE0, 0xFF, 0x20, 0xF3, 0xEB, 0x2C, 0x20, 0xE4, 0x2E, 0x20, 0x33, 0x2C, 0x20, 0xEA, 0xE2,
                      0x2E, 0x20, 0x37, 0x32 };
  
CK_BYTE_PTR pbtSignature = NULL_PTR;                 // Указатель на буфер, содержащий подпись для исходных данных
CK_ULONG ulSignatureSize = 0;                        // Размер буфера, содержащего подпись для исходных данных, в байтах
  
while(TRUE)
{
    ...
  
    /* Определить размер подписи*/
    printf("C_EX_SignInvisible step 1");
    rv = pFunctionList->C_EX_SignInvisible(hSession,            // Хэндл сессии
                                           pbtData,             // Буфер с данными для подписи
                                           arraysize(pbtData),  // Длина подписываемых данных
                                           pbtSignature,        // Буфер с подписью
                                           &ulSignatureSize);   // Длина подписи
    if (rv != CKR_OK)
    {
        printf(" -> Failed\n");
        break;
    }
    printf(" -> OK\n");
 
    pbtSignature = (CK_BYTE*)malloc(ulSignatureSize);
    if (pbtSignature  == NULL)
    {
        printf("Memory allocation for pbtSignature failed! \n");
        break;
    }
    memset( pbtSignature,
            0,
            ulSignatureSize * sizeof(CK_BYTE));
 
    /* Подписать исходные данные */
    printf("C_EX_SignInvisible step 2");
    rv = pFunctionList->C_EX_SignInvisible(hSession,            // Хэндл сессии
                                           pbtData,             // Буфер с данными для подписи
                                           arraysize(pbtData),  // Длина подписываемых данных
                                           pbtSignature,        // Буфер с подписью
                                           &ulSignatureSize);   // Длина подписи
    if (rv != CKR_OK)
    {
        printf(" -> Failed\n");
        break;
    }
    printf(" -> OK\n");
}

к содержанию ↑

Функции для работы с беспроводным каналом связи
AUI Button
button-style Primary
button-text подробнее про Secure Messaging
button-url https://dev.rutoken.ru/pages/viewpage.action?pageId=10059883

C_EX_LoadActivationKey()

Назначение

Активирует защищенный канал связи с токеном с использованием пароля (поддерживается только в 20-й версии прошивки)

Синтаксис

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisible)( CK_SESSION_HANDLE hSession, CK_BYTE_PTR key, CK_ULONG keySize );

Параметры

hSession	[in]	дескриптор сессии
key	[in]	указатель на пароль
keySize	[in]	длина пароля

Возвращаемые значения

CKR_OK – функция выполнена успешно.

к содержанию ↑

C_EX_SetActivationPassword()

Назначение

Активирует защищенный канал связи с токеном с использованием пароля (поддерживается с 21-й версии прошивки).

Синтаксис

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisible)( CK_SLOT_ID slotID, CK_UTF8CHAR_PTR password );

Параметры

hSession	[in]	дескриптор сессии
password	[in]	пароль активации

Возвращаемые значения

CKR_OK – функция выполнена успешно.

к содержанию ↑

C_EX_GenerateActivationPassword()

Назначение

Генерирует пароль для активации защищенного канала связи с токеном.

Синтаксис

Code Block

CK_DEFINE_FUNCTION(CK_RV, C_EX_GenerateActivationPassword)(
  CK_SESSION_HANDLE     hSession,
  CK_ULONG              ulPasswordNumber,
  CK_UTF8CHAR_PTR       pPassword,
  CK_ULONG_PTR          pulPasswordSize,
  CK_ULONG              ulPasswordCharacterSet
);

Параметры

hSession	[in]	дескриптор сессии
ulPasswordNumber
pPassword	[out]
pulPasswordSize	[out]
ulPasswordCharacterSet	[in]

Возвращаемые значения

CKR_OK – функция выполнена успешно.

к содержанию ↑

C_EX_TokenManage()

Назначение

Управляет режимом работы токена и таймаутом беспроводного соединения

Синтаксис

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_GenerateActivationPassword)( CK_SESSION_HANDLE hSession, CK_ULONG ulMode, CK_VOID_PTR pValue );

Параметры

hSession	[in]	дескриптор сессии
ulMode	[in]
pValue	[in]

Возвращаемые значения

CKR_OK – функция выполнена успешно.

к содержанию ↑

Функции специального назначения

C_EX_FreeBuffer()

Назначение

Функция освобождает память, выделенную другими расширенными функциями, например C_EX_GetCertificateInfoText.

Синтаксис

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_FreeBuffer)( CK_BYTE_PTR pBuffer );

Параметры

pBuffer

[in]

указатель на буфер

Возвращаемые значения

CKR_OK – функция выполнена успешно.

...

к содержанию ↑

C_EX_SetLocalPIN()

Назначение

Функция устанавливает локальный PIN-код, если он не был установлен или меняет локальный PIN-код, если он был установлен заранее.

Синтаксис

Code Block

CK_DEFINE_FUNCTION(CK_RV, C_EX_SetLocalPIN)(
	CK_SLOT_ID 			slotID,
	CK_UTF8CHAR_PTR 	pUserPin,      // или pOldLocalPin
	CK_ULONG 			ulUserPinLen,  // или pOldLocalPinLen
	CK_UTF8CHAR_PTR 	pNewLocalPin,
	CK_ULONG 			ulNewLocalPinLen,
	CK_ULONG 			ulLocalID
);

Параметры

slotID	[in]	идентификатор слота, к которому подключен токен
pUserPin или pOldLocalPin	[in]	указатель на текущий PIN-код Пользователя или на текущий локальный PIN-код
ulUserPinLen или pOldLocalPinLen	[in]	длина текущего PIN-кода Пользователя или длина текущего локального PIN-кода
pNewLocalPin	[in]	указатель на новый Локальный PIN-код
ulNewLocalPinLen	[in]	длина нового Локального PIN-кода
ulLocalID	[in]	идентификатор Локального PIN-кода

Возвращаемые значения

CKR_OK – функция выполнена успешно.

...

Page tree

Pages … Портал документации Рутокен Высокоуровневые программные интерфейсы PKCS#11 Справочник PKCS#11 Описание функций расширения Page History

Versions Compared

Old Version 18

New Version 19

Key

C_EX_GetDriveSize()

Назначение

Функции для работы с

C_EX_GetJournal()

Назначение

Функции для работы с подписью без

C_EX_SignInvisibleInit()

Назначение

Синтаксис

C_EX_SignInvisibleInit()

Назначение

Синтаксис

Параметры

C_EX_SignInvisible()

Назначение

Синтаксис

Code BlockCK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisible)( CK_SESSION_HANDLE hSession, CK_BYTE_PTR pData, CK_ULONG ulDataLen, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureLen );...

Параметры

Возвращаемые значения

Пример

Функции для работы с беспроводным каналом связи AUI Buttonbutton-stylePrimarybutton-textподробнее про Secure Messagingbutton-urlhttps://dev.rutoken.ru/pages/viewpage.action?pageId=10059883

C_EX_LoadActivationKey()

Назначение

Параметры

Возвращаемые значения

C_EX_SetActivationPassword()

Назначение

Синтаксис

Параметры

Возвращаемые значения

C_EX_GenerateActivationPassword()

Назначение

Синтаксис

Параметры

Возвращаемые значения

C_EX_TokenManage()

Назначение

Параметры

Возвращаемые значения

Функции специального назначения

C_EX_FreeBuffer()

Назначение

Синтаксис

Параметры

Возвращаемые значения

C_EX_SetLocalPIN()

Назначение

Синтаксис

Параметры

Возвращаемые значения

Pages

Портал документации Рутокен
Высокоуровневые программные интерфейсы
PKCS#11
Справочник PKCS#11
Описание функций расширения

Page History

Code Block
CK_DEFINE_FUNCTION(CK_RV, C_EX_SignInvisible)( CK_SESSION_HANDLE hSession, CK_BYTE_PTR pData, CK_ULONG ulDataLen, CK_BYTE_PTR pSignature, CK_ULONG_PTR pulSignatureLen );
...

Функции для работы с беспроводным каналом связи
AUI Button
button-style Primary
button-text подробнее про Secure Messaging
button-url https://dev.rutoken.ru/pages/viewpage.action?pageId=10059883