Класс 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 | Непрозрачные данные, т. е. данные с неопределённой структурой |