8
8
<link rel="up" href="ch-service-base.html" title="Service-side implementation">
9
9
<link rel="prev" href="telepathy-glib-base-client.html" title="TpBaseClient">
10
10
<link rel="next" href="telepathy-glib-add-dispatch-operation-context.html" title="TpAddDispatchOperationContext">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.18 (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">
48
48
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-accept" title="tp_observe_channels_context_accept ()">tp_observe_channels_context_accept</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);
49
49
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-delay" title="tp_observe_channels_context_delay ()">tp_observe_channels_context_delay</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);
50
50
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-fail" title="tp_observe_channels_context_fail ()">tp_observe_channels_context_fail</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>,
51
<em class="parameter"><code>const <span class="type">GError</span> *error</code></em>);
52
<span class="returnvalue">gboolean</span> <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-is-recovering" title="tp_observe_channels_context_is_recovering ()">tp_observe_channels_context_is_recovering</a>
51
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);
52
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-is-recovering" title="tp_observe_channels_context_is_recovering ()">tp_observe_channels_context_is_recovering</a>
53
53
(<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);
54
<span class="returnvalue">GList</span> * <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-get-requests" title="tp_observe_channels_context_get_requests ()">tp_observe_channels_context_get_requests</a>
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-get-requests" title="tp_observe_channels_context_get_requests ()">tp_observe_channels_context_get_requests</a>
55
55
(<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);
58
58
<div class="refsect1">
59
59
<a name="telepathy-glib-observe-channels-context.object-hierarchy"></a><h2>Object Hierarchy</h2>
60
60
<pre class="synopsis">
61
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
62
62
+----TpObserveChannelsContext
66
66
<a name="telepathy-glib-observe-channels-context.properties"></a><h2>Properties</h2>
67
67
<pre class="synopsis">
68
68
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--account" title='The "account" property'>account</a>" <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>* : Read / Write / Construct Only
69
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--channels" title='The "channels" property'>channels</a>" <span class="type">GPtrArray</span>* : Read / Write / Construct Only
69
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--channels" title='The "channels" property'>channels</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>* : Read / Write / Construct Only
70
70
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--connection" title='The "connection" property'>connection</a>" <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>* : Read / Write / Construct Only
71
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--dbus-context" title='The "dbus-context" property'>dbus-context</a>" <span class="type">gpointer</span> : Write / Construct Only
71
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--dbus-context" title='The "dbus-context" property'>dbus-context</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Write / Construct Only
72
72
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--dispatch-operation" title='The "dispatch-operation" property'>dispatch-operation</a>" <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a>* : Read / Write / Construct Only
73
73
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--observer-info" title='The "observer-info" property'>observer-info</a>" <span class="type">GHashTable_gchararray+GValue_*</span> : Read / Write / Construct Only
74
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--requests" title='The "requests" property'>requests</a>" <span class="type">GPtrArray</span>* : Read / Write / Construct Only
74
"<a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext--requests" title='The "requests" property'>requests</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>* : Read / Write / Construct Only
77
77
<div class="refsect1">
135
135
<div class="refsect2">
136
136
<a name="tp-observe-channels-context-fail"></a><h3>tp_observe_channels_context_fail ()</h3>
137
137
<pre class="programlisting"><span class="returnvalue">void</span> tp_observe_channels_context_fail (<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>,
138
<em class="parameter"><code>const <span class="type">GError</span> *error</code></em>);</pre>
138
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre>
140
140
Called by <a class="link" href="telepathy-glib-base-client.html#TpBaseClientClassObserveChannelsImpl" title="TpBaseClientClassObserveChannelsImpl ()"><span class="type">TpBaseClientClassObserveChannelsImpl</span></a> to raise a D-Bus error.
159
159
<div class="refsect2">
160
160
<a name="tp-observe-channels-context-is-recovering"></a><h3>tp_observe_channels_context_is_recovering ()</h3>
161
<pre class="programlisting"><span class="returnvalue">gboolean</span> tp_observe_channels_context_is_recovering
161
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_observe_channels_context_is_recovering
162
162
(<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);</pre>
164
164
If this call to ObserveChannels is for channels that already
165
165
existed before this observer started (because the observer used
166
<a class="link" href="telepathy-glib-base-client.html#tp-base-client-set-observer-recover" title="tp_base_client_set_observer_recover ()"><code class="function">tp_base_client_set_observer_recover()</code></a>), return <code class="literal">TRUE</code>.
166
<a class="link" href="telepathy-glib-base-client.html#tp-base-client-set-observer-recover" title="tp_base_client_set_observer_recover ()"><code class="function">tp_base_client_set_observer_recover()</code></a>), return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
169
In most cases, the result is <code class="literal">FALSE</code>.
169
In most cases, the result is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
171
171
<div class="variablelist"><table border="0">
172
172
<col align="left" valign="top">
180
180
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
182
<code class="literal">TRUE</code> for pre-existing channels, <code class="literal">FALSE</code> for new channels</td>
182
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for pre-existing channels, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for new channels</td>
189
189
<div class="refsect2">
190
190
<a name="tp-observe-channels-context-get-requests"></a><h3>tp_observe_channels_context_get_requests ()</h3>
191
<pre class="programlisting"><span class="returnvalue">GList</span> * tp_observe_channels_context_get_requests
191
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * tp_observe_channels_context_get_requests
192
192
(<em class="parameter"><code><a class="link" href="telepathy-glib-observe-channels-context.html#TpObserveChannelsContext"><span class="type">TpObserveChannelsContext</span></a> *self</code></em>);</pre>
194
194
Return a list of the <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> which have been satisfied by the
206
206
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
207
<td>a newly allocated <span class="type">GList</span> of reffed <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> TelepathyGLib.ChannelRequest]</span>
207
<td>a newly allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of reffed <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> TelepathyGLib.ChannelRequest]</span>
223
223
Read-only except during construction.
226
This property can't be <code class="literal">NULL</code>.
226
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
228
228
<p class="since">Since 0.11.5</p>
231
231
<div class="refsect2">
232
232
<a name="TpObserveChannelsContext--channels"></a><h3>The <code class="literal">"channels"</code> property</h3>
233
<pre class="programlisting"> "channels" <span class="type">GPtrArray</span>* : Read / Write / Construct Only</pre>
233
<pre class="programlisting"> "channels" <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>* : Read / Write / Construct Only</pre>
235
A <span class="type">GPtrArray</span> containing <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> objects representing the channels
235
A <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> containing <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> objects representing the channels
236
236
that have been passed to ObserveChannels.
237
237
Read-only except during construction.
240
This property can't be <code class="literal">NULL</code>.
240
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
242
242
<p class="since">Since 0.11.5</p>
251
251
Read-only except during construction.
254
This property can't be <code class="literal">NULL</code>.
254
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
256
256
<p class="since">Since 0.11.5</p>
259
259
<div class="refsect2">
260
260
<a name="TpObserveChannelsContext--dbus-context"></a><h3>The <code class="literal">"dbus-context"</code> property</h3>
261
<pre class="programlisting"> "dbus-context" <span class="type">gpointer</span> : Write / Construct Only</pre>
261
<pre class="programlisting"> "dbus-context" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Write / Construct Only</pre>
263
The <span class="type">DBusGMethodInvocation</span> representing the D-Bus context of the
263
The <a href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"><span class="type">DBusGMethodInvocation</span></a> representing the D-Bus context of the
264
264
ObserveChannels call.
265
265
Can only be written during construction.
274
274
A <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> object representing the
275
275
ChannelDispatchOperation that has been passed to ObserveChannels,
276
or <code class="literal">NULL</code> if none has been passed.
276
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none has been passed.
277
277
Read-only except during construction.
279
279
<p class="since">Since 0.11.5</p>
283
283
<a name="TpObserveChannelsContext--observer-info"></a><h3>The <code class="literal">"observer-info"</code> property</h3>
284
284
<pre class="programlisting"> "observer-info" <span class="type">GHashTable_gchararray+GValue_*</span> : Read / Write / Construct Only</pre>
286
A <span class="type">GHashTable</span> where the keys are string and values are GValue instances.
286
A <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> where the keys are string and values are GValue instances.
287
287
It represents the Observer_Info hash table that has been passed to
289
289
It's recommended to use high-level method such as
290
290
<a class="link" href="telepathy-glib-observe-channels-context.html#tp-observe-channels-context-is-recovering" title="tp_observe_channels_context_is_recovering ()"><code class="function">tp_observe_channels_context_is_recovering()</code></a> to access to its content.
293
This property can't be <code class="literal">NULL</code>.
293
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
295
295
<p class="since">Since 0.11.5</p>
298
298
<div class="refsect2">
299
299
<a name="TpObserveChannelsContext--requests"></a><h3>The <code class="literal">"requests"</code> property</h3>
300
<pre class="programlisting"> "requests" <span class="type">GPtrArray</span>* : Read / Write / Construct Only</pre>
300
<pre class="programlisting"> "requests" <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>* : Read / Write / Construct Only</pre>
302
A <span class="type">GPtrArray</span> containing <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> objects representing the
302
A <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> containing <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> objects representing the
303
303
requests that have been passed to ObserveChannels.
304
304
Read-only except during construction.
307
This property can't be <code class="literal">NULL</code>.
307
This property can't be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
309
309
<p class="since">Since 0.11.5</p>