Класс Event
#include <QtCrypto>
Публичные типы
| enum | PasswordStyle { StylePassword , StylePassphrase , StylePIN } |
| enum | Source { KeyStore , Data } |
| enum | Type { Password , Token , KeyStoreId , KeyStoreName , KeyStoreEntryName , KeyStorePkcs11Provider , KeyType } |
Публичные функции
| Event () | |
| Event (const Event &from) | |
| QString | fileName () const |
| bool | isNull () const |
| KeyStoreEntry | keyStoreEntry () const |
| KeyStoreInfo | keyStoreInfo () const |
| Event & | operator= (const Event &from) |
| PasswordStyle | passwordStyle () const |
| void * | ptr () const |
| void | setKeyStoreEntryName (const KeyStoreInfo &keyStoreInfo, void *ptr) |
| void | setKeyStoreId (const KeyStoreInfo &keyStoreInfo, void *ptr) |
| void | setKeyStoreName (const KeyStoreInfo &keyStoreInfo, void *ptr) |
| void | setKeyStorePkcs11Provider (const KeyStoreInfo &keyStoreInfo, void *ptr) |
| void | setKeyType (const KeyStoreInfo &keyStoreInfo, const QString &keyId, void *ptr) |
| void | setPasswordData (PasswordStyle pstyle, const QString &fileName, void *ptr) |
| void | setPasswordKeyStore (PasswordStyle pstyle, const KeyStoreInfo &keyStoreInfo, const KeyStoreEntry &keyStoreEntry, void *ptr) |
| void | setToken (const KeyStoreInfo &keyStoreInfo, const KeyStoreEntry &keyStoreEntry, void *ptr) |
| Source | source () const |
| Type | type () const |
| ~Event () |
Подробное описание
Асинхронное событие.
События создаются в ответ на потребность библиотеки в некотором вмешательстве пользователя, таком как ввод PIN-кода или пароля или вставка криптографического токена.
Event — это абстракция, поэтому необходимо использовать
его, в зависимости от разрабатываемого приложения.
Примеры
eventhandlerdemo.cpp и keyloader.cpp.
Описание перечислений
Type
| enum QCA::Event::Type |
Тип события.
См. также type().
| Password | Запрос пароля, PIN-кода или кодовой фразы |
| Token | Запрос токена |
| KeyStoreId | Запрос идентификатора хранилища ключей |
| KeyStoreName | Запрос названия хранилища ключей |
| KeyStoreEntryName | Запрос названия записи хранилища ключей |
| KeyStorePkcs11Provider | Запрос криптопровайдера PKCS11 хранилища ключей |
| KeyType | Запрос типа ключа во время создания |
Source
| enum QCA::Event::Source |
Источник события.
События связаны с доступом к KeyStore
или доступом к файлу (или массиву байтов/потоку или эквивалентному). Метод сообщает тип источника,
вызвавшего Event.
См. также source()
fileName() для имени, если source является Event::Data.
keyStoreInfo() и keyStoreEntry() для хранилища ключей и записи, если source является Event::KeyStore.
| KeyStore | KeyStore сгенерировал событие |
| Data | Файл или массив байтов сгенерировал событие |
PasswordStyle
| enum QCA::Event::PasswordStyle |
Изменение пароля.
Если тип Event — пароль, PasswordStyle сообщит,
является ли это PIN-кодом, парольной фразой или паролем.
См. также passwordStyle()
| StylePassword | У пользователя должен быть запрошен ввод пароля |
| StylePassphrase | У пользователя должен быть запрошен ввод кодовой фразы |
| StylePIN | У пользователя должен быть запрошен ввод PIN-кода |
Описание конструкторов и деструктора
Event() [1/2]
| QCA::Event::Event () |
Конструктор.
Event() [2/2]
| QCA::Event::Event (const Event & from) |
Конструктор копирования.
Параметры
| from | Event для копирования |
~Event()
| QCA::Event::~Event () |
Деструктор.
Описание методов
operator=()
| Event & QCA::Event::operator= (const Event & from) |
Оператор присваивания.
Параметры
| from | Event для копирования |
isNull()
| bool QCA::Event::isNull () const |
Проверка, правильно ли настроено это событие.
Примеры
type()
| Type QCA::Event::type () const |
Тип этого события.
Примеры
eventhandlerdemo.cpp и keyloader.cpp.
source()
| Source QCA::Event::source () const |
Источник этого события.
Примеры
passwordStyle()
| PasswordStyle QCA::Event::passwordStyle () const |
Стиль требуемого пароля.
Действие не имеет смысла, если тип события не Event::Password.
См. также PasswordStyle
Примеры
keyStoreInfo()
| KeyStoreInfo QCA::Event::keyStoreInfo () const |
Информация о KeyStore, связанным с этим событием.
Она не имеет смысла, если источник не KeyStore.
keyStoreEntry()
| KeyStoreEntry QCA::Event::keyStoreEntry () const |
KeyStoreEntry, связанная с этим событием.
Она не имеет смысла, если источник не KeyStore.
fileName()
| QString QCA::Event::fileName () const |
Имя или другой идентификатор файла или массива байтов, связанного с этим событием.
Оно не имеет смысла, если источник не является данными.
Примеры
ptr()
| void * QCA::Event::ptr () const |
Непрозрачные данные, т. е. данные с неопределённой структурой
setPasswordKeyStore()
| void QCA::Event::setPasswordKeyStore (PasswordStyle pstyle, const KeyStoreInfo & keyStoreInfo, const KeyStoreEntry & keyStoreEntry, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа пароля для хранилища ключей.
Параметры
| pstyle | Требуемый тип информации (например, PIN-код, пароль или кодовая фраза) |
| keyStoreInfo | Информация о хранилище ключей, для которого требуется информация |
| keyStoreEntry | Запись в хранилище ключей, для которой требуется информация |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setPasswordData()
| void QCA::Event::setPasswordData (PasswordStyle pstyle, const QString & fileName, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа пароля для файла.
Параметры
| pstyle | Требуемый тип информации (например, PIN-код, пароль или кодовая фраза) |
| fileName | Имя файла (или другой идентификатор), для которого требуется информация |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setToken()
| void QCA::Event::setToken (const KeyStoreInfo & keyStoreInfo, const KeyStoreEntry & keyStoreEntry, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа Token.
Параметры
| keyStoreInfo | Информация о хранилище ключей, для которого требуется токен |
| keyStoreEntry | Запись в хранилище ключей, для которой требуется токен |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setKeyStoreId()
| void QCA::Event::setKeyStoreId (const KeyStoreInfo & keyStoreInfo, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа KeystoreId.
Параметры
| keyStoreInfo | Информация о хранилище ключей, для которого требуется токен |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setKeyStoreName()
| void QCA::Event::setKeyStoreName (const KeyStoreInfo & keyStoreInfo, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа KeystoreName.
Параметры
| keyStoreInfo | Информация о хранилище ключей, для которого требуется токен |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setKeyStoreEntryName()
| void QCA::Event::setKeyStoreEntryName (const KeyStoreInfo & keyStoreInfo, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа KeyStoreObjectName.
Параметры
| keyStoreInfo | Информация о хранилище ключей, для которого требуется токен |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setKeyStorePkcs11Provider()
| void QCA::Event::setKeyStorePkcs11Provider (const KeyStoreInfo & keyStoreInfo, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа KeyStorePkcs11Provider.
Параметры
| keyStoreInfo | Информация о хранилище ключей, для которого требуется токен |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |
setKeyType()
| void QCA::Event::setKeyType (const KeyStoreInfo & keyStoreInfo, const QString & keyId, void * ptr ) |
Устанавливает значения для этого Event.
Метод создаёт событие типа KeyType.
Параметры
| keyStoreInfo | Информация о хранилище, для которого создан ключ |
| keyId | ID создаваемого ключа |
| ptr | Непрозрачные данные, т. е. данные с неопределённой структурой |