Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

hSession

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

ulMode

[in]

режим работы функции:

MODE_GET_LOCAL_PIN_INFO – получение информации о локальных PIN-кодах

MODE_GET_PIN_SET_TO_BE_CHANGED – получение информации об принудительной смене PIN-кода

MODE_RESTORE_FACTORY_DEFAULTS – расширенная инициализация токена

MODE_GET_IMIT – получение имитовтавки (работает на ST23 2.0)

pValue

[out] 
  • При режиме MODE_GET_LOCAL_PIN_INFO – указатель, на структуру CK_LOCAL_PIN_INFO:
    typedef struct CK_LOCAL_PIN_INFO {
        CK_ULONG ulPinID;
        CK_ULONG ulMinSize;
        CK_ULONG ulMaxSize;
        CK_ULONG ulMaxRetryCount;
        CK_ULONG ulCurrentRetryCount;
        CK_FLAGS flags;
    } CK_LOCAL_PIN_INFO;

    ulPinID – идентификатор локального PIN-кода (входной параметр).
  • При режиме MODE_GET_PIN_SET_TO_BE_CHANGED – указатель тип пользователя (CKU_USER или CKU_SO), для которого хотим узнать установлен ли флаг принудительной смены PIN-кода.При режиме MODE_GET_PIN_SET_TO_BE_CHANGED – указатель на структуру CK_VENDOR_RESTORE_FACTORY_DEFAULTS_PARAMS
    typedef struct CK_VENDOR_RESTORE_FACTORY_DEFAULTS_PARAMS {
        CK_ULONG ulSizeofThisStructure;
        CK_BYTE_PTR pAdminPin;
        CK_ULONG ulAdminPinLen;
        CK_RUTOKEN_INIT_PARAM_PTR pInitParam;
        CK_BYTE_PTR pNewEmitentKey;
        CK_ULONG ulNewEmitentKeyLen;
        CK_ULONG ulNewEmitentKeyRetryCount;
    } CK_VENDOR_RESTORE_FACTORY_DEFAULTS_PARAMS;
    CK_RUTOKEN_INIT_PARAM_PTR – описание структуры в заголовочном файле rtpkcs11t.h
    pNewEmitentKey– ключ Эмитента
    ulNewEmitentKeyRetryCount – количество попыток доступа к ключу ЭмитентаПри режиме MODE_GET_IMIT – указатель на структуру CK_TOKEN_IMIT_DATA 
    typedef struct CK_TOKEN_IMIT_DATA {
        CK_BYTE bMode;
        CK_BYTE pbGostSymmetricKey[32];
        CK_BYTE pbImit[8];
    } CK_TOKEN_IMIT_DATA;
    bMode IMIT_MODE_MASK_PATCH или IMIT_MODE_MASK (входной параметр)
    pbGostSymmetricKey – значение симметричного ключа (входной параметр)

Для режима работы функции MODE_GET_LOCAL_PIN_INFO в pValue возвращается указатель массив структур типа CK_LOCAL_PIN_INFO:

...