QCA::EventHandler Class Reference
[QCA user API]

Interface class for password / passphrase / PIN and token handlers. More...

#include <QtCrypto>

Inheritance diagram for QCA::EventHandler:

[legend]

List of all members.

Signals
void	eventReady (int id, const QCA::Event &context)
Public Member Functions
	EventHandler (QObject *parent=0)
	~EventHandler ()
void	reject (int id)
void	start ()
void	submitPassword (int id, const SecureArray &password)
void	tokenOkay (int id)

---

Detailed Description

Interface class for password / passphrase / PIN and token handlers.

This class is used on client side applications to handle the provision of passwords, passphrases and PINs by users, and to indicate that tokens have been correctly inserted.

The concept behind this class is that the library can raise events (typically using PasswordAsker or TokenAsker), which may (or may not) be handled by the application using a handler object (that has-a EventHandler, or possibly is-a EventHandler) that is connected to the eventReady() signal.

Definition at line 1442 of file qca_core.h.

---

Constructor & Destructor Documentation

QCA::EventHandler::EventHandler

(

QObject *

parent = 0

)

Constructor.

Parameters:

parent

the parent object for this object

Definition at line 1870 of file qca_core.cpp.

QCA::EventHandler::~EventHandler

(

)

Definition at line 1876 of file qca_core.cpp.

---

Member Function Documentation

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

signal emitted when an Event requires attention.

You typically need to connect this signal to a compatible slot in your callback handler

Parameters:

	id	the identification number for the event
	context	information about the type of response required

void QCA::EventHandler::reject

(

int

id

)

function to call to indicate that the user declined to provide a password, passphrase, PIN or token.

Parameters:

id

the id corresponding to the password request

Note:

the id parameter is the same as that provided in the eventReady() signal.

Definition at line 1913 of file qca_core.cpp.

void QCA::EventHandler::start

(

)

mandatory function to call after connecting the signal to a slot in your application specific password / passphrase / PIN or token handler

Definition at line 1889 of file qca_core.cpp.

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

function to call to return the user provided password, passphrase or PIN.

Parameters:

	id	the id corresponding to the password request
	password	the user-provided password, passphrase or PIN.

Note:

the id parameter is the same as that provided in the eventReady() signal.

Definition at line 1895 of file qca_core.cpp.

void QCA::EventHandler::tokenOkay

(

int

id

)

function to call to indicate that the token has been inserted by the user.

Parameters:

id

the id corresponding to the password request

Note:

the id parameter is the same as that provided in the eventReady() signal.

Definition at line 1904 of file qca_core.cpp.

---

The documentation for this class was generated from the following files:

• qca_core.h
• qca_core.cpp