8
8
<link rel="up" href="ch01.html" title="libcryptui Objects and Functions">
9
9
<link rel="prev" href="libcryptui-cryptui-key-store.html" title="CryptUIKeyStore">
10
10
<link rel="next" href="libcryptui-cryptui-defines.html" title="cryptui-defines">
11
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
41
41
enum <a class="link" href="libcryptui-cryptui.html#CryptUIKeyFlags" title="enum CryptUIKeyFlags">CryptUIKeyFlags</a>;
42
42
enum <a class="link" href="libcryptui-cryptui.html#CryptUILocation" title="enum CryptUILocation">CryptUILocation</a>;
43
43
enum <a class="link" href="libcryptui-cryptui.html#CryptUIValidity" title="enum CryptUIValidity">CryptUIValidity</a>;
44
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="libcryptui-cryptui.html#cryptui-key-get-base" title="cryptui_key_get_base ()">cryptui_key_get_base</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
45
<a class="link" href="libcryptui-cryptui.html#CryptUIEncType" title="enum CryptUIEncType"><span class="returnvalue">CryptUIEncType</span></a> <a class="link" href="libcryptui-cryptui.html#cryptui-key-get-enctype" title="cryptui_key_get_enctype ()">cryptui_key_get_enctype</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
46
<span class="returnvalue">void</span> <a class="link" href="libcryptui-cryptui.html#cryptui-display-notification" title="cryptui_display_notification ()">cryptui_display_notification</a> (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
47
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *body</code></em>,
48
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>,
49
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>);
50
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="libcryptui-cryptui.html#cryptui-prompt-recipients" title="cryptui_prompt_recipients ()">cryptui_prompt_recipients</a> (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
51
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
52
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **signer</code></em>);
53
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="libcryptui-cryptui.html#cryptui-prompt-signer" title="cryptui_prompt_signer ()">cryptui_prompt_signer</a> (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
54
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
44
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="libcryptui-cryptui.html#cryptui-key-get-base" title="cryptui_key_get_base ()">cryptui_key_get_base</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
45
<a class="link" href="libcryptui-cryptui.html#CryptUIEncType" title="enum CryptUIEncType"><span class="returnvalue">CryptUIEncType</span></a> <a class="link" href="libcryptui-cryptui.html#cryptui-key-get-enctype" title="cryptui_key_get_enctype ()">cryptui_key_get_enctype</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
46
<span class="returnvalue">void</span> <a class="link" href="libcryptui-cryptui.html#cryptui-display-notification" title="cryptui_display_notification ()">cryptui_display_notification</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
47
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *body</code></em>,
48
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>,
49
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>);
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="libcryptui-cryptui.html#cryptui-prompt-recipients" title="cryptui_prompt_recipients ()">cryptui_prompt_recipients</a> (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
51
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
52
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **signer</code></em>);
53
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="libcryptui-cryptui.html#cryptui-prompt-signer" title="cryptui_prompt_signer ()">cryptui_prompt_signer</a> (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
54
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
55
55
<span class="returnvalue">void</span> <a class="link" href="libcryptui-cryptui.html#cryptui-need-to-get-keys" title="cryptui_need_to_get_keys ()">cryptui_need_to_get_keys</a> ();
318
318
<div class="refsect2">
319
319
<a name="cryptui-key-get-enctype"></a><h3>cryptui_key_get_enctype ()</h3>
320
<pre class="programlisting"><a class="link" href="libcryptui-cryptui.html#CryptUIEncType" title="enum CryptUIEncType"><span class="returnvalue">CryptUIEncType</span></a> cryptui_key_get_enctype (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
320
<pre class="programlisting"><a class="link" href="libcryptui-cryptui.html#CryptUIEncType" title="enum CryptUIEncType"><span class="returnvalue">CryptUIEncType</span></a> cryptui_key_get_enctype (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
322
322
A utility function to get the type of key passed in. (public, private,
323
323
symmetric, etc.).
341
341
<div class="refsect2">
342
342
<a name="cryptui-display-notification"></a><h3>cryptui_display_notification ()</h3>
343
<pre class="programlisting"><span class="returnvalue">void</span> cryptui_display_notification (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
344
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *body</code></em>,
345
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>,
346
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>);</pre>
343
<pre class="programlisting"><span class="returnvalue">void</span> cryptui_display_notification (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
344
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *body</code></em>,
345
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon</code></em>,
346
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> urgent</code></em>);</pre>
348
348
This function creates a notification bubble that can be updated as additional
349
349
key details are discovered. See http://live.gnome.org/Seahorse/DBus for a
379
379
<div class="refsect2">
380
380
<a name="cryptui-prompt-recipients"></a><h3>cryptui_prompt_recipients ()</h3>
381
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** cryptui_prompt_recipients (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
382
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
383
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **signer</code></em>);</pre>
381
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** cryptui_prompt_recipients (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
382
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
383
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **signer</code></em>);</pre>
385
385
This function prompts the user to select one or more keys from the keyset to
386
386
use to encrypt to. It also allows the user to select a private key from the
412
412
<div class="refsect2">
413
413
<a name="cryptui-prompt-signer"></a><h3>cryptui_prompt_signer ()</h3>
414
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * cryptui_prompt_signer (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
415
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
414
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * cryptui_prompt_signer (<em class="parameter"><code><a class="link" href="libcryptui-cryptui-keyset.html#CryptUIKeyset" title="struct CryptUIKeyset"><span class="type">CryptUIKeyset</span></a> *keyset</code></em>,
415
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
417
417
This function prompts the user to select a private key from the keyset to
418
418
use to sign something.