38
38
<div class="refsynopsisdiv">
39
39
<a name="libedataserverui-EClient-Utilities.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">enum <a class="link" href="libedataserverui-EClient-Utilities.html#EClientSourceType" title="enum EClientSourceType">EClientSourceType</a>;
41
<span class="returnvalue">EClient</span> * <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-new" title="e_client_utils_new ()">e_client_utils_new</a> (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
41
<a href="../libedataserver/EClient.html"><span class="returnvalue">EClient</span></a> * <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-new" title="e_client_utils_new ()">e_client_utils_new</a> (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
42
42
<em class="parameter"><code><a class="link" href="libedataserverui-EClient-Utilities.html#EClientSourceType" title="enum EClientSourceType"><span class="type">EClientSourceType</span></a> source_type</code></em>,
43
43
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
44
<span class="returnvalue">void</span> <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new" title="e_client_utils_open_new ()">e_client_utils_open_new</a> (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
44
<span class="returnvalue">void</span> <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new" title="e_client_utils_open_new ()">e_client_utils_open_new</a> (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
45
45
<em class="parameter"><code><a class="link" href="libedataserverui-EClient-Utilities.html#EClientSourceType" title="enum EClientSourceType"><span class="type">EClientSourceType</span></a> source_type</code></em>,
46
46
<em class="parameter"><code><span class="type">gboolean</span> only_if_exists</code></em>,
47
47
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
48
48
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> async_cb</code></em>,
49
49
<em class="parameter"><code><span class="type">gpointer</span> async_cb_user_data</code></em>);
50
<span class="returnvalue">gboolean</span> <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new-finish" title="e_client_utils_open_new_finish ()">e_client_utils_open_new_finish</a> (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
50
<span class="returnvalue">gboolean</span> <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new-finish" title="e_client_utils_open_new_finish ()">e_client_utils_open_new_finish</a> (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
51
51
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
52
<em class="parameter"><code><span class="type">EClient</span> **client</code></em>,
52
<em class="parameter"><code><a href="../libedataserver/EClient.html"><span class="type">EClient</span></a> **client</code></em>,
53
53
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
74
74
<div class="refsect2">
75
75
<a name="e-client-utils-new"></a><h3>e_client_utils_new ()</h3>
76
<pre class="programlisting"><span class="returnvalue">EClient</span> * e_client_utils_new (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
76
<pre class="programlisting"><a href="../libedataserver/EClient.html"><span class="returnvalue">EClient</span></a> * e_client_utils_new (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
77
77
<em class="parameter"><code><a class="link" href="libedataserverui-EClient-Utilities.html#EClientSourceType" title="enum EClientSourceType"><span class="type">EClientSourceType</span></a> source_type</code></em>,
78
78
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
85
85
<div class="refsect2">
86
86
<a name="e-client-utils-open-new"></a><h3>e_client_utils_open_new ()</h3>
87
<pre class="programlisting"><span class="returnvalue">void</span> e_client_utils_open_new (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
87
<pre class="programlisting"><span class="returnvalue">void</span> e_client_utils_open_new (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
88
88
<em class="parameter"><code><a class="link" href="libedataserverui-EClient-Utilities.html#EClientSourceType" title="enum EClientSourceType"><span class="type">EClientSourceType</span></a> source_type</code></em>,
89
89
<em class="parameter"><code><span class="type">gboolean</span> only_if_exists</code></em>,
90
90
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
91
91
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> async_cb</code></em>,
92
92
<em class="parameter"><code><span class="type">gpointer</span> async_cb_user_data</code></em>);</pre>
94
Begins asynchronous opening of a new <span class="type">EClient</span> corresponding
95
to the <em class="parameter"><code>source</code></em> of type <em class="parameter"><code>source_type</code></em>. The resulting <span class="type">EClient</span>
94
Begins asynchronous opening of a new <a href="../libedataserver/EClient.html"><span class="type">EClient</span></a> corresponding
95
to the <em class="parameter"><code>source</code></em> of type <em class="parameter"><code>source_type</code></em>. The resulting <a href="../libedataserver/EClient.html"><span class="type">EClient</span></a>
96
96
is fully opened and authenticated client, ready to be used.
97
97
The opened client has also fetched capabilities.
98
98
This call is finished by <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new-finish" title="e_client_utils_open_new_finish ()"><code class="function">e_client_utils_open_new_finish()</code></a>
105
105
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
106
<td>an <span class="type">ESource</span> to be opened</td>
106
<td>an <a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> to be opened</td>
109
109
<td><p><span class="term"><em class="parameter"><code>source_type</code></em> :</span></p></td>
136
136
<div class="refsect2">
137
137
<a name="e-client-utils-open-new-finish"></a><h3>e_client_utils_open_new_finish ()</h3>
138
<pre class="programlisting"><span class="returnvalue">gboolean</span> e_client_utils_open_new_finish (<em class="parameter"><code><span class="type">ESource</span> *source</code></em>,
138
<pre class="programlisting"><span class="returnvalue">gboolean</span> e_client_utils_open_new_finish (<em class="parameter"><code><a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>,
139
139
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
140
<em class="parameter"><code><span class="type">EClient</span> **client</code></em>,
140
<em class="parameter"><code><a href="../libedataserver/EClient.html"><span class="type">EClient</span></a> **client</code></em>,
141
141
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
143
143
Finishes previous call of <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new" title="e_client_utils_open_new ()"><code class="function">e_client_utils_open_new()</code></a> and
144
sets <em class="parameter"><code>client</code></em> to a fully opened and authenticated <span class="type">EClient</span>.
144
sets <em class="parameter"><code>client</code></em> to a fully opened and authenticated <a href="../libedataserver/EClient.html"><span class="type">EClient</span></a>.
145
145
This <em class="parameter"><code>client</code></em>, if not NULL, should be freed with <code class="function">g_object_unref()</code>.
147
147
<div class="variablelist"><table border="0">
151
151
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
152
<td>an <span class="type">ESource</span> on which the <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new" title="e_client_utils_open_new ()"><code class="function">e_client_utils_open_new()</code></a> was invoked</td>
152
<td>an <a href="../libedataserver/ESource.html"><span class="type">ESource</span></a> on which the <a class="link" href="libedataserverui-EClient-Utilities.html#e-client-utils-open-new" title="e_client_utils_open_new ()"><code class="function">e_client_utils_open_new()</code></a> was invoked</td>
155
155
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
160
160
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
161
<td>Return value for an <span class="type">EClient</span>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
161
<td>Return value for an <a href="../libedataserver/EClient.html"><span class="type">EClient</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>