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::KeyStoreManager 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_1KeyStoreManager.html">KeyStoreManager</a></div>
26
<h1>QCA::KeyStoreManager Class Reference</h1><!-- doxytag: class="QCA::KeyStoreManager" --><!-- doxytag: inherits="QObject" -->Access keystores, and monitor keystores for changes.
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::KeyStoreManager:
32
<p><center><img src="classQCA_1_1KeyStoreManager.png" usemap="#QCA::KeyStoreManager_map" border="0" alt=""></center>
33
<map name="QCA::KeyStoreManager_map">
34
<area doxygen="qt.tag:" href="qobject.html" alt="QObject" shape="rect" coords="0,0,149,24">
36
Collaboration diagram for QCA::KeyStoreManager:<p><center><img src="classQCA_1_1KeyStoreManager__coll__graph.png" border="0" usemap="#QCA_1_1KeyStoreManager__coll__map" alt="Collaboration graph"></center>
37
<map name="QCA_1_1KeyStoreManager__coll__map">
38
<area doxygen="qt.tag:" href="qobject.html" shape="rect" coords="8,9,77,33" alt="">
40
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classQCA_1_1KeyStoreManager-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
42
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
43
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#a1c4e92a5a89d5eebe81224ff0caee1f">KeyStoreManager</a> (<a class="elRef" doxygen="qt.tag:" href="qobject.html">QObject</a> *<a class="elRef" doxygen="qt.tag:" href="qobject.html#a655461eccb9740e4a07928a1e593cdf">parent</a>=0)</td></tr>
45
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#d59ca737b1765d9e305fa7ffa3858cfc">isBusy</a> () const </td></tr>
47
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#7245cfcde5a6ec0731126b6a0e3bd150">waitForBusyFinished</a> ()</td></tr>
49
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#7e9b3a033fd5e6dc6a175d9936beae87">keyStores</a> () const </td></tr>
51
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#89ebacbe715b1af95eef0ffa2c51bd85">sync</a> ()</td></tr>
53
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#a5cff45999a9844e892be5a4c40e2ad9">busyFinished</a> ()</td></tr>
55
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#4fb9fea488a318784bbc3d9d0e97988c">keyStoreAvailable</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &id)</td></tr>
57
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
58
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#f780eef878be7ad9da572469371fcdbe">start</a> ()</td></tr>
60
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#6eb0782e247e425c3bdcc710d09e23a4">start</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &provider)</td></tr>
62
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#3484d13a052144179e834be3c763d7bd">diagnosticText</a> ()</td></tr>
64
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classQCA_1_1KeyStoreManager.html#6df494362b986cb58531f03d535ac15e">clearDiagnosticText</a> ()</td></tr>
66
<tr><td colspan="2"><br><h2>Public Attributes</h2></td></tr>
67
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5de1a4f1d40b497ac14c06529aa0fe24"></a><!-- doxytag: member="QCA::KeyStoreManager::__pad0__" ref="5de1a4f1d40b497ac14c06529aa0fe24" args="" -->
68
Q_SIGNALS </td><td class="memItemRight" valign="bottom"><b>__pad0__</b>: void busyStarted()</td></tr>
70
<tr><td colspan="2"><br><h2>Friends</h2></td></tr>
71
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e3bc411fa142cce1860dfda549de6e6f"></a><!-- doxytag: member="QCA::KeyStoreManager::KeyStoreManagerPrivate" ref="e3bc411fa142cce1860dfda549de6e6f" args="" -->
72
class </td><td class="memItemRight" valign="bottom"><b>KeyStoreManagerPrivate</b></td></tr>
74
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9929f1efd289a1b5299a120669201943"></a><!-- doxytag: member="QCA::KeyStoreManager::Global" ref="9929f1efd289a1b5299a120669201943" args="" -->
75
class </td><td class="memItemRight" valign="bottom"><b>Global</b></td></tr>
77
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e7e78381ddfbe877974fd0448f4437c0"></a><!-- doxytag: member="QCA::KeyStoreManager::KeyStorePrivate" ref="e7e78381ddfbe877974fd0448f4437c0" args="" -->
78
class </td><td class="memItemRight" valign="bottom"><b>KeyStorePrivate</b></td></tr>
81
<hr><a name="_details"></a><h2>Detailed Description</h2>
82
Access keystores, and monitor keystores for changes.
84
Before you can access a <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a>, you must create a <a class="el" href="classQCA_1_1KeyStoreManager.html">KeyStoreManager</a>. You then need to <a class="el" href="classQCA_1_1KeyStoreManager.html#f780eef878be7ad9da572469371fcdbe">start()</a> the <a class="el" href="classQCA_1_1KeyStoreManager.html">KeyStoreManager</a>, and either wait for the <a class="el" href="classQCA_1_1KeyStoreManager.html#a5cff45999a9844e892be5a4c40e2ad9">busyFinished()</a> signal, or block using <a class="el" href="classQCA_1_1KeyStoreManager.html#7245cfcde5a6ec0731126b6a0e3bd150">waitForBusyFinished()</a>.<p>
85
If you know the <a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a> that you need, you can use <a class="el" href="classQCA_1_1KeyStore.html">KeyStore</a> passively, as described in the <a class="el" href="classQCA_1_1KeyStoreEntry.html">KeyStoreEntry</a> documentation.
87
<hr><h2>Constructor & Destructor Documentation</h2>
88
<a class="anchor" name="a1c4e92a5a89d5eebe81224ff0caee1f"></a><!-- doxytag: member="QCA::KeyStoreManager::KeyStoreManager" ref="a1c4e92a5a89d5eebe81224ff0caee1f" args="(QObject *parent=0)" --><p>
89
<table class="mdTable" cellpadding="2" cellspacing="0">
92
<table cellpadding="0" cellspacing="0" border="0">
94
<td class="md" nowrap valign="top">QCA::KeyStoreManager::KeyStoreManager </td>
95
<td class="md" valign="top">( </td>
96
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qobject.html">QObject</a> * </td>
97
<td class="mdname1" valign="top" nowrap> <em>parent</em> = <code>0</code> </td>
98
<td class="md" valign="top"> ) </td>
99
<td class="md" nowrap></td>
105
<table cellspacing="5" cellpadding="0" border="0">
113
Create a new <a class="el" href="classQCA_1_1KeyStoreManager.html">KeyStoreManager</a>.
115
<dl compact><dt><b>Parameters:</b></dt><dd>
116
<table border="0" cellspacing="2" cellpadding="0">
117
<tr><td valign="top"></td><td valign="top"><em>parent</em> </td><td>the parent for this object </td></tr>
123
<hr><h2>Member Function Documentation</h2>
124
<a class="anchor" name="f780eef878be7ad9da572469371fcdbe"></a><!-- doxytag: member="QCA::KeyStoreManager::start" ref="f780eef878be7ad9da572469371fcdbe" args="()" --><p>
125
<table class="mdTable" cellpadding="2" cellspacing="0">
128
<table cellpadding="0" cellspacing="0" border="0">
130
<td class="md" nowrap valign="top">static void QCA::KeyStoreManager::start </td>
131
<td class="md" valign="top">( </td>
132
<td class="mdname1" valign="top" nowrap> </td>
133
<td class="md" valign="top"> ) </td>
134
<td class="md" nowrap><code> [static]</code></td>
140
<table cellspacing="5" cellpadding="0" border="0">
148
Initialize all key store providers.
153
<a class="anchor" name="6eb0782e247e425c3bdcc710d09e23a4"></a><!-- doxytag: member="QCA::KeyStoreManager::start" ref="6eb0782e247e425c3bdcc710d09e23a4" args="(const QString &provider)" --><p>
154
<table class="mdTable" cellpadding="2" cellspacing="0">
157
<table cellpadding="0" cellspacing="0" border="0">
159
<td class="md" nowrap valign="top">static void QCA::KeyStoreManager::start </td>
160
<td class="md" valign="top">( </td>
161
<td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> & </td>
162
<td class="mdname1" valign="top" nowrap> <em>provider</em> </td>
163
<td class="md" valign="top"> ) </td>
164
<td class="md" nowrap><code> [static]</code></td>
170
<table cellspacing="5" cellpadding="0" border="0">
178
Initialize a specific key store provider.
183
<a class="anchor" name="d59ca737b1765d9e305fa7ffa3858cfc"></a><!-- doxytag: member="QCA::KeyStoreManager::isBusy" ref="d59ca737b1765d9e305fa7ffa3858cfc" args="() const " --><p>
184
<table class="mdTable" cellpadding="2" cellspacing="0">
187
<table cellpadding="0" cellspacing="0" border="0">
189
<td class="md" nowrap valign="top">bool QCA::KeyStoreManager::isBusy </td>
190
<td class="md" valign="top">( </td>
191
<td class="mdname1" valign="top" nowrap> </td>
192
<td class="md" valign="top"> ) </td>
193
<td class="md" nowrap> const</td>
199
<table cellspacing="5" cellpadding="0" border="0">
207
Indicates if the manager is busy looking for key stores.
212
<a class="anchor" name="7245cfcde5a6ec0731126b6a0e3bd150"></a><!-- doxytag: member="QCA::KeyStoreManager::waitForBusyFinished" ref="7245cfcde5a6ec0731126b6a0e3bd150" args="()" --><p>
213
<table class="mdTable" cellpadding="2" cellspacing="0">
216
<table cellpadding="0" cellspacing="0" border="0">
218
<td class="md" nowrap valign="top">void QCA::KeyStoreManager::waitForBusyFinished </td>
219
<td class="md" valign="top">( </td>
220
<td class="mdname1" valign="top" nowrap> </td>
221
<td class="md" valign="top"> ) </td>
222
<td class="md" nowrap></td>
228
<table cellspacing="5" cellpadding="0" border="0">
236
Blocks until the manager is done looking for key stores.
241
<a class="anchor" name="7e9b3a033fd5e6dc6a175d9936beae87"></a><!-- doxytag: member="QCA::KeyStoreManager::keyStores" ref="7e9b3a033fd5e6dc6a175d9936beae87" args="() const " --><p>
242
<table class="mdTable" cellpadding="2" cellspacing="0">
245
<table cellpadding="0" cellspacing="0" border="0">
247
<td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstringlist.html">QStringList</a> QCA::KeyStoreManager::keyStores </td>
248
<td class="md" valign="top">( </td>
249
<td class="mdname1" valign="top" nowrap> </td>
250
<td class="md" valign="top"> ) </td>
251
<td class="md" nowrap> const</td>
257
<table cellspacing="5" cellpadding="0" border="0">
265
A list of all the key stores.
270
<a class="anchor" name="3484d13a052144179e834be3c763d7bd"></a><!-- doxytag: member="QCA::KeyStoreManager::diagnosticText" ref="3484d13a052144179e834be3c763d7bd" args="()" --><p>
271
<table class="mdTable" cellpadding="2" cellspacing="0">
274
<table cellpadding="0" cellspacing="0" border="0">
276
<td class="md" nowrap valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> QCA::KeyStoreManager::diagnosticText </td>
277
<td class="md" valign="top">( </td>
278
<td class="mdname1" valign="top" nowrap> </td>
279
<td class="md" valign="top"> ) </td>
280
<td class="md" nowrap><code> [static]</code></td>
286
<table cellspacing="5" cellpadding="0" border="0">
294
The diagnostic result of key store operations, such as warnings and errors.
299
<a class="anchor" name="6df494362b986cb58531f03d535ac15e"></a><!-- doxytag: member="QCA::KeyStoreManager::clearDiagnosticText" ref="6df494362b986cb58531f03d535ac15e" args="()" --><p>
300
<table class="mdTable" cellpadding="2" cellspacing="0">
303
<table cellpadding="0" cellspacing="0" border="0">
305
<td class="md" nowrap valign="top">static void QCA::KeyStoreManager::clearDiagnosticText </td>
306
<td class="md" valign="top">( </td>
307
<td class="mdname1" valign="top" nowrap> </td>
308
<td class="md" valign="top"> ) </td>
309
<td class="md" nowrap><code> [static]</code></td>
315
<table cellspacing="5" cellpadding="0" border="0">
323
Clears the diagnostic result log.
328
<a class="anchor" name="89ebacbe715b1af95eef0ffa2c51bd85"></a><!-- doxytag: member="QCA::KeyStoreManager::sync" ref="89ebacbe715b1af95eef0ffa2c51bd85" args="()" --><p>
329
<table class="mdTable" cellpadding="2" cellspacing="0">
332
<table cellpadding="0" cellspacing="0" border="0">
334
<td class="md" nowrap valign="top">void QCA::KeyStoreManager::sync </td>
335
<td class="md" valign="top">( </td>
336
<td class="mdname1" valign="top" nowrap> </td>
337
<td class="md" valign="top"> ) </td>
338
<td class="md" nowrap></td>
344
<table cellspacing="5" cellpadding="0" border="0">
352
If you are not using the eventloop, call this to update the object state to the present.
357
<a class="anchor" name="a5cff45999a9844e892be5a4c40e2ad9"></a><!-- doxytag: member="QCA::KeyStoreManager::busyFinished" ref="a5cff45999a9844e892be5a4c40e2ad9" args="()" --><p>
358
<table class="mdTable" cellpadding="2" cellspacing="0">
361
<table cellpadding="0" cellspacing="0" border="0">
363
<td class="md" nowrap valign="top">void QCA::KeyStoreManager::busyFinished </td>
364
<td class="md" valign="top">( </td>
365
<td class="mdname1" valign="top" nowrap> </td>
366
<td class="md" valign="top"> ) </td>
367
<td class="md" nowrap></td>
373
<table cellspacing="5" cellpadding="0" border="0">
381
emitted when the manager has finished looking for key stores
386
<a class="anchor" name="4fb9fea488a318784bbc3d9d0e97988c"></a><!-- doxytag: member="QCA::KeyStoreManager::keyStoreAvailable" ref="4fb9fea488a318784bbc3d9d0e97988c" args="(const QString &id)" --><p>
387
<table class="mdTable" cellpadding="2" cellspacing="0">
390
<table cellpadding="0" cellspacing="0" border="0">
392
<td class="md" nowrap valign="top">void QCA::KeyStoreManager::keyStoreAvailable </td>
393
<td class="md" valign="top">( </td>
394
<td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> & </td>
395
<td class="mdname1" valign="top" nowrap> <em>id</em> </td>
396
<td class="md" valign="top"> ) </td>
397
<td class="md" nowrap></td>
403
<table cellspacing="5" cellpadding="0" border="0">
411
emitted when a new key store becomes available
416
<hr>The documentation for this class was generated from the following file:<ul>
417
<li><a class="el" href="qca__keystore_8h-source.html">qca_keystore.h</a></ul>
418
<hr size="1"><address style="align: right;"><small>Generated on Fri Jul 6 13:23:57 2007 for Qt Cryptographic Architecture by
419
<a href="http://www.doxygen.org/index.html">
420
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>