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