Класс EventHandler

#include <QtCrypto>

Диаграмма кооперации класса QCA::EventHandler:

Граф кооперации

Сигналы

void	eventReady (int id, const QCA::Event &context)

Публичные функции

	EventHandler (QObject *parent=nullptr)
void	reject (int id)
void	start ()
void	submitKeyStoreEntryName (int id, const QString &entryName)
void	submitKeyStoreId (int id, const QString &keyStoreId)
void	submitKeyStoreName (int id, const QString &keyStoreName)
void	submitKeyStorePkcs11Provider (int id, const QString &pkcs11Provider)
void	submitKeyType (int id, const QString &keyType)
void	submitPassword (int id, const SecureArray &password)
void	tokenOkay (int id)

Дружественные функции и классы

class

Private

Подробное описание

Класс интерфейса для паролей, кодовых фраз, ПИН-кодов и обработчиков токенов.

Этот класс используется в клиентских приложениях для обработки предоставления паролей, кодовых фраз и ПИН-кодов пользователями, а также для указания того, что токены были вставлены правильно.

Концепция, лежащая в основе этого класса, заключается в том, что библиотека может вызывать события (обычно с использованием PasswordAsker или TokenAsker), которые могут (или не могут) обрабатываться приложением с помощью объекта-обработчика (в котором есть EventHandler или он является является EventHandler), который связан с сигналом eventReady().

Примеры

eventhandlerdemo.cpp и keyloader.cpp.

Описание конструкторов и деструктора

EventHandler()

QCA::EventHandler::EventHandler (QObject * parent = nullptr)

Конструктор.

Параметры

parent

Родительский объект для этого экземпляра

Описание методов

start()

void QCA::EventHandler::start ()

Обязательная функция для вызова после подключения сигнала к слоту в разрабатываемом приложении, включающем использование пароля, кодовой фразы, ПИН-кода или обработчика токена.

Примеры

keyloader.cpp.

submitPassword()

void QCA::EventHandler::submitPassword (int id, const SecureArray & password )

Функцию нужно вызвать, чтобы вернуть введённый пользователем пароль, кодовую фразу или PIN-код.

Параметры

id	Идентификатор, соответствующий запросу пароля
password	Введенный пользователем пароль, кодовая фраза или PIN-код

Примечание.

Параметр id такой же, как и в сигнале eventReady().

Примеры

keyloader.cpp.

tokenOkay()

void QCA::EventHandler::tokenOkay (int id)

Функция для вызова, чтобы указать, что токен был вставлен пользователем.

Параметры

id	Идентификатор, соответствующий запросу пароля

Примечание.

Параметр id такой же, как и в сигнале eventReady().

submitKeyStoreId()

void QCA::EventHandler::submitKeyStoreId (int id, const QString & keyStoreId )

Функцию нужно вызвать, чтобы вернуть введённый пользователем идентификатор хранилища ключей.

Параметры

id	Идентификатор, соответствующий запросу хранилища ключей
keyStoreId	Предоставленный пользователем идентификатор хранилища ключей.

Примечание.

Параметр id такой же, как и в сигнале eventReady().

submitKeyStoreName()

void QCA::EventHandler::submitKeyStoreName (int id, const QString & keyStoreName )

Функцию нужно вызвать, чтобы вернуть введённое пользователем название хранилища ключей.

Параметры

id	Идентификатор, соответствующий запросу хранилища ключей
keyStoreId	Предоставленное пользователем название хранилища ключей.

Примечание.

Параметр id такой же, как и в сигнале eventReady().

submitKeyStoreEntryName()

void QCA::EventHandler::submitKeyStoreEntryName (int id, const QString & entryName )

Функцию нужно вызвать, чтобы вернуть введённое пользователем название записи в хранилище ключей.

Параметры

id	Идентификатор, соответствующий запросу хранилища ключей
entryName	Предоставленное пользователем название записи в хранилище ключей.

Примечание.

Параметр id такой же, как и в сигнале eventReady().

submitKeyStorePkcs11Provider()

void QCA::EventHandler::submitKeyStorePkcs11Provider (int id, const QString & pkcs11Provider )

Функцию нужно вызвать, чтобы вернуть введённое пользователем название поставщика PKCS11 хранилища ключей.

Параметры

id	Идентификатор, соответствующий запросу хранилища ключей
pkcs11Provider	Предоставленное пользователем название поставщика PKCS11 хранилища ключей.

Примечание.

Параметр id такой же, как и в сигнале eventReady().

submitKeyType()

void QCA::EventHandler::submitKeyType (int id, const QString & keyType )

Функцию нужно вызвать, чтобы вернуть введённый пользователем тип ключа.

Параметры

id	Идентификатор, соответствующий запросу хранилища ключей
keytype	Текстовое представление типа ключа для отправки

Примечание.

Параметр id такой же, как и в сигнале eventReady().

reject()

void QCA::EventHandler::reject (int id)

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

Параметры

id	Идентификатор, соответствующий запросу пароля

Примечание.

Параметр id такой же, как и в сигнале eventReady().

Примеры

keyloader.cpp.

eventReady

void QCA::EventHandler::eventReady (int id, const QCA::Event & context )

signal

Сигнал, испускаемый, когда Event требует внимания.

Обычно данный сигнал подключается к совместимому слоту в обработчике обратного вызова.

Параметры

id	Идентификационный номер события
context	Информация о типе требуемого ответа

Примеры

eventhandlerdemo.cpp и keyloader.cpp.