1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
3
<title>Qt Cryptographic Architecture: QCA::KeyStore Class Reference</title>
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
5
<link href="tabs.css" rel="stylesheet" type="text/css">
7
<!-- Generated by Doxygen 1.4.6 -->
10
<li><a href="index.html"><span>Main Page</span></a></li>
11
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
12
<li id="current"><a href="annotated.html"><span>Classes</span></a></li>
13
<li><a href="files.html"><span>Files</span></a></li>
14
<li><a href="dirs.html"><span>Directories</span></a></li>
15
<li><a href="pages.html"><span>Related Pages</span></a></li>
16
<li><a href="examples.html"><span>Examples</span></a></li>
20
<li><a href="annotated.html"><span>Class List</span></a></li>
21
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
22
<li><a href="functions.html"><span>Class Members</span></a></li>
25
<a class="el" href="namespaceQCA.html">QCA</a>::<a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a></div>
26
<h1>QCA::KeyStore Class Reference</h1><!-- doxytag: class="QCA::KeyStore" --><!-- doxytag: inherits="QObject,QCA::Algorithm" -->General purpose key storage object.
27
<a href="#_details">More...</a>
29
<code>#include <<a class="el" href="qca__keystore_8h-source.html">QtCrypto</a>></code>
31
<p>Inheritance diagram for QCA::KeyStore:
32
<p><center><img src="classQCA_1_1KeyStore.png" usemap="#QCA::KeyStore_map" border="0" alt=""></center>
33
<map name="QCA::KeyStore_map">
34
<area doxygen="qt.tag:" href="qobject.html" alt="QObject" shape="rect" coords="0,0,99,24">
35
<area href="classQCA_1_1Algorithm.html" alt="QCA::Algorithm" shape="rect" coords="109,0,208,24">
37
Collaboration diagram for QCA::KeyStore:<p><center><img src="classQCA_1_1KeyStore__coll__graph.png" border="0" usemap="#QCA_1_1KeyStore__coll__map" alt="Collaboration graph"></center>
38
<map name="QCA_1_1KeyStore__coll__map">
39
<area doxygen="qt.tag:" href="qobject.html" shape="rect" coords="7,100,77,124" alt="">
40
<area href="classQCA_1_1Algorithm.html" shape="rect" coords="101,100,215,124" alt="">
41
<area doxygen="qt.tag:" href="qshareddatapointer.html" shape="rect" coords="54,9,262,33" alt="">
43
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classQCA_1_1KeyStore-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
45
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
46
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104">Type</a> { <br>
47
<a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104710dc61699bb831551a36e90bd623678">System</a>,
48
<a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e961045d39060385b95200490fb3c310f3ecd0">User</a>,
49
<a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104eeb8741ed33f66e1bde52a38df01b3d7">Application</a>,
50
<a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104c7cfdde19532933f81401c170045cd84">SmartCard</a>,
52
<a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104e3a700010dc324ee0b8d0356b30f7354">PGPKeyring</a>
56
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
57
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#b8dcd3e9d1c4ae8f5385f12e903fa4c1">KeyStore</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &id, <a class="el" href="classQCA_1_1KeyStoreManager.html">KeyStoreManager</a> *keyStoreManager)</td></tr>
59
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#42515540d63278da76692c019a613fb0">isValid</a> () const </td></tr>
61
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104">Type</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#f89f99dbc4b1a104599f7f83c3c778ad">type</a> () const </td></tr>
63
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#a5c72e8f806f0aa5761fbed024667ec0">name</a> () const </td></tr>
65
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#5806497d795af616345dd596a4c8548e">id</a> () const </td></tr>
67
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#4c2d8db65052a8459df9e328bcc15ac8">isReadOnly</a> () const </td></tr>
69
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#ec62bc39104fbfeeaf5e5f6166be6463">startAsynchronousMode</a> ()</td></tr>
71
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qlist.html">QList</a>< <a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#1c7b035052383408eea6788b2dc36b44">entryList</a> () const </td></tr>
73
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#3a15e70d7eff3c2d95264fd9c2d6ca54">holdsTrustedCertificates</a> () const </td></tr>
75
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#cf526de7db6384131f49e5a644022576">holdsIdentities</a> () const </td></tr>
77
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#0a02eba7722d0d8717be5bcc44498e01">holdsPGPPublicKeys</a> () const </td></tr>
79
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#6ae92f50a6990692525a69f569dbbd3d">writeEntry</a> (const <a class="el" href="classQCA_1_1KeyBundle.html">KeyBundle</a> &kb)</td></tr>
81
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#b27f5289c97d0f8d7412cbfbc0b70f2d">writeEntry</a> (const <a class="el" href="classQCA_1_1Certificate.html">Certificate</a> &cert)</td></tr>
83
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#1bcdd1b4d0a5310c565cc16aa3261d86">writeEntry</a> (const <a class="el" href="classQCA_1_1CRL.html">CRL</a> &crl)</td></tr>
85
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#a5b681a12fbd0fc3641a9d2888308bd0">writeEntry</a> (const <a class="el" href="classQCA_1_1PGPKey.html">PGPKey</a> &key)</td></tr>
87
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#d9bb4899f9fba4ef910a6db64de94e5e">removeEntry</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &id)</td></tr>
89
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#3c979d7bc11b721723226b97a11621e3">unavailable</a> ()</td></tr>
91
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#6bbd4edefa03a3b1879a12a70f5d2136">entryWritten</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &entryId)</td></tr>
93
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStore.html#03d591ed81224d834302248fd7dace4b">entryRemoved</a> (bool success)</td></tr>
95
<tr><td colspan="2"><br><h2>Public Attributes</h2></td></tr>
96
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="233ee10b3872f14de5bf42703971b25b"></a><!-- doxytag: member="QCA::KeyStore::__pad0__" ref="233ee10b3872f14de5bf42703971b25b" args="" -->
97
Q_SIGNALS </td><td class="memItemRight" valign="bottom"><b>__pad0__</b>: void updated()</td></tr>
99
<tr><td colspan="2"><br><h2>Friends</h2></td></tr>
100
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e7e78381ddfbe877974fd0448f4437c0"></a><!-- doxytag: member="QCA::KeyStore::KeyStorePrivate" ref="e7e78381ddfbe877974fd0448f4437c0" args="" -->
101
class </td><td class="memItemRight" valign="bottom"><b>KeyStorePrivate</b></td></tr>
103
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e3bc411fa142cce1860dfda549de6e6f"></a><!-- doxytag: member="QCA::KeyStore::KeyStoreManagerPrivate" ref="e3bc411fa142cce1860dfda549de6e6f" args="" -->
104
class </td><td class="memItemRight" valign="bottom"><b>KeyStoreManagerPrivate</b></td></tr>
107
<hr><a name="_details"></a><h2>Detailed Description</h2>
108
General purpose key storage object.
110
Examples of use of this are:<ul>
111
<li>systemstore: System TrustedCertificates</li><li>accepted self-signed: Application TrustedCertificates</li><li>apple keychain: User Identities</li><li>smartcard: SmartCard Identities</li><li>gnupg: PGPKeyring Identities,PGPPublicKeys</li></ul>
113
<dl compact><dt><b>Note:</b></dt><dd><ul>
114
<li>there can be multiple <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> objects referring to the same id</li><li>when a <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> is constructed, it refers to a given id (deviceId) and internal contextId. if the context goes away, the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> becomes invalid (<a class="el" href="classQCA_1_1KeyStore.html#42515540d63278da76692c019a613fb0">isValid()</a> == false), and <a class="el" href="classQCA_1_1KeyStore.html#3c979d7bc11b721723226b97a11621e3">unavailable()</a> is emitted. even if the device later reappears, the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> remains invalid. a new <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> will have to be created to use the device again. </li></ul>
118
<hr><h2>Member Enumeration Documentation</h2>
119
<a class="anchor" name="f35e750798e035963517699c70e96104"></a><!-- doxytag: member="QCA::KeyStore::Type" ref="f35e750798e035963517699c70e96104" args="" --><p>
120
<table class="mdTable" cellpadding="2" cellspacing="0">
123
<table cellpadding="0" cellspacing="0" border="0">
125
<td class="md" nowrap valign="top">enum <a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104">QCA::KeyStore::Type</a> </td>
131
<table cellspacing="5" cellpadding="0" border="0">
139
The type of keystore.
141
<dl compact><dt><b>Enumerator: </b></dt><dd>
142
<table border="0" cellspacing="2" cellpadding="0">
143
<tr><td valign="top"><em><a class="anchor" name="f35e750798e035963517699c70e96104710dc61699bb831551a36e90bd623678"></a><!-- doxytag: member="System" ref="f35e750798e035963517699c70e96104710dc61699bb831551a36e90bd623678" args="" -->System</em> </td><td>
144
objects such as root certificates </td></tr>
145
<tr><td valign="top"><em><a class="anchor" name="f35e750798e035963517699c70e961045d39060385b95200490fb3c310f3ecd0"></a><!-- doxytag: member="User" ref="f35e750798e035963517699c70e961045d39060385b95200490fb3c310f3ecd0" args="" -->User</em> </td><td>
146
objects such as Apple Keychain, KDE Wallet </td></tr>
147
<tr><td valign="top"><em><a class="anchor" name="f35e750798e035963517699c70e96104eeb8741ed33f66e1bde52a38df01b3d7"></a><!-- doxytag: member="Application" ref="f35e750798e035963517699c70e96104eeb8741ed33f66e1bde52a38df01b3d7" args="" -->Application</em> </td><td>
148
for caching accepted self-signed certificates </td></tr>
149
<tr><td valign="top"><em><a class="anchor" name="f35e750798e035963517699c70e96104c7cfdde19532933f81401c170045cd84"></a><!-- doxytag: member="SmartCard" ref="f35e750798e035963517699c70e96104c7cfdde19532933f81401c170045cd84" args="" -->SmartCard</em> </td><td>
150
for smartcards </td></tr>
151
<tr><td valign="top"><em><a class="anchor" name="f35e750798e035963517699c70e96104e3a700010dc324ee0b8d0356b30f7354"></a><!-- doxytag: member="PGPKeyring" ref="f35e750798e035963517699c70e96104e3a700010dc324ee0b8d0356b30f7354" args="" -->PGPKeyring</em> </td><td>
152
for a PGP keyring </td></tr>
158
<hr><h2>Constructor & Destructor Documentation</h2>
159
<a class="anchor" name="b8dcd3e9d1c4ae8f5385f12e903fa4c1"></a><!-- doxytag: member="QCA::KeyStore::KeyStore" ref="b8dcd3e9d1c4ae8f5385f12e903fa4c1" args="(const QString &id, KeyStoreManager *keyStoreManager)" --><p>
160
<table class="mdTable" cellpadding="2" cellspacing="0">
163
<table cellpadding="0" cellspacing="0" border="0">
165
<td class="md" nowrap valign="top">QCA::KeyStore::KeyStore </td>
166
<td class="md" valign="top">( </td>
167
<td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> & </td>
168
<td class="mdname" nowrap> <em>id</em>, </td>
171
<td class="md" nowrap align="right"></td>
173
<td class="md" nowrap><a class="el" href="classQCA_1_1KeyStoreManager.html">KeyStoreManager</a> * </td>
174
<td class="mdname" nowrap> <em>keyStoreManager</em></td>
178
<td class="md">) </td>
179
<td class="md" colspan="2"></td>
185
<table cellspacing="5" cellpadding="0" border="0">
193
Obtain a specific <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>.
195
<dl compact><dt><b>Parameters:</b></dt><dd>
196
<table border="0" cellspacing="2" cellpadding="0">
197
<tr><td valign="top"></td><td valign="top"><em>id</em> </td><td>the identification for the key store </td></tr>
198
<tr><td valign="top"></td><td valign="top"><em>keyStoreManager</em> </td><td>the parent manager for this keystore </td></tr>
204
<hr><h2>Member Function Documentation</h2>
205
<a class="anchor" name="42515540d63278da76692c019a613fb0"></a><!-- doxytag: member="QCA::KeyStore::isValid" ref="42515540d63278da76692c019a613fb0" args="() const " --><p>
206
<table class="mdTable" cellpadding="2" cellspacing="0">
209
<table cellpadding="0" cellspacing="0" border="0">
211
<td class="md" nowrap valign="top">bool QCA::KeyStore::isValid </td>
212
<td class="md" valign="top">( </td>
213
<td class="mdname1" valign="top" nowrap> </td>
214
<td class="md" valign="top"> ) </td>
215
<td class="md" nowrap> const</td>
221
<table cellspacing="5" cellpadding="0" border="0">
229
Check if this <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> is valid.
231
<dl compact><dt><b>Returns:</b></dt><dd>true if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> is valid </dd></dl>
235
<a class="anchor" name="f89f99dbc4b1a104599f7f83c3c778ad"></a><!-- doxytag: member="QCA::KeyStore::type" ref="f89f99dbc4b1a104599f7f83c3c778ad" args="() const " --><p>
236
<table class="mdTable" cellpadding="2" cellspacing="0">
239
<table cellpadding="0" cellspacing="0" border="0">
241
<td class="md" nowrap valign="top"><a class="el" href="classQCA_1_1KeyStore.html#f35e750798e035963517699c70e96104">Type</a> QCA::KeyStore::type </td>
242
<td class="md" valign="top">( </td>
243
<td class="mdname1" valign="top" nowrap> </td>
244
<td class="md" valign="top"> ) </td>
245
<td class="md" nowrap> const</td>
251
<table cellspacing="5" cellpadding="0" border="0">
259
The <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> Type.
263
Reimplemented from <a class="el" href="classQCA_1_1Algorithm.html#503255bf0a33bad64c2d2aedc361e4c7">QCA::Algorithm</a>. </td>
266
<a class="anchor" name="a5c72e8f806f0aa5761fbed024667ec0"></a><!-- doxytag: member="QCA::KeyStore::name" ref="a5c72e8f806f0aa5761fbed024667ec0" args="() const " --><p>
267
<table class="mdTable" cellpadding="2" cellspacing="0">
270
<table cellpadding="0" cellspacing="0" border="0">
272
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::name </td>
273
<td class="md" valign="top">( </td>
274
<td class="mdname1" valign="top" nowrap> </td>
275
<td class="md" valign="top"> ) </td>
276
<td class="md" nowrap> const</td>
282
<table cellspacing="5" cellpadding="0" border="0">
290
The name associated with the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>.
295
<a class="anchor" name="5806497d795af616345dd596a4c8548e"></a><!-- doxytag: member="QCA::KeyStore::id" ref="5806497d795af616345dd596a4c8548e" args="() const " --><p>
296
<table class="mdTable" cellpadding="2" cellspacing="0">
299
<table cellpadding="0" cellspacing="0" border="0">
301
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::id </td>
302
<td class="md" valign="top">( </td>
303
<td class="mdname1" valign="top" nowrap> </td>
304
<td class="md" valign="top"> ) </td>
305
<td class="md" nowrap> const</td>
311
<table cellspacing="5" cellpadding="0" border="0">
319
The ID associated with the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>.
324
<a class="anchor" name="4c2d8db65052a8459df9e328bcc15ac8"></a><!-- doxytag: member="QCA::KeyStore::isReadOnly" ref="4c2d8db65052a8459df9e328bcc15ac8" args="() const " --><p>
325
<table class="mdTable" cellpadding="2" cellspacing="0">
328
<table cellpadding="0" cellspacing="0" border="0">
330
<td class="md" nowrap valign="top">bool QCA::KeyStore::isReadOnly </td>
331
<td class="md" valign="top">( </td>
332
<td class="mdname1" valign="top" nowrap> </td>
333
<td class="md" valign="top"> ) </td>
334
<td class="md" nowrap> const</td>
340
<table cellspacing="5" cellpadding="0" border="0">
348
Test if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> is writeable or not.
350
<dl compact><dt><b>Returns:</b></dt><dd>true if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> is read-only </dd></dl>
354
<a class="anchor" name="ec62bc39104fbfeeaf5e5f6166be6463"></a><!-- doxytag: member="QCA::KeyStore::startAsynchronousMode" ref="ec62bc39104fbfeeaf5e5f6166be6463" args="()" --><p>
355
<table class="mdTable" cellpadding="2" cellspacing="0">
358
<table cellpadding="0" cellspacing="0" border="0">
360
<td class="md" nowrap valign="top">void QCA::KeyStore::startAsynchronousMode </td>
361
<td class="md" valign="top">( </td>
362
<td class="mdname1" valign="top" nowrap> </td>
363
<td class="md" valign="top"> ) </td>
364
<td class="md" nowrap></td>
370
<table cellspacing="5" cellpadding="0" border="0">
378
Turns on asynchronous mode for this <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> instance.
380
Normally, <a class="el" href="classQCA_1_1KeyStore.html#1c7b035052383408eea6788b2dc36b44">entryList()</a> and <a class="el" href="classQCA_1_1KeyStore.html#6ae92f50a6990692525a69f569dbbd3d">writeEntry()</a> are blocking calls. However, if <a class="el" href="classQCA_1_1KeyStore.html#ec62bc39104fbfeeaf5e5f6166be6463">startAsynchronousMode()</a> is called, then these functions will return immediately. <a class="el" href="classQCA_1_1KeyStore.html#1c7b035052383408eea6788b2dc36b44">entryList()</a> will return with the latest known entries, or an empty list if none are known yet (in this mode, updated() will be emitted once the initial entries are known, even if the store has not actually been altered). <a class="el" href="classQCA_1_1KeyStore.html#6ae92f50a6990692525a69f569dbbd3d">writeEntry()</a> will always return an empty string, and the <a class="el" href="classQCA_1_1KeyStore.html#6bbd4edefa03a3b1879a12a70f5d2136">entryWritten()</a> signal indicates the result of a write. </td>
383
<a class="anchor" name="1c7b035052383408eea6788b2dc36b44"></a><!-- doxytag: member="QCA::KeyStore::entryList" ref="1c7b035052383408eea6788b2dc36b44" args="() const " --><p>
384
<table class="mdTable" cellpadding="2" cellspacing="0">
387
<table cellpadding="0" cellspacing="0" border="0">
389
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qlist.html">QList</a><<a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a>> QCA::KeyStore::entryList </td>
390
<td class="md" valign="top">( </td>
391
<td class="mdname1" valign="top" nowrap> </td>
392
<td class="md" valign="top"> ) </td>
393
<td class="md" nowrap> const</td>
399
<table cellspacing="5" cellpadding="0" border="0">
407
A list of the <a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a> objects in this store.
409
<dl compact><dt><b>Note:</b></dt><dd>This synchronous operation may require event handling, and so it must not be called from the same thread as an <a class="el" href="classQCA_1_1EventHandler.html">EventHandler</a> (this is not a concern if asynchronous mode is enabled).</dd></dl>
410
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="classQCA_1_1KeyStore.html#ec62bc39104fbfeeaf5e5f6166be6463">startAsynchronousMode</a> </dd></dl>
414
<a class="anchor" name="3a15e70d7eff3c2d95264fd9c2d6ca54"></a><!-- doxytag: member="QCA::KeyStore::holdsTrustedCertificates" ref="3a15e70d7eff3c2d95264fd9c2d6ca54" args="() const " --><p>
415
<table class="mdTable" cellpadding="2" cellspacing="0">
418
<table cellpadding="0" cellspacing="0" border="0">
420
<td class="md" nowrap valign="top">bool QCA::KeyStore::holdsTrustedCertificates </td>
421
<td class="md" valign="top">( </td>
422
<td class="mdname1" valign="top" nowrap> </td>
423
<td class="md" valign="top"> ) </td>
424
<td class="md" nowrap> const</td>
430
<table cellspacing="5" cellpadding="0" border="0">
438
test if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> holds trusted certificates (and CRLs)
443
<a class="anchor" name="cf526de7db6384131f49e5a644022576"></a><!-- doxytag: member="QCA::KeyStore::holdsIdentities" ref="cf526de7db6384131f49e5a644022576" args="() const " --><p>
444
<table class="mdTable" cellpadding="2" cellspacing="0">
447
<table cellpadding="0" cellspacing="0" border="0">
449
<td class="md" nowrap valign="top">bool QCA::KeyStore::holdsIdentities </td>
450
<td class="md" valign="top">( </td>
451
<td class="mdname1" valign="top" nowrap> </td>
452
<td class="md" valign="top"> ) </td>
453
<td class="md" nowrap> const</td>
459
<table cellspacing="5" cellpadding="0" border="0">
467
test if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> holds identities (eg <a class="el" href="classQCA_1_1KeyBundle.html">KeyBundle</a> or PGPSecretKey)
472
<a class="anchor" name="0a02eba7722d0d8717be5bcc44498e01"></a><!-- doxytag: member="QCA::KeyStore::holdsPGPPublicKeys" ref="0a02eba7722d0d8717be5bcc44498e01" args="() const " --><p>
473
<table class="mdTable" cellpadding="2" cellspacing="0">
476
<table cellpadding="0" cellspacing="0" border="0">
478
<td class="md" nowrap valign="top">bool QCA::KeyStore::holdsPGPPublicKeys </td>
479
<td class="md" valign="top">( </td>
480
<td class="mdname1" valign="top" nowrap> </td>
481
<td class="md" valign="top"> ) </td>
482
<td class="md" nowrap> const</td>
488
<table cellspacing="5" cellpadding="0" border="0">
496
test if the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> holds PGPPublicKey objects
501
<a class="anchor" name="6ae92f50a6990692525a69f569dbbd3d"></a><!-- doxytag: member="QCA::KeyStore::writeEntry" ref="6ae92f50a6990692525a69f569dbbd3d" args="(const KeyBundle &kb)" --><p>
502
<table class="mdTable" cellpadding="2" cellspacing="0">
505
<table cellpadding="0" cellspacing="0" border="0">
507
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::writeEntry </td>
508
<td class="md" valign="top">( </td>
509
<td class="md" nowrap valign="top">const <a class="el" href="classQCA_1_1KeyBundle.html">KeyBundle</a> & </td>
510
<td class="mdname1" valign="top" nowrap> <em>kb</em> </td>
511
<td class="md" valign="top"> ) </td>
512
<td class="md" nowrap></td>
518
<table cellspacing="5" cellpadding="0" border="0">
526
Add a entry to the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>.
528
Returns the entryId of the written entry or an empty string on failure.<p>
529
<dl compact><dt><b>Parameters:</b></dt><dd>
530
<table border="0" cellspacing="2" cellpadding="0">
531
<tr><td valign="top"></td><td valign="top"><em>kb</em> </td><td>the <a class="el" href="classQCA_1_1KeyBundle.html">KeyBundle</a> to add to the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a></td></tr>
534
<dl compact><dt><b>Note:</b></dt><dd>This synchronous operation may require event handling, and so it must not be called from the same thread as an <a class="el" href="classQCA_1_1EventHandler.html">EventHandler</a> (this is not a concern if asynchronous mode is enabled).</dd></dl>
535
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="classQCA_1_1KeyStore.html#ec62bc39104fbfeeaf5e5f6166be6463">startAsynchronousMode</a> </dd></dl>
539
<a class="anchor" name="b27f5289c97d0f8d7412cbfbc0b70f2d"></a><!-- doxytag: member="QCA::KeyStore::writeEntry" ref="b27f5289c97d0f8d7412cbfbc0b70f2d" args="(const Certificate &cert)" --><p>
540
<table class="mdTable" cellpadding="2" cellspacing="0">
543
<table cellpadding="0" cellspacing="0" border="0">
545
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::writeEntry </td>
546
<td class="md" valign="top">( </td>
547
<td class="md" nowrap valign="top">const <a class="el" href="classQCA_1_1Certificate.html">Certificate</a> & </td>
548
<td class="mdname1" valign="top" nowrap> <em>cert</em> </td>
549
<td class="md" valign="top"> ) </td>
550
<td class="md" nowrap></td>
556
<table cellspacing="5" cellpadding="0" border="0">
564
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
566
<dl compact><dt><b>Parameters:</b></dt><dd>
567
<table border="0" cellspacing="2" cellpadding="0">
568
<tr><td valign="top"></td><td valign="top"><em>cert</em> </td><td>the <a class="el" href="classQCA_1_1Certificate.html">Certificate</a> to add to the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> </td></tr>
574
<a class="anchor" name="1bcdd1b4d0a5310c565cc16aa3261d86"></a><!-- doxytag: member="QCA::KeyStore::writeEntry" ref="1bcdd1b4d0a5310c565cc16aa3261d86" args="(const CRL &crl)" --><p>
575
<table class="mdTable" cellpadding="2" cellspacing="0">
578
<table cellpadding="0" cellspacing="0" border="0">
580
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::writeEntry </td>
581
<td class="md" valign="top">( </td>
582
<td class="md" nowrap valign="top">const <a class="el" href="classQCA_1_1CRL.html">CRL</a> & </td>
583
<td class="mdname1" valign="top" nowrap> <em>crl</em> </td>
584
<td class="md" valign="top"> ) </td>
585
<td class="md" nowrap></td>
591
<table cellspacing="5" cellpadding="0" border="0">
599
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
601
<dl compact><dt><b>Parameters:</b></dt><dd>
602
<table border="0" cellspacing="2" cellpadding="0">
603
<tr><td valign="top"></td><td valign="top"><em>crl</em> </td><td>the <a class="el" href="classQCA_1_1CRL.html">CRL</a> to add to the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> </td></tr>
609
<a class="anchor" name="a5b681a12fbd0fc3641a9d2888308bd0"></a><!-- doxytag: member="QCA::KeyStore::writeEntry" ref="a5b681a12fbd0fc3641a9d2888308bd0" args="(const PGPKey &key)" --><p>
610
<table class="mdTable" cellpadding="2" cellspacing="0">
613
<table cellpadding="0" cellspacing="0" border="0">
615
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStore::writeEntry </td>
616
<td class="md" valign="top">( </td>
617
<td class="md" nowrap valign="top">const <a class="el" href="classQCA_1_1PGPKey.html">PGPKey</a> & </td>
618
<td class="mdname1" valign="top" nowrap> <em>key</em> </td>
619
<td class="md" valign="top"> ) </td>
620
<td class="md" nowrap></td>
626
<table cellspacing="5" cellpadding="0" border="0">
634
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
636
<dl compact><dt><b>Parameters:</b></dt><dd>
637
<table border="0" cellspacing="2" cellpadding="0">
638
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the <a class="el" href="classQCA_1_1PGPKey.html">PGPKey</a> to add to the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a></td></tr>
641
<dl compact><dt><b>Returns:</b></dt><dd>a ref to the key in the keyring </dd></dl>
645
<a class="anchor" name="d9bb4899f9fba4ef910a6db64de94e5e"></a><!-- doxytag: member="QCA::KeyStore::removeEntry" ref="d9bb4899f9fba4ef910a6db64de94e5e" args="(const QString &id)" --><p>
646
<table class="mdTable" cellpadding="2" cellspacing="0">
649
<table cellpadding="0" cellspacing="0" border="0">
651
<td class="md" nowrap valign="top">bool QCA::KeyStore::removeEntry </td>
652
<td class="md" valign="top">( </td>
653
<td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> & </td>
654
<td class="mdname1" valign="top" nowrap> <em>id</em> </td>
655
<td class="md" valign="top"> ) </td>
656
<td class="md" nowrap></td>
662
<table cellspacing="5" cellpadding="0" border="0">
670
Delete the a specified <a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a> from this <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>.
672
<dl compact><dt><b>Parameters:</b></dt><dd>
673
<table border="0" cellspacing="2" cellpadding="0">
674
<tr><td valign="top"></td><td valign="top"><em>id</em> </td><td>the ID for the entry to be deleted</td></tr>
677
<dl compact><dt><b>Note:</b></dt><dd>This synchronous operation may require event handling, and so it must not be called from the same thread as an <a class="el" href="classQCA_1_1EventHandler.html">EventHandler</a> (this is not a concern if asynchronous mode is enabled).</dd></dl>
678
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="classQCA_1_1KeyStore.html#ec62bc39104fbfeeaf5e5f6166be6463">startAsynchronousMode</a> </dd></dl>
682
<a class="anchor" name="3c979d7bc11b721723226b97a11621e3"></a><!-- doxytag: member="QCA::KeyStore::unavailable" ref="3c979d7bc11b721723226b97a11621e3" args="()" --><p>
683
<table class="mdTable" cellpadding="2" cellspacing="0">
686
<table cellpadding="0" cellspacing="0" border="0">
688
<td class="md" nowrap valign="top">void QCA::KeyStore::unavailable </td>
689
<td class="md" valign="top">( </td>
690
<td class="mdname1" valign="top" nowrap> </td>
691
<td class="md" valign="top"> ) </td>
692
<td class="md" nowrap></td>
698
<table cellspacing="5" cellpadding="0" border="0">
706
Emitted when the <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> becomes unavailable.
711
<a class="anchor" name="6bbd4edefa03a3b1879a12a70f5d2136"></a><!-- doxytag: member="QCA::KeyStore::entryWritten" ref="6bbd4edefa03a3b1879a12a70f5d2136" args="(const QString &entryId)" --><p>
712
<table class="mdTable" cellpadding="2" cellspacing="0">
715
<table cellpadding="0" cellspacing="0" border="0">
717
<td class="md" nowrap valign="top">void QCA::KeyStore::entryWritten </td>
718
<td class="md" valign="top">( </td>
719
<td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> & </td>
720
<td class="mdname1" valign="top" nowrap> <em>entryId</em> </td>
721
<td class="md" valign="top"> ) </td>
722
<td class="md" nowrap></td>
728
<table cellspacing="5" cellpadding="0" border="0">
736
Emitted when an entry has been written, in asynchronous mode.
738
entryId is the newly written entry id on success, or an empty string if the write failed. </td>
741
<a class="anchor" name="03d591ed81224d834302248fd7dace4b"></a><!-- doxytag: member="QCA::KeyStore::entryRemoved" ref="03d591ed81224d834302248fd7dace4b" args="(bool success)" --><p>
742
<table class="mdTable" cellpadding="2" cellspacing="0">
745
<table cellpadding="0" cellspacing="0" border="0">
747
<td class="md" nowrap valign="top">void QCA::KeyStore::entryRemoved </td>
748
<td class="md" valign="top">( </td>
749
<td class="md" nowrap valign="top">bool </td>
750
<td class="mdname1" valign="top" nowrap> <em>success</em> </td>
751
<td class="md" valign="top"> ) </td>
752
<td class="md" nowrap></td>
758
<table cellspacing="5" cellpadding="0" border="0">
766
Emitted when an entry has been removed, in asynchronous mode.
768
success indicates if the removal succeeded or not. </td>
771
<hr>The documentation for this class was generated from the following file:<ul>
772
<li><a class="el" href="qca__keystore_8h-source.html">qca_keystore.h</a></ul>
773
<hr size="1"><address style="align: right;"><small>Generated on Fri Jul 6 13:23:55 2007 for Qt Cryptographic Architecture by
774
<a href="http://www.doxygen.org/index.html">
775
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>