QCA::KeyStoreListContext

Search for usage in LXR

QCA::KeyStoreListContext Class Referenceabstract

#include <QtCrypto>

Inheritance diagram for QCA::KeyStoreListContext:

Signals

void busyEnd ()
 
void busyStart ()
 
void diagnosticText (const QString &str)
 
void storeUpdated (int id)
 
void updated ()
 

Public Member Functions

 KeyStoreListContext (Provider *p)
 
virtual KeyStoreEntryContextentry (int id, const QString &entryId)
 
virtual QList< KeyStoreEntryContext * > entryList (int id)=0
 
virtual KeyStoreEntryContextentryPassive (const QString &serialized)
 
virtual QList< KeyStoreEntry::TypeentryTypes (int id) const =0
 
virtual bool isReadOnly (int id) const
 
virtual QList< int > keyStores ()=0
 
virtual QString name (int id) const =0
 
virtual bool removeEntry (int id, const QString &entryId)
 
virtual void setUpdatesEnabled (bool enabled)
 
virtual void start ()
 
virtual QString storeId (int id) const =0
 
virtual KeyStore::Type type (int id) const =0
 
virtual QString writeEntry (int id, const Certificate &cert)
 
virtual QString writeEntry (int id, const CRL &crl)
 
virtual QString writeEntry (int id, const KeyBundle &kb)
 
virtual QString writeEntry (int id, const PGPKey &key)
 

Detailed Description

KeyStore provider

Note
This class is part of the provider plugin interface and should not be used directly by applications. You probably want KeyStore instead.

Definition at line 1973 of file qcaprovider.h.

Constructor & Destructor Documentation

◆ KeyStoreListContext()

QCA::KeyStoreListContext::KeyStoreListContext ( Provider p)
inline

Standard constructor.

Parameters
pthe Provider associated with this context

Definition at line 1982 of file qcaprovider.h.

Member Function Documentation

◆ busyEnd

void QCA::KeyStoreListContext::busyEnd ( )
signal

Emit this to leave the busy state.

When this object is first started with start(), it is assumed to be in the busy state. You must emit busyEnd() at some point, or QCA will never ask you about keystores.

◆ busyStart

void QCA::KeyStoreListContext::busyStart ( )
signal

Emit this when the provider is busy looking for keystores.

The provider goes into a busy state when it has reason to believe there are keystores present, but it still needs to check or query some devices to see for sure.

For example, if a smart card is inserted, then the provider may immediately go into a busy state upon detecting the insert. However, it may take some seconds before the smart card information can be queried and reported by the provider. Once the card is queried successfully, the provider would leave the busy state and report the new keystore.

When this object is first started with start(), it is assumed to be in the busy state, so there is no need to emit this signal at the beginning.

◆ diagnosticText

void QCA::KeyStoreListContext::diagnosticText ( const QString str)
signal

Emitted when there is diagnostic text to report.

Parameters
strthe diagnostic text

◆ entry()

virtual KeyStoreEntryContext* QCA::KeyStoreListContext::entry ( int  id,
const QString entryId 
)
virtual

Returns a single entry in the store, if the entry id is already known.

If the entry does not exist, the function returns 0.

The caller is responsible for deleting the returned entry object.

Parameters
idthe id for the store context
entryIdthe entry to retrieve

◆ entryList()

virtual QList<KeyStoreEntryContext *> QCA::KeyStoreListContext::entryList ( int  id)
pure virtual

Returns the entries of the store, or an empty list if the integer context id is invalid.

The caller is responsible for deleting the returned entry objects.

Parameters
idthe id for the store context

◆ entryPassive()

virtual KeyStoreEntryContext* QCA::KeyStoreListContext::entryPassive ( const QString serialized)
virtual

Returns a single entry, created from the serialization string of a previous entry (using KeyStoreEntryContext::serialize()).

If the serialization string cannot be parsed by this provider, or the entry cannot otherwise be created, the function returns 0.

The caller is responsible for deleting the returned entry object.

This function must be thread-safe.

Parameters
serializedthe serialized data to create the entry from

◆ entryTypes()

virtual QList<KeyStoreEntry::Type> QCA::KeyStoreListContext::entryTypes ( int  id) const
pure virtual

Returns the types supported by the store, or an empty list if the integer context id is invalid.

This function should return all supported types, even if the store doesn't actually contain entries for all of the types.

Parameters
idthe id for the store context

◆ isReadOnly()

virtual bool QCA::KeyStoreListContext::isReadOnly ( int  id) const
virtual

Returns true if the store is read-only.

If the integer context id is invalid, this function should return true.

Parameters
idthe id for the store context

◆ keyStores()

virtual QList<int> QCA::KeyStoreListContext::keyStores ( )
pure virtual

Returns a list of integer context ids, each representing a keystore instance.

If a keystore becomes unavailable and then later becomes available again (for example, if a smart card is removed and then the same one is inserted again), the integer context id must be different than last time.

◆ name()

virtual QString QCA::KeyStoreListContext::name ( int  id) const
pure virtual

Returns the friendly name of the store, or an empty string if the integer context id is invalid.

Parameters
idthe id for the store context

◆ removeEntry()

virtual bool QCA::KeyStoreListContext::removeEntry ( int  id,
const QString entryId 
)
virtual

Remove an entry from the store.

Returns true if the entry is successfully removed, otherwise false.

Parameters
idthe id for the store context
entryIdthe entry to remove from the store

◆ setUpdatesEnabled()

virtual void QCA::KeyStoreListContext::setUpdatesEnabled ( bool  enabled)
virtual

Enables or disables update events.

The updated() and storeUpdated() signals might not be emitted if updates are not enabled.

Parameters
enabledwhether update notifications are enabled (true) or disabled (false)

◆ start()

virtual void QCA::KeyStoreListContext::start ( )
virtual

Starts the keystore provider.

◆ storeId()

virtual QString QCA::KeyStoreListContext::storeId ( int  id) const
pure virtual

Returns the string id of the store, or an empty string if the integer context id is invalid.

The string id of the store should be unique to a single store, and it should persist between availability/unavailability. For example, a smart card that is removed and inserted again should have the same string id (despite having a new integer context id).

Parameters
idthe id for the store context

◆ storeUpdated

void QCA::KeyStoreListContext::storeUpdated ( int  id)
signal

Indicates that the entry list of a keystore has changed (entries added, removed, or modified)

Parameters
idthe id of the key store that has changed

◆ type()

virtual KeyStore::Type QCA::KeyStoreListContext::type ( int  id) const
pure virtual

Returns the type of the specified store, or -1 if the integer context id is invalid.

Parameters
idthe id for the store context

◆ updated

void QCA::KeyStoreListContext::updated ( )
signal

Indicates the list of keystores has changed, and that QCA should call keyStores() to obtain the latest list.

◆ writeEntry() [1/4]

virtual QString QCA::KeyStoreListContext::writeEntry ( int  id,
const Certificate cert 
)
virtual

Write a Certificate to the store.

Returns the entry id of the new item, or an empty string if there was an error writing the item.

Parameters
idthe id for the store context
certthe certificate to add to the store

◆ writeEntry() [2/4]

virtual QString QCA::KeyStoreListContext::writeEntry ( int  id,
const CRL crl 
)
virtual

Write a CRL to the store.

Returns the entry id of the new item, or an empty string if there was an error writing the item.

Parameters
idthe id for the store context
crlthe revocation list to add to the store

◆ writeEntry() [3/4]

virtual QString QCA::KeyStoreListContext::writeEntry ( int  id,
const KeyBundle kb 
)
virtual

Write a KeyBundle to the store.

Returns the entry id of the new item, or an empty string if there was an error writing the item.

Parameters
idthe id for the store context
kbthe key bundle to add to the store

◆ writeEntry() [4/4]

virtual QString QCA::KeyStoreListContext::writeEntry ( int  id,
const PGPKey key 
)
virtual

Write a PGPKey to the store.

Returns the entry id of the new item, or an empty string if there was an error writing the item.

Parameters
idthe id for the store context
keythe PGP key to add to the store

The documentation for this class was generated from the following file:
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Thu Nov 30 2023 03:49:13 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.