← Back to branch summary

~ubuntu-branches/ubuntu/utopic/evolution-data-server/utopic-proposed

« back to all changes in this revision

Viewing changes to docs/reference/libedataserver/html/ESourceSMIME.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-06-13 12:02:14 UTC
  • mfrom: (1.1.116) (1.2.35 sid)
  • Revision ID: package-import@ubuntu.com-20140613120214-1zx93d8jxwt093aw
Tags: 3.12.2-1ubuntu1
* Merge with Debian, remaining changes:
  - debian/control: build depend on hardening-wrapper
  - Add build-depends and pass configure flag to enable Ubuntu Online
    Accounts support.
  - Filter out -Bsymbolic-functions from LDFLAGS (for future people
    wondering about this change, see e.g. BGO #594473 and duplicates).
  - Enable Ubuntu Online Accounts and split it and GOA into a separate
    package

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libedataserver/html/ESourceSMIME.html
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>ESourceSMIME</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
 
<link rel="home" href="index.html" title="Evolution-Data-Server Manual: Utilities (libedataserver)">
8
 
<link rel="up" href="ch02.html" title="Data Source Extensions">
9
 
<link rel="prev" href="ESourceSecurity.html" title="ESourceSecurity">
10
 
<link rel="next" href="ESourceTaskList.html" title="ESourceTaskList">
11
 
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
</head>
14
 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="ESourceSecurity.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">Evolution-Data-Server Manual: Utilities (libedataserver)</th>
21
 
<td><a accesskey="n" href="ESourceTaskList.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#ESourceSMIME.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#ESourceSMIME.description" class="shortcut">Description</a>
27
 
                   | 
28
 
                  <a href="#ESourceSMIME.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
 
                   | 
30
 
                  <a href="#ESourceSMIME.properties" class="shortcut">Properties</a>
31
 
</td></tr>
32
 
</table>
33
 
<div class="refentry">
34
 
<a name="ESourceSMIME"></a><div class="titlepage"></div>
35
 
<div class="refnamediv"><table width="100%"><tr>
36
 
<td valign="top">
37
 
<h2><span class="refentrytitle"><a name="ESourceSMIME.top_of_page"></a>ESourceSMIME</span></h2>
38
 
<p>ESourceSMIME — <a class="link" href="ESource.html" title="ESource"><span class="type">ESource</span></a> extension for S/MIME settings</p>
39
 
</td>
40
 
<td valign="top" align="right"></td>
41
 
</tr></table></div>
42
 
<div class="refsynopsisdiv">
43
 
<a name="ESourceSMIME.synopsis"></a><h2>Synopsis</h2>
44
 
<pre class="synopsis">
45
 
#include &lt;libedataserver/libedataserver.h&gt;
46
 
 
47
 
struct              <a class="link" href="ESourceSMIME.html#ESourceSMIME-struct" title="struct ESourceSMIME">ESourceSMIME</a>;
48
 
#define             <a class="link" href="ESourceSMIME.html#E-SOURCE-EXTENSION-SMIME:CAPS" title="E_SOURCE_EXTENSION_SMIME">E_SOURCE_EXTENSION_SMIME</a>
49
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceSMIME.html#e-source-smime-get-encryption-certificate" title="e_source_smime_get_encryption_certificate ()">e_source_smime_get_encryption_certificate</a>
50
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
51
 
<span class="returnvalue">gchar</span> *             <a class="link" href="ESourceSMIME.html#e-source-smime-dup-encryption-certificate" title="e_source_smime_dup_encryption_certificate ()">e_source_smime_dup_encryption_certificate</a>
52
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
53
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-encryption-certificate" title="e_source_smime_set_encryption_certificate ()">e_source_smime_set_encryption_certificate</a>
54
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
55
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *encryption_certificate</code></em>);
56
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSMIME.html#e-source-smime-get-encrypt-by-default" title="e_source_smime_get_encrypt_by_default ()">e_source_smime_get_encrypt_by_default</a>
57
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
58
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-encrypt-by-default" title="e_source_smime_set_encrypt_by_default ()">e_source_smime_set_encrypt_by_default</a>
59
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
60
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_by_default</code></em>);
61
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSMIME.html#e-source-smime-get-encrypt-to-self" title="e_source_smime_get_encrypt_to_self ()">e_source_smime_get_encrypt_to_self</a>  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
62
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-encrypt-to-self" title="e_source_smime_set_encrypt_to_self ()">e_source_smime_set_encrypt_to_self</a>  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
63
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_to_self</code></em>);
64
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceSMIME.html#e-source-smime-get-signing-algorithm" title="e_source_smime_get_signing_algorithm ()">e_source_smime_get_signing_algorithm</a>
65
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
66
 
<span class="returnvalue">gchar</span> *             <a class="link" href="ESourceSMIME.html#e-source-smime-dup-signing-algorithm" title="e_source_smime_dup_signing_algorithm ()">e_source_smime_dup_signing_algorithm</a>
67
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
68
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-signing-algorithm" title="e_source_smime_set_signing_algorithm ()">e_source_smime_set_signing_algorithm</a>
69
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
70
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_algorithm</code></em>);
71
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceSMIME.html#e-source-smime-get-signing-certificate" title="e_source_smime_get_signing_certificate ()">e_source_smime_get_signing_certificate</a>
72
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
73
 
<span class="returnvalue">gchar</span> *             <a class="link" href="ESourceSMIME.html#e-source-smime-dup-signing-certificate" title="e_source_smime_dup_signing_certificate ()">e_source_smime_dup_signing_certificate</a>
74
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
75
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-signing-certificate" title="e_source_smime_set_signing_certificate ()">e_source_smime_set_signing_certificate</a>
76
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
77
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_certificate</code></em>);
78
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSMIME.html#e-source-smime-get-sign-by-default" title="e_source_smime_get_sign_by_default ()">e_source_smime_get_sign_by_default</a>  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);
79
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSMIME.html#e-source-smime-set-sign-by-default" title="e_source_smime_set_sign_by_default ()">e_source_smime_set_sign_by_default</a>  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
80
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> sign_by_default</code></em>);
81
 
</pre>
82
 
</div>
83
 
<div class="refsect1">
84
 
<a name="ESourceSMIME.object-hierarchy"></a><h2>Object Hierarchy</h2>
85
 
<pre class="synopsis">
86
 
  GObject
87
 
   +----<a class="link" href="ESourceExtension.html" title="ESourceExtension">ESourceExtension</a>
88
 
         +----ESourceSMIME
89
 
</pre>
90
 
</div>
91
 
<div class="refsect1">
92
 
<a name="ESourceSMIME.properties"></a><h2>Properties</h2>
93
 
<pre class="synopsis">
94
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--encrypt-by-default" title='The "encrypt-by-default" property'>encrypt-by-default</a>"       <span class="type">gboolean</span>              : Read / Write / Construct
95
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--encrypt-to-self" title='The "encrypt-to-self" property'>encrypt-to-self</a>"          <span class="type">gboolean</span>              : Read / Write / Construct
96
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--encryption-certificate" title='The "encryption-certificate" property'>encryption-certificate</a>"   <span class="type">gchar</span>*                : Read / Write / Construct
97
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--sign-by-default" title='The "sign-by-default" property'>sign-by-default</a>"          <span class="type">gboolean</span>              : Read / Write / Construct
98
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--signing-algorithm" title='The "signing-algorithm" property'>signing-algorithm</a>"        <span class="type">gchar</span>*                : Read / Write / Construct
99
 
  "<a class="link" href="ESourceSMIME.html#ESourceSMIME--signing-certificate" title='The "signing-certificate" property'>signing-certificate</a>"      <span class="type">gchar</span>*                : Read / Write / Construct
100
 
</pre>
101
 
</div>
102
 
<div class="refsect1">
103
 
<a name="ESourceSMIME.description"></a><h2>Description</h2>
104
 
<p>
105
 
The <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> extension tracks Secure/Multipurpose Internet Mail
106
 
Extensions (S/MIME) settings to be applied to outgoing mail messages.
107
 
</p>
108
 
<p>
109
 
Access the extension as follows:
110
 
</p>
111
 
<p>
112
 
</p>
113
 
<div class="informalexample">
114
 
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
115
 
    <tbody>
116
 
      <tr>
117
 
        <td class="listing_lines" align="right"><pre>1
118
 
2
119
 
3
120
 
4
121
 
5</pre></td>
122
 
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include &lt;libedataserver/libedataserver.h&gt;</span>
123
 
 
124
 
ESourceSMIME <span class="gtkdoc opt">*</span>extension<span class="gtkdoc opt">;</span>
125
 
 
126
 
extension <span class="gtkdoc opt">=</span> <span class="function"><a href="ESource.html#e-source-get-extension">e_source_get_extension</a></span> <span class="gtkdoc opt">(</span>source<span class="gtkdoc opt">,</span> E_SOURCE_EXTENSION_SMIME<span class="gtkdoc opt">);</span></pre></td>
127
 
      </tr>
128
 
    </tbody>
129
 
  </table>
130
 
</div>
131
 
 
132
 
<p>
133
 
</p>
134
 
</div>
135
 
<div class="refsect1">
136
 
<a name="ESourceSMIME.details"></a><h2>Details</h2>
137
 
<div class="refsect2">
138
 
<a name="ESourceSMIME-struct"></a><h3>struct ESourceSMIME</h3>
139
 
<pre class="programlisting">struct ESourceSMIME;</pre>
140
 
<p>
141
 
Contains only private data that should be read and manipulated using the
142
 
functions below.
143
 
</p>
144
 
<p class="since">Since 3.6</p>
145
 
</div>
146
 
<hr>
147
 
<div class="refsect2">
148
 
<a name="E-SOURCE-EXTENSION-SMIME:CAPS"></a><h3>E_SOURCE_EXTENSION_SMIME</h3>
149
 
<pre class="programlisting">#define E_SOURCE_EXTENSION_SMIME "Secure MIME (S/MIME)"
150
 
</pre>
151
 
<p>
152
 
Pass this extension name to <a class="link" href="ESource.html#e-source-get-extension" title="e_source_get_extension ()"><code class="function">e_source_get_extension()</code></a> to access
153
 
<a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>.  This is also used as a group name in key files.
154
 
</p>
155
 
<p class="since">Since 3.6</p>
156
 
</div>
157
 
<hr>
158
 
<div class="refsect2">
159
 
<a name="e-source-smime-get-encryption-certificate"></a><h3>e_source_smime_get_encryption_certificate ()</h3>
160
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_smime_get_encryption_certificate
161
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
162
 
<p>
163
 
Returns the S/MIME certificate name used to encrypt messages.
164
 
</p>
165
 
<div class="variablelist"><table border="0">
166
 
<col align="left" valign="top">
167
 
<tbody>
168
 
<tr>
169
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
170
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
171
 
</td>
172
 
</tr>
173
 
<tr>
174
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
175
 
<td>the certificate name used to encrypt messages</td>
176
 
</tr>
177
 
</tbody>
178
 
</table></div>
179
 
<p class="since">Since 3.6</p>
180
 
</div>
181
 
<hr>
182
 
<div class="refsect2">
183
 
<a name="e-source-smime-dup-encryption-certificate"></a><h3>e_source_smime_dup_encryption_certificate ()</h3>
184
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             e_source_smime_dup_encryption_certificate
185
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
186
 
<p>
187
 
Thread-safe variation of <a class="link" href="ESourceSMIME.html#e-source-smime-get-encryption-certificate" title="e_source_smime_get_encryption_certificate ()"><code class="function">e_source_smime_get_encryption_certificate()</code></a>.
188
 
Use this function when accessing <em class="parameter"><code>extension</code></em> from multiple threads.
189
 
</p>
190
 
<p>
191
 
The returned string should be freed with <code class="function">g_free()</code> when no longer needed.
192
 
</p>
193
 
<div class="variablelist"><table border="0">
194
 
<col align="left" valign="top">
195
 
<tbody>
196
 
<tr>
197
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
198
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
199
 
</td>
200
 
</tr>
201
 
<tr>
202
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
203
 
<td>a newly-allocated copy of <a class="link" href="ESourceSMIME.html#ESourceSMIME--encryption-certificate" title='The "encryption-certificate" property'><span class="type">"encryption-certificate"</span></a>
204
 
</td>
205
 
</tr>
206
 
</tbody>
207
 
</table></div>
208
 
<p class="since">Since 3.6</p>
209
 
</div>
210
 
<hr>
211
 
<div class="refsect2">
212
 
<a name="e-source-smime-set-encryption-certificate"></a><h3>e_source_smime_set_encryption_certificate ()</h3>
213
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_encryption_certificate
214
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
215
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *encryption_certificate</code></em>);</pre>
216
 
<p>
217
 
Sets the certificate name used to encrypt messages.
218
 
</p>
219
 
<p>
220
 
The internal copy of <em class="parameter"><code>encryption_certificate</code></em> is automatically stripped
221
 
of leading and trailing whitespace.  If the resulting string is empty,
222
 
<code class="literal">NULL</code> is set instead.
223
 
</p>
224
 
<div class="variablelist"><table border="0">
225
 
<col align="left" valign="top">
226
 
<tbody>
227
 
<tr>
228
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
229
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
230
 
</td>
231
 
</tr>
232
 
<tr>
233
 
<td><p><span class="term"><em class="parameter"><code>encryption_certificate</code></em> :</span></p></td>
234
 
<td>the certificate name used to encrypt
235
 
messages, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
236
 
</td>
237
 
</tr>
238
 
</tbody>
239
 
</table></div>
240
 
<p class="since">Since 3.6</p>
241
 
</div>
242
 
<hr>
243
 
<div class="refsect2">
244
 
<a name="e-source-smime-get-encrypt-by-default"></a><h3>e_source_smime_get_encrypt_by_default ()</h3>
245
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_smime_get_encrypt_by_default
246
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
247
 
<p>
248
 
Returns whether to encrypt outgoing messages by default using S/MIME
249
 
software such as Mozilla Network Security Services (NSS).
250
 
</p>
251
 
<div class="variablelist"><table border="0">
252
 
<col align="left" valign="top">
253
 
<tbody>
254
 
<tr>
255
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
256
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
257
 
</td>
258
 
</tr>
259
 
<tr>
260
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
261
 
<td>whether to encrypt outgoing messages by default</td>
262
 
</tr>
263
 
</tbody>
264
 
</table></div>
265
 
<p class="since">Since 3.6</p>
266
 
</div>
267
 
<hr>
268
 
<div class="refsect2">
269
 
<a name="e-source-smime-set-encrypt-by-default"></a><h3>e_source_smime_set_encrypt_by_default ()</h3>
270
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_encrypt_by_default
271
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
272
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_by_default</code></em>);</pre>
273
 
<p>
274
 
Sets whether to encrypt outgoing messages by default using S/MIME
275
 
software such as Mozilla Network Security Services (NSS).
276
 
</p>
277
 
<div class="variablelist"><table border="0">
278
 
<col align="left" valign="top">
279
 
<tbody>
280
 
<tr>
281
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
282
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
283
 
</td>
284
 
</tr>
285
 
<tr>
286
 
<td><p><span class="term"><em class="parameter"><code>encrypt_by_default</code></em> :</span></p></td>
287
 
<td>whether to encrypt outgoing messages by default</td>
288
 
</tr>
289
 
</tbody>
290
 
</table></div>
291
 
<p class="since">Since 3.6</p>
292
 
</div>
293
 
<hr>
294
 
<div class="refsect2">
295
 
<a name="e-source-smime-get-encrypt-to-self"></a><h3>e_source_smime_get_encrypt_to_self ()</h3>
296
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_smime_get_encrypt_to_self  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
297
 
<p>
298
 
Returns whether to "encrypt-to-self" when sending encrypted messages.
299
 
</p>
300
 
<div class="variablelist"><table border="0">
301
 
<col align="left" valign="top">
302
 
<tbody>
303
 
<tr>
304
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
305
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
306
 
</td>
307
 
</tr>
308
 
<tr>
309
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
310
 
<td>whether to "encrypt-to-self"</td>
311
 
</tr>
312
 
</tbody>
313
 
</table></div>
314
 
<p class="since">Since 3.6</p>
315
 
</div>
316
 
<hr>
317
 
<div class="refsect2">
318
 
<a name="e-source-smime-set-encrypt-to-self"></a><h3>e_source_smime_set_encrypt_to_self ()</h3>
319
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_encrypt_to_self  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
320
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_to_self</code></em>);</pre>
321
 
<p>
322
 
Sets whether to "encrypt-to-self" when sending encrypted messages.
323
 
</p>
324
 
<div class="variablelist"><table border="0">
325
 
<col align="left" valign="top">
326
 
<tbody>
327
 
<tr>
328
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
329
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
330
 
</td>
331
 
</tr>
332
 
<tr>
333
 
<td><p><span class="term"><em class="parameter"><code>encrypt_to_self</code></em> :</span></p></td>
334
 
<td>whether to "encrypt-to-self"</td>
335
 
</tr>
336
 
</tbody>
337
 
</table></div>
338
 
<p class="since">Since 3.6</p>
339
 
</div>
340
 
<hr>
341
 
<div class="refsect2">
342
 
<a name="e-source-smime-get-signing-algorithm"></a><h3>e_source_smime_get_signing_algorithm ()</h3>
343
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_smime_get_signing_algorithm
344
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
345
 
<p>
346
 
Returns the name of the hash algorithm used to digitally sign outgoing
347
 
messages.
348
 
</p>
349
 
<div class="variablelist"><table border="0">
350
 
<col align="left" valign="top">
351
 
<tbody>
352
 
<tr>
353
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
354
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
355
 
</td>
356
 
</tr>
357
 
<tr>
358
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
359
 
<td>the signing algorithm for outgoing messages</td>
360
 
</tr>
361
 
</tbody>
362
 
</table></div>
363
 
<p class="since">Since 3.6</p>
364
 
</div>
365
 
<hr>
366
 
<div class="refsect2">
367
 
<a name="e-source-smime-dup-signing-algorithm"></a><h3>e_source_smime_dup_signing_algorithm ()</h3>
368
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             e_source_smime_dup_signing_algorithm
369
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
370
 
<p>
371
 
Thread-safe variation of <a class="link" href="ESourceSMIME.html#e-source-smime-get-signing-algorithm" title="e_source_smime_get_signing_algorithm ()"><code class="function">e_source_smime_get_signing_algorithm()</code></a>.
372
 
Use this function when accessing <em class="parameter"><code>extension</code></em> from multiple threads.
373
 
</p>
374
 
<p>
375
 
The returned string should be freed with <code class="function">g_free()</code> when no longer needed.
376
 
</p>
377
 
<div class="variablelist"><table border="0">
378
 
<col align="left" valign="top">
379
 
<tbody>
380
 
<tr>
381
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
382
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
383
 
</td>
384
 
</tr>
385
 
<tr>
386
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
387
 
<td>a newly-allocated copy of <a class="link" href="ESourceSMIME.html#ESourceSMIME--signing-algorithm" title='The "signing-algorithm" property'><span class="type">"signing-algorithm"</span></a>
388
 
</td>
389
 
</tr>
390
 
</tbody>
391
 
</table></div>
392
 
<p class="since">Since 3.6</p>
393
 
</div>
394
 
<hr>
395
 
<div class="refsect2">
396
 
<a name="e-source-smime-set-signing-algorithm"></a><h3>e_source_smime_set_signing_algorithm ()</h3>
397
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_signing_algorithm
398
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
399
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_algorithm</code></em>);</pre>
400
 
<p>
401
 
Sets the name of the hash algorithm used to digitally sign outgoing
402
 
messages.
403
 
</p>
404
 
<p>
405
 
The internal copy of <em class="parameter"><code>signing_algorithm</code></em> is automatically stripped of
406
 
leading and trailing whitespace.  If the resulting string is empty,
407
 
<code class="literal">NULL</code> is set instead.
408
 
</p>
409
 
<div class="variablelist"><table border="0">
410
 
<col align="left" valign="top">
411
 
<tbody>
412
 
<tr>
413
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
414
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
415
 
</td>
416
 
</tr>
417
 
<tr>
418
 
<td><p><span class="term"><em class="parameter"><code>signing_algorithm</code></em> :</span></p></td>
419
 
<td>the signing algorithm for outgoing
420
 
messages, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
421
 
</td>
422
 
</tr>
423
 
</tbody>
424
 
</table></div>
425
 
<p class="since">Since 3.6</p>
426
 
</div>
427
 
<hr>
428
 
<div class="refsect2">
429
 
<a name="e-source-smime-get-signing-certificate"></a><h3>e_source_smime_get_signing_certificate ()</h3>
430
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_smime_get_signing_certificate
431
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
432
 
<p>
433
 
Returns the S/MIME certificate name used to sign messages.
434
 
</p>
435
 
<div class="variablelist"><table border="0">
436
 
<col align="left" valign="top">
437
 
<tbody>
438
 
<tr>
439
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
440
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
441
 
</td>
442
 
</tr>
443
 
<tr>
444
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
445
 
<td>the certificate name used to sign messages</td>
446
 
</tr>
447
 
</tbody>
448
 
</table></div>
449
 
<p class="since">Since 3.6</p>
450
 
</div>
451
 
<hr>
452
 
<div class="refsect2">
453
 
<a name="e-source-smime-dup-signing-certificate"></a><h3>e_source_smime_dup_signing_certificate ()</h3>
454
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             e_source_smime_dup_signing_certificate
455
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
456
 
<p>
457
 
Thread-safe variation of <a class="link" href="ESourceSMIME.html#e-source-smime-get-signing-certificate" title="e_source_smime_get_signing_certificate ()"><code class="function">e_source_smime_get_signing_certificate()</code></a>.
458
 
Use this function when accessing <em class="parameter"><code>extension</code></em> from multiple threads.
459
 
</p>
460
 
<p>
461
 
The returned string should be freed with <code class="function">g_free()</code> when no longer needed.
462
 
</p>
463
 
<div class="variablelist"><table border="0">
464
 
<col align="left" valign="top">
465
 
<tbody>
466
 
<tr>
467
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
468
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
469
 
</td>
470
 
</tr>
471
 
<tr>
472
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
473
 
<td>a newly-allocated copy of <a class="link" href="ESourceSMIME.html#ESourceSMIME--signing-certificate" title='The "signing-certificate" property'><span class="type">"signing-certificate"</span></a>
474
 
</td>
475
 
</tr>
476
 
</tbody>
477
 
</table></div>
478
 
<p class="since">Since 3.6</p>
479
 
</div>
480
 
<hr>
481
 
<div class="refsect2">
482
 
<a name="e-source-smime-set-signing-certificate"></a><h3>e_source_smime_set_signing_certificate ()</h3>
483
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_signing_certificate
484
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
485
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_certificate</code></em>);</pre>
486
 
<p>
487
 
Sets the S/MIME certificate name used to sign messages.
488
 
</p>
489
 
<p>
490
 
The internal copy of <em class="parameter"><code>signing_certificate</code></em> is automatically stripped
491
 
of leading and trailing whitespace.  If the resulting string is empty,
492
 
<code class="literal">NULL</code> is set instead.
493
 
</p>
494
 
<div class="variablelist"><table border="0">
495
 
<col align="left" valign="top">
496
 
<tbody>
497
 
<tr>
498
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
499
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
500
 
</td>
501
 
</tr>
502
 
<tr>
503
 
<td><p><span class="term"><em class="parameter"><code>signing_certificate</code></em> :</span></p></td>
504
 
<td>the certificate name used to sign
505
 
messages, or <code class="literal">NULL</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
506
 
</td>
507
 
</tr>
508
 
</tbody>
509
 
</table></div>
510
 
<p class="since">Since 3.6</p>
511
 
</div>
512
 
<hr>
513
 
<div class="refsect2">
514
 
<a name="e-source-smime-get-sign-by-default"></a><h3>e_source_smime_get_sign_by_default ()</h3>
515
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_smime_get_sign_by_default  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>);</pre>
516
 
<p>
517
 
Returns whether to digitally sign outgoing messages by default using
518
 
S/MIME software such as Mozilla Network Security Services (NSS).
519
 
</p>
520
 
<div class="variablelist"><table border="0">
521
 
<col align="left" valign="top">
522
 
<tbody>
523
 
<tr>
524
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
525
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
526
 
</td>
527
 
</tr>
528
 
<tr>
529
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
530
 
<td>whether to sign outgoing messages by default</td>
531
 
</tr>
532
 
</tbody>
533
 
</table></div>
534
 
<p class="since">Since 3.6</p>
535
 
</div>
536
 
<hr>
537
 
<div class="refsect2">
538
 
<a name="e-source-smime-set-sign-by-default"></a><h3>e_source_smime_set_sign_by_default ()</h3>
539
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_smime_set_sign_by_default  (<em class="parameter"><code><a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a> *extension</code></em>,
540
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> sign_by_default</code></em>);</pre>
541
 
<p>
542
 
Sets whether to digitally sign outgoing messages by default using
543
 
S/MIME software such as Mozilla Network Security Services (NSS).
544
 
</p>
545
 
<div class="variablelist"><table border="0">
546
 
<col align="left" valign="top">
547
 
<tbody>
548
 
<tr>
549
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
550
 
<td>an <a class="link" href="ESourceSMIME.html" title="ESourceSMIME"><span class="type">ESourceSMIME</span></a>
551
 
</td>
552
 
</tr>
553
 
<tr>
554
 
<td><p><span class="term"><em class="parameter"><code>sign_by_default</code></em> :</span></p></td>
555
 
<td>whether to sign outgoing messages by default</td>
556
 
</tr>
557
 
</tbody>
558
 
</table></div>
559
 
<p class="since">Since 3.6</p>
560
 
</div>
561
 
</div>
562
 
<div class="refsect1">
563
 
<a name="ESourceSMIME.property-details"></a><h2>Property Details</h2>
564
 
<div class="refsect2">
565
 
<a name="ESourceSMIME--encrypt-by-default"></a><h3>The <code class="literal">"encrypt-by-default"</code> property</h3>
566
 
<pre class="programlisting">  "encrypt-by-default"       <span class="type">gboolean</span>              : Read / Write / Construct</pre>
567
 
<p>Encrypt outgoing messages by default.</p>
568
 
<p>Default value: FALSE</p>
569
 
</div>
570
 
<hr>
571
 
<div class="refsect2">
572
 
<a name="ESourceSMIME--encrypt-to-self"></a><h3>The <code class="literal">"encrypt-to-self"</code> property</h3>
573
 
<pre class="programlisting">  "encrypt-to-self"          <span class="type">gboolean</span>              : Read / Write / Construct</pre>
574
 
<p>Always encrypt to myself.</p>
575
 
<p>Default value: TRUE</p>
576
 
</div>
577
 
<hr>
578
 
<div class="refsect2">
579
 
<a name="ESourceSMIME--encryption-certificate"></a><h3>The <code class="literal">"encryption-certificate"</code> property</h3>
580
 
<pre class="programlisting">  "encryption-certificate"   <span class="type">gchar</span>*                : Read / Write / Construct</pre>
581
 
<p>S/MIME certificate for encrypting messages.</p>
582
 
<p>Default value: NULL</p>
583
 
</div>
584
 
<hr>
585
 
<div class="refsect2">
586
 
<a name="ESourceSMIME--sign-by-default"></a><h3>The <code class="literal">"sign-by-default"</code> property</h3>
587
 
<pre class="programlisting">  "sign-by-default"          <span class="type">gboolean</span>              : Read / Write / Construct</pre>
588
 
<p>Sign outgoing messages by default.</p>
589
 
<p>Default value: FALSE</p>
590
 
</div>
591
 
<hr>
592
 
<div class="refsect2">
593
 
<a name="ESourceSMIME--signing-algorithm"></a><h3>The <code class="literal">"signing-algorithm"</code> property</h3>
594
 
<pre class="programlisting">  "signing-algorithm"        <span class="type">gchar</span>*                : Read / Write / Construct</pre>
595
 
<p>Hash algorithm used to sign messages.</p>
596
 
<p>Default value: NULL</p>
597
 
</div>
598
 
<hr>
599
 
<div class="refsect2">
600
 
<a name="ESourceSMIME--signing-certificate"></a><h3>The <code class="literal">"signing-certificate"</code> property</h3>
601
 
<pre class="programlisting">  "signing-certificate"      <span class="type">gchar</span>*                : Read / Write / Construct</pre>
602
 
<p>S/MIME certificate for signing messages.</p>
603
 
<p>Default value: NULL</p>
604
 
</div>
605
 
</div>
606
 
</div>
607
 
<div class="footer">
608
 
<hr>
609
 
          Generated by GTK-Doc V1.19</div>
610
 
</body>
611
 
</html>
 
 
b'\\ No newline at end of file'