#include <QtCrypto>
Public Types | |
enum | PasswordStyle { StylePassword, StylePassphrase, StylePIN } |
enum | Source { KeyStore, Data } |
enum | Type { Password, Token } |
Public Member Functions | |
Event (const Event &from) | |
Event () | |
QString | fileName () const |
bool | isNull () const |
KeyStoreEntry | keyStoreEntry () const |
KeyStoreInfo | keyStoreInfo () const |
Event & | operator= (const Event &from) |
PasswordStyle | passwordStyle () const |
void * | ptr () const |
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 () |
Events are produced in response to the library's need for some user intervention, such as entering a pin or password, or inserting a cryptographic token.
Event is an abstraction, so you can handle this need in a way that makes sense for your application.
password variation
If the Type of Event is Password, PasswordStyle tells you whether it is a PIN, passphrase or password.
enum QCA::Event::Source |
Source of the event
Events are associated with access to a KeyStore, or access to a file (or bytearray/stream or equivalent). This tells you the type of source that caused the Event.
fileName() for the name, if source is Event::Data
keyStoreInfo() and keyStoreEntry() for the keystore and entry, if the source is Event::KeyStore
KeyStore | KeyStore generated the event. |
Data | File or bytearray generated the event. |
enum QCA::Event::Type |
QCA::Event::Event | ( | ) |
Constructor.
QCA::Event::~Event | ( | ) |
Destructor.
QString QCA::Event::fileName | ( | ) | const |
Name or other identifier for the file or byte array associated with this event.
This is not meaningful unless the Source is Data.
bool QCA::Event::isNull | ( | ) | const |
KeyStoreEntry QCA::Event::keyStoreEntry | ( | ) | const |
The KeyStoreEntry associated with this event.
This is not meaningful unless the Source is KeyStore.
KeyStoreInfo QCA::Event::keyStoreInfo | ( | ) | const |
PasswordStyle QCA::Event::passwordStyle | ( | ) | const |
the style of password required.
This is not meaningful unless the Type is Event::Password.
void* QCA::Event::ptr | ( | ) | const |
opaque data
void QCA::Event::setPasswordData | ( | PasswordStyle | pstyle, | |
const QString & | fileName, | |||
void * | ptr | |||
) |
Set the values for this Event.
This creates a Password type event, for a file.
pstyle | the style of information required (e.g. PIN, password or passphrase) | |
fileName | the name of the file (or other identifier) that the information is required for | |
ptr | opaque data |
void QCA::Event::setPasswordKeyStore | ( | PasswordStyle | pstyle, | |
const KeyStoreInfo & | keyStoreInfo, | |||
const KeyStoreEntry & | keyStoreEntry, | |||
void * | ptr | |||
) |
Set the values for this Event.
This creates a Password type event, for a keystore.
pstyle | the style of information required (e.g. PIN, password or passphrase) | |
keyStoreInfo | info about the keystore that the information is required for | |
keyStoreEntry | the entry in the keystore that the information is required for | |
ptr | opaque data |
void QCA::Event::setToken | ( | const KeyStoreInfo & | keyStoreInfo, | |
const KeyStoreEntry & | keyStoreEntry, | |||
void * | ptr | |||
) |
Set the values for this Event.
This creates a Token type event.
keyStoreInfo | info about the keystore that the token is required for | |
keyStoreEntry | the entry in the keystore that the token is required for | |
ptr | opaque data |
Source QCA::Event::source | ( | ) | const |
Type QCA::Event::type | ( | ) | const |