4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>CamelSession</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="Camel Reference Manual">
8
8
<link rel="up" href="Services.html" title="Services">
9
9
<link rel="prev" href="Services.html" title="Services">
10
10
<link rel="next" href="camel-camel-provider.html" title="camel-provider">
11
<meta name="generator" content="GTK-Doc V1.17.1 (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">
45
45
<a name="CamelSession.synopsis"></a><h2>Synopsis</h2>
46
46
<pre class="synopsis">struct <a class="link" href="CamelSession.html#CamelSession-struct" title="struct CamelSession">CamelSession</a>;
47
47
enum <a class="link" href="CamelSession.html#CamelSessionAlertType" title="enum CamelSessionAlertType">CamelSessionAlertType</a>;
48
const <span class="returnvalue">gchar</span> * <a class="link" href="CamelSession.html#camel-session-get-user-data-dir" title="camel_session_get_user_data_dir ()">camel_session_get_user_data_dir</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
48
const <span class="returnvalue">gchar</span> * <a class="link" href="CamelSession.html#camel-session-get-user-data-dir" title="camel_session_get_user_data_dir ()">camel_session_get_user_data_dir</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
49
49
<span class="returnvalue">void</span> <a class="link" href="CamelSession.html#camel-session-set-socks-proxy" title="camel_session_set_socks_proxy ()">camel_session_set_socks_proxy</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
50
50
<em class="parameter"><code>const <span class="type">gchar</span> *socks_host</code></em>,
51
51
<em class="parameter"><code><span class="type">gint</span> socks_port</code></em>);
52
52
<span class="returnvalue">void</span> <a class="link" href="CamelSession.html#camel-session-get-socks-proxy" title="camel_session_get_socks_proxy ()">camel_session_get_socks_proxy</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
53
53
<em class="parameter"><code><span class="type">gchar</span> **host_ret</code></em>,
54
54
<em class="parameter"><code><span class="type">gint</span> *port_ret</code></em>);
55
<a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * <a class="link" href="CamelSession.html#camel-session-add-service" title="camel_session_add_service ()">camel_session_add_service</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
55
<a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * <a class="link" href="CamelSession.html#camel-session-add-service" title="camel_session_add_service ()">camel_session_add_service</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
56
56
<em class="parameter"><code>const <span class="type">gchar</span> *uid</code></em>,
57
57
<em class="parameter"><code>const <span class="type">gchar</span> *uri_string</code></em>,
58
58
<em class="parameter"><code><a class="link" href="camel-camel-provider.html#CamelProviderType" title="enum CamelProviderType"><span class="type">CamelProviderType</span></a> type</code></em>,
59
59
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
60
<a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * <a class="link" href="CamelSession.html#camel-session-get-service" title="camel_session_get_service ()">camel_session_get_service</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
60
<a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * <a class="link" href="CamelSession.html#camel-session-get-service" title="camel_session_get_service ()">camel_session_get_service</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
61
61
<em class="parameter"><code>const <span class="type">gchar</span> *uid</code></em>);
62
62
<a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * <a class="link" href="CamelSession.html#camel-session-get-service-by-url" title="camel_session_get_service_by_url ()">camel_session_get_service_by_url</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
63
63
<em class="parameter"><code><a class="link" href="camel-camel-url.html#CamelURL" title="struct CamelURL"><span class="type">CamelURL</span></a> *url</code></em>,
64
64
<em class="parameter"><code><a class="link" href="camel-camel-provider.html#CamelProviderType" title="enum CamelProviderType"><span class="type">CamelProviderType</span></a> type</code></em>);
65
<span class="returnvalue">GList</span> * <a class="link" href="CamelSession.html#camel-session-list-services" title="camel_session_list_services ()">camel_session_list_services</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
66
<span class="returnvalue">gchar</span> * <a class="link" href="CamelSession.html#camel-session-get-password" title="camel_session_get_password ()">camel_session_get_password</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
65
<span class="returnvalue">GList</span> * <a class="link" href="CamelSession.html#camel-session-list-services" title="camel_session_list_services ()">camel_session_list_services</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
66
<span class="returnvalue">void</span> <a class="link" href="CamelSession.html#camel-session-remove-services" title="camel_session_remove_services ()">camel_session_remove_services</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
67
<span class="returnvalue">gchar</span> * <a class="link" href="CamelSession.html#camel-session-get-password" title="camel_session_get_password ()">camel_session_get_password</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
67
68
<em class="parameter"><code><a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> *service</code></em>,
68
69
<em class="parameter"><code>const <span class="type">gchar</span> *prompt</code></em>,
69
70
<em class="parameter"><code>const <span class="type">gchar</span> *item</code></em>,
89
90
<span class="returnvalue">gboolean</span> <a class="link" href="CamelSession.html#camel-session-get-check-junk" title="camel_session_get_check_junk ()">camel_session_get_check_junk</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
90
91
<span class="returnvalue">void</span> <a class="link" href="CamelSession.html#camel-session-set-check-junk" title="camel_session_set_check_junk ()">camel_session_set_check_junk</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
91
92
<em class="parameter"><code><span class="type">gboolean</span> check_junk</code></em>);
93
<a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="returnvalue">CamelJunkFilter</span></a> * <a class="link" href="CamelSession.html#camel-session-get-junk-filter" title="camel_session_get_junk_filter ()">camel_session_get_junk_filter</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);
94
<span class="returnvalue">void</span> <a class="link" href="CamelSession.html#camel-session-set-junk-filter" title="camel_session_set_junk_filter ()">camel_session_set_junk_filter</a> (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
95
<em class="parameter"><code><a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> *junk_filter</code></em>);
92
96
<span class="returnvalue">void</span> (<a class="link" href="CamelSession.html#CamelSessionCallback" title="CamelSessionCallback ()">*CamelSessionCallback</a>) (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
93
97
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
94
98
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
131
135
<a name="CamelSession.properties"></a><h2>Properties</h2>
132
136
<pre class="synopsis">
133
137
"<a class="link" href="CamelSession.html#CamelSession--check-junk" title='The "check-junk" property'>check-junk</a>" <span class="type">gboolean</span> : Read / Write / Construct
138
"<a class="link" href="CamelSession.html#CamelSession--junk-filter" title='The "junk-filter" property'>junk-filter</a>" <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a>* : Read / Write
134
139
"<a class="link" href="CamelSession.html#CamelSession--network-available" title='The "network-available" property'>network-available</a>" <span class="type">gboolean</span> : Read / Write / Construct
135
140
"<a class="link" href="CamelSession.html#CamelSession--online" title='The "online" property'>online</a>" <span class="type">gboolean</span> : Read / Write / Construct
136
141
"<a class="link" href="CamelSession.html#CamelSession--user-data-dir" title='The "user-data-dir" property'>user-data-dir</a>" <span class="type">gchar</span>* : Read / Write / Construct
255
260
<div class="refsect2">
256
261
<a name="camel-session-add-service"></a><h3>camel_session_add_service ()</h3>
257
<pre class="programlisting"><a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * camel_session_add_service (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
262
<pre class="programlisting"><a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * camel_session_add_service (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
258
263
<em class="parameter"><code>const <span class="type">gchar</span> *uid</code></em>,
259
264
<em class="parameter"><code>const <span class="type">gchar</span> *uri_string</code></em>,
260
265
<em class="parameter"><code><a class="link" href="camel-camel-provider.html#CamelProviderType" title="enum CamelProviderType"><span class="type">CamelProviderType</span></a> type</code></em>,
300
305
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
301
<td>return location for a <span class="type">GError</span>, or <a href="/home/chen/opt-unstable/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
306
<td>return location for a <span class="type">GError</span>, or <code class="literal">NULL</code>
305
310
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
306
<td>a <a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> instance, or <a href="/home/chen/opt-unstable/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
311
<td>a <a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> instance, or <code class="literal">NULL</code>
314
319
<div class="refsect2">
315
320
<a name="camel-session-get-service"></a><h3>camel_session_get_service ()</h3>
316
<pre class="programlisting"><a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * camel_session_get_service (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
321
<pre class="programlisting"><a class="link" href="CamelService.html" title="CamelService"><span class="returnvalue">CamelService</span></a> * camel_session_get_service (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
317
322
<em class="parameter"><code>const <span class="type">gchar</span> *uid</code></em>);</pre>
319
324
Looks up a <a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> by its unique identifier string. The service
408
413
<div class="refsect2">
414
<a name="camel-session-remove-services"></a><h3>camel_session_remove_services ()</h3>
415
<pre class="programlisting"><span class="returnvalue">void</span> camel_session_remove_services (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);</pre>
417
Removes all <a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> instances added by <a class="link" href="CamelSession.html#camel-session-add-service" title="camel_session_add_service ()"><code class="function">camel_session_add_service()</code></a>.
420
This can be useful during application shutdown to ensure all <a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a>
421
instances are freed properly, especially since <a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> instances are
422
prone to reference cycles.
424
<div class="variablelist"><table border="0">
425
<col align="left" valign="top">
427
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
428
<td>a <a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a>
432
<p class="since">Since 3.2</p>
435
<div class="refsect2">
409
436
<a name="camel-session-get-password"></a><h3>camel_session_get_password ()</h3>
410
<pre class="programlisting"><span class="returnvalue">gchar</span> * camel_session_get_password (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
437
<pre class="programlisting"><span class="returnvalue">gchar</span> * camel_session_get_password (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
411
438
<em class="parameter"><code><a class="link" href="CamelService.html" title="CamelService"><span class="type">CamelService</span></a> *service</code></em>,
412
439
<em class="parameter"><code>const <span class="type">gchar</span> *prompt</code></em>,
413
440
<em class="parameter"><code>const <span class="type">gchar</span> *item</code></em>,
467
494
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
468
<td>return location for a <span class="type">GError</span>, or <a href="/home/chen/opt-unstable/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
495
<td>return location for a <span class="type">GError</span>, or <code class="literal">NULL</code>
472
499
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
473
<td>the authentication information or <a href="/home/chen/opt-unstable/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
500
<td>the authentication information or <code class="literal">NULL</code>
719
746
<div class="refsect2">
747
<a name="camel-session-get-junk-filter"></a><h3>camel_session_get_junk_filter ()</h3>
748
<pre class="programlisting"><a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="returnvalue">CamelJunkFilter</span></a> * camel_session_get_junk_filter (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);</pre>
750
Returns the <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> instance used to classify messages as
751
junk or not junk during filtering.
754
Note that <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> itself is just an interface. The application
755
must implement the interface and install a <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> instance for
756
junk filtering to take place.
758
<div class="variablelist"><table border="0">
759
<col align="left" valign="top">
762
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
763
<td>a <a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a>
767
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
768
<td>a <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a>, or <code class="literal">NULL</code>
773
<p class="since">Since 3.2</p>
776
<div class="refsect2">
777
<a name="camel-session-set-junk-filter"></a><h3>camel_session_set_junk_filter ()</h3>
778
<pre class="programlisting"><span class="returnvalue">void</span> camel_session_set_junk_filter (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
779
<em class="parameter"><code><a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> *junk_filter</code></em>);</pre>
781
Installs the <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> instance used to classify messages as
782
junk or not junk during filtering.
785
Note that <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> itself is just an interface. The application
786
must implement the interface and install a <a class="link" href="CamelJunkFilter.html" title="CamelJunkFilter"><span class="type">CamelJunkFilter</span></a> instance for
787
junk filtering to take place.
789
<div class="variablelist"><table border="0">
790
<col align="left" valign="top">
792
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
793
<td>a <a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a>
797
<p class="since">Since 3.2</p>
800
<div class="refsect2">
720
801
<a name="CamelSessionCallback"></a><h3>CamelSessionCallback ()</h3>
721
802
<pre class="programlisting"><span class="returnvalue">void</span> (*CamelSessionCallback) (<em class="parameter"><code><a class="link" href="CamelSession.html" title="CamelSession"><span class="type">CamelSession</span></a> *session</code></em>,
722
803
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
724
805
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
726
807
This is the callback signature for jobs submitted to the CamelSession
727
via <a class="link" href="CamelSession.html#camel-session-submit-job" title="camel_session_submit_job ()"><code class="function">camel_session_submit_job()</code></a>. The <em class="parameter"><code>error</code></em> pointer is always non-<a href="/home/chen/opt-unstable/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>,
808
via <a class="link" href="CamelSession.html#camel-session-submit-job" title="camel_session_submit_job ()"><code class="function">camel_session_submit_job()</code></a>. The <em class="parameter"><code>error</code></em> pointer is always non-<code class="literal">NULL</code>,
728
809
so it's safe to dereference to check if a <span class="type">GError</span> has been set.
730
811
<div class="variablelist"><table border="0">