Класс PasswordAsker

#include <QtCrypto>

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

[Легенда графа]

Сигналы

void	responseReady ()

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

bool	accepted () const
void	ask (Event::PasswordStyle pstyle, const KeyStoreInfo &keyStoreInfo, const KeyStoreEntry &keyStoreEntry, void *ptr)
void	ask (Event::PasswordStyle pstyle, const QString &fileName, void *ptr)
void	cancel ()
SecureArray	password () const
	PasswordAsker (QObject *parent=nullptr)
void	waitForResponse ()

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

class

Private

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

Пароль пользователя, кодовая фраза или обработчик PIN-кода.

Этот класс используется для получения пароля от пользователя.

Примеры

eventhandlerdemo.cpp.

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

PasswordAsker()

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

Создаёт новый объект PasswordAsker.

Параметры

parent

Родительский объект для этого QObject

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

ask() [1/2]

void QCA::PasswordAsker::ask (Event::PasswordStyle pstyle, const KeyStoreInfo & keyStoreInfo, const KeyStoreEntry & keyStoreEntry, void * ptr )

Ставит в очередь запрос пароля или кодовой фразы, связанный с хранилищем ключей.

Параметры

pstyle	Тип необходимой информации (например, PIN-код, кодовая фраза или пароль)
keyStoreInfo	Сведения о хранилище ключей, для которого требуется информация
keyStoreEntry	Элемент в хранилище ключей, для которого требуется информация (если применимо)
ptr	Непрозрачные данные, т. е. данные с неопределённой структурой

Примеры

eventhandlerdemo.cpp.

ask() [2/2]

void QCA::PasswordAsker::ask (Event::PasswordStyle pstyle, const QString & fileName, void * ptr )

Поставить в очередь запрос пароля или кодовой фразы, связанный с файлом.

Параметры

pstyle	Тип необходимой информации (например, PIN-код, кодовая фраза или пароль)
fileName	Имя файла, для которого требуется информация
ptr	Непрозрачные данные, т. е. данные с неопределённой структурой

cancel()

void QCA::PasswordAsker::cancel ()

Отменяет запрос, ожидающий пароль или кодовую фразу.

waitForResponse()

void QCA::PasswordAsker::waitForResponse ()

Блокирует до завершения запроса пароля или кодовой фразы.

При необходимости можно использовать сигнал responseReady вместо блокировки.

Примеры

eventhandlerdemo.cpp.

accepted()

bool QCA::PasswordAsker::accepted () const

Определяет, был ли принят пароль или кодовая фраза.

В этом контексте возвращаемое true указывает на то, что пользователь нажал кнопку «ОК» или аналогичную. Возвращаемое false указывает, что либо пользователь нажал кнопку «Отмена», либо что-то аналогичное, либо была вызвана функция cancel(), либо запрос всё ещё ожидает обработки.

password()

SecureArray QCA::PasswordAsker::password () const

Пароль, кодовая фраза или PIN-код, предоставленный пользователем в ответ на запрос.

Он может быть пустым.

Примеры

eventhandlerdemo.cpp.

responseReady

void QCA::PasswordAsker::responseReady ()

signal

Сигнал испускается, когда процесс запроса завершён.

Нужно проверить, принял ли пользователь ответ с помощью accepted(), прежде чем полагаться на password().