30
33
<h2><span class="refentrytitle"><a name="telepathy-glib-connection-client-types.top_of_page"></a>Connection ClientTypes interface</span></h2>
31
34
<p>Connection ClientTypes interface — client-side wrappers for the ClientTypes interface</p>
33
<td class="gallery_image" valign="top" align="right"></td>
36
<td valign="top" align="right"></td>
34
37
</tr></table></div>
35
<div class="refsect1">
36
<a name="telepathy-glib-connection-client-types.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
44
<td class="function_type">
45
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
47
<td class="function_name">
48
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-get-client-types" title="tp_cli_connection_interface_client_types_call_get_client_types ()">tp_cli_connection_interface_client_types_call_get_client_types</a> <span class="c_punctuation">()</span>
52
<td class="function_type">
53
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
55
<td class="function_name">
56
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-request-client-types" title="tp_cli_connection_interface_client_types_call_request_client_types ()">tp_cli_connection_interface_client_types_call_request_client_types</a> <span class="c_punctuation">()</span>
60
<td class="function_type">
61
<span class="returnvalue">void</span>
63
<td class="function_name">
64
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()">*tp_cli_connection_interface_client_types_callback_for_get_client_types</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<span class="returnvalue">void</span>
71
<td class="function_name">
72
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()">*tp_cli_connection_interface_client_types_callback_for_request_client_types</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
79
<td class="function_name">
80
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()">tp_cli_connection_interface_client_types_connect_to_client_types_updated</a> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<span class="returnvalue">void</span>
87
<td class="function_name">
88
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()">*tp_cli_connection_interface_client_types_signal_callback_client_types_updated</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
94
<div class="refsect1">
95
<a name="telepathy-glib-connection-client-types.object-hierarchy"></a><h2>Object Hierarchy</h2>
99
<div class="refsect1">
100
<a name="telepathy-glib-connection-client-types.includes"></a><h2>Includes</h2>
101
<pre class="synopsis">#include <telepathy-glib/telepathy-glib-dbus.h>
38
<div class="refsynopsisdiv">
39
<a name="telepathy-glib-connection-client-types.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
41
#include <telepathy-glib/telepathy-glib-dbus.h>
43
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-get-client-types" title="tp_cli_connection_interface_client_types_call_get_client_types ()">tp_cli_connection_interface_client_types_call_get_client_types</a>
44
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
45
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
46
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
47
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
48
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
49
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
50
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
51
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-request-client-types" title="tp_cli_connection_interface_client_types_call_request_client_types ()">tp_cli_connection_interface_client_types_call_request_client_types</a>
52
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
53
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
55
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
57
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
59
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()">*tp_cli_connection_interface_client_types_callback_for_get_client_types</a>)
60
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Client_Types</code></em>,
62
<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>,
63
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
64
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
65
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()">*tp_cli_connection_interface_client_types_callback_for_request_client_types</a>)
66
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
67
<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> **out_Client_Types</code></em>,
68
<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>,
69
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
70
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
71
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()">tp_cli_connection_interface_client_types_connect_to_client_types_updated</a>
72
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
73
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
74
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
77
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
78
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()">*tp_cli_connection_interface_client_types_signal_callback_client_types_updated</a>)
79
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
80
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
81
<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> **arg_Client_Types</code></em>,
82
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
83
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
104
86
<div class="refsect1">
105
87
<a name="telepathy-glib-connection-client-types.description"></a><h2>Description</h2>
106
<p>On some protocols it's possible to determine the type of client another
89
On some protocols it's possible to determine the type of client another
107
90
user is using, ranging from a simple "phone or not?" indicator to a
108
91
classification into several types of user interface. Telepathy represents
109
these using the client types defined by XMPP.</p>
110
<p>This section documents the auto-generated C wrappers for the
111
ClientTypes interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
92
these using the client types defined by XMPP.
95
This section documents the auto-generated C wrappers for the
96
ClientTypes interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.
113
99
<div class="refsect1">
114
<a name="telepathy-glib-connection-client-types.functions_details"></a><h2>Functions</h2>
115
<div class="refsect2">
116
<a name="tp-cli-connection-interface-client-types-call-get-client-types"></a><h3>tp_cli_connection_interface_client_types_call_get_client_types ()</h3>
117
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
118
tp_cli_connection_interface_client_types_call_get_client_types
119
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
120
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
121
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
122
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
123
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
124
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
125
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
126
<p>Start a GetClientTypes method call.</p>
127
<p>Return the client types of the given contacts, if they are already known. If any of the given contacts' client types are not known, request their current client types, but return immediately without waiting for a reply; if a reply with a non-empty client type array is later received for those contacts, the <tp:member-ref>ClientTypesUpdated</tp:member-ref> signal will be emitted for them. <tp:rationale> This method is appropriate for &quot;lazy&quot; client type finding, for instance displaying the client types (if available) of everyone in your contact list. </tp:rationale></p>
128
<div class="refsect3">
129
<a name="id-1.4.10.7.2.6"></a><h4>Parameters</h4>
130
<div class="informaltable"><table width="100%" border="0">
132
<col width="150px" class="parameters_name">
133
<col class="parameters_description">
134
<col width="200px" class="parameters_annotations">
138
<td class="parameter_name"><p>proxy</p></td>
139
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
140
<td class="parameter_annotations"> </td>
143
<td class="parameter_name"><p>timeout_ms</p></td>
144
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
146
<td class="parameter_annotations"> </td>
149
<td class="parameter_name"><p>in_Contacts</p></td>
150
<td class="parameter_description"><p>Used to pass an 'in' argument: The contacts whose client types should be returned or signalled.</p></td>
151
<td class="parameter_annotations"> </td>
154
<td class="parameter_name"><p>callback</p></td>
155
<td class="parameter_description"><p>called when the method call succeeds or fails;
156
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
157
reply tracking</p></td>
158
<td class="parameter_annotations"> </td>
161
<td class="parameter_name"><p>user_data</p></td>
162
<td class="parameter_description"><p>user-supplied data passed to the callback;
163
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
164
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
165
<td class="parameter_annotations"> </td>
168
<td class="parameter_name"><p>destroy</p></td>
169
<td class="parameter_description"><p>called with the user_data as argument, after the
170
call has succeeded, failed or been cancelled;
171
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
172
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
173
<td class="parameter_annotations"> </td>
176
<td class="parameter_name"><p>weak_object</p></td>
177
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
178
weakly referenced; if it is destroyed, this call
179
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
180
<em class="parameter"><code>callback</code></em>
181
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
182
<td class="parameter_annotations"> </td>
187
<div class="refsect3">
188
<a name="id-1.4.10.7.2.7"></a><h4>Returns</h4>
189
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
190
progress. It is borrowed from the object, and will become
191
invalid when the callback is called, the call is
192
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
197
<div class="refsect2">
198
<a name="tp-cli-connection-interface-client-types-call-request-client-types"></a><h3>tp_cli_connection_interface_client_types_call_request_client_types ()</h3>
199
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
200
tp_cli_connection_interface_client_types_call_request_client_types
201
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
202
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
203
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
204
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</code></em>,
205
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
206
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
207
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
208
<p>Start a RequestClientTypes method call.</p>
209
<p>Return the current client types of the given contact. If necessary, make a request to the server for up-to-date information, and wait for a reply. <tp:rationale> This method is appropriate for use in a &quot;Contact Information...&quot; dialog; it can be used to show progress information (while waiting for the method to return), and can distinguish between various error conditions. </tp:rationale></p>
210
<div class="refsect3">
211
<a name="id-1.4.10.7.3.6"></a><h4>Parameters</h4>
212
<div class="informaltable"><table width="100%" border="0">
214
<col width="150px" class="parameters_name">
215
<col class="parameters_description">
216
<col width="200px" class="parameters_annotations">
220
<td class="parameter_name"><p>proxy</p></td>
221
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
222
<td class="parameter_annotations"> </td>
225
<td class="parameter_name"><p>timeout_ms</p></td>
226
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
228
<td class="parameter_annotations"> </td>
231
<td class="parameter_name"><p>in_Contact</p></td>
232
<td class="parameter_description"><p>Used to pass an 'in' argument: The contact whose client types should be returned. (<span class="type">TpContactHandle</span>)</p></td>
233
<td class="parameter_annotations"> </td>
236
<td class="parameter_name"><p>callback</p></td>
237
<td class="parameter_description"><p>called when the method call succeeds or fails;
238
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
239
reply tracking</p></td>
240
<td class="parameter_annotations"> </td>
243
<td class="parameter_name"><p>user_data</p></td>
244
<td class="parameter_description"><p>user-supplied data passed to the callback;
245
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
246
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
247
<td class="parameter_annotations"> </td>
250
<td class="parameter_name"><p>destroy</p></td>
251
<td class="parameter_description"><p>called with the user_data as argument, after the
252
call has succeeded, failed or been cancelled;
253
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
254
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
255
<td class="parameter_annotations"> </td>
258
<td class="parameter_name"><p>weak_object</p></td>
259
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
260
weakly referenced; if it is destroyed, this call
261
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
262
<em class="parameter"><code>callback</code></em>
263
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
264
<td class="parameter_annotations"> </td>
269
<div class="refsect3">
270
<a name="id-1.4.10.7.3.7"></a><h4>Returns</h4>
271
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
272
progress. It is borrowed from the object, and will become
273
invalid when the callback is called, the call is
274
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
279
<div class="refsect2">
280
<a name="tp-cli-connection-interface-client-types-callback-for-get-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_get_client_types ()</h3>
281
<pre class="programlisting"><span class="returnvalue">void</span>
282
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_callback_for_get_client_types<span class="c_punctuation">)</span>
283
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
284
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Client_Types</code></em>,
285
<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>,
286
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
287
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
288
<p>Signature of the callback called when a GetClientTypes method call
289
succeeds or fails.</p>
290
<div class="refsect3">
291
<a name="id-1.4.10.7.4.5"></a><h4>Parameters</h4>
292
<div class="informaltable"><table width="100%" border="0">
294
<col width="150px" class="parameters_name">
295
<col class="parameters_description">
296
<col width="200px" class="parameters_annotations">
300
<td class="parameter_name"><p>proxy</p></td>
301
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
302
<td class="parameter_annotations"> </td>
305
<td class="parameter_name"><p>out_Client_Types</p></td>
306
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
307
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contacts' client types, if already known. Contacts whose client types are not already known are omitted from the mapping; contacts known to have no client type information appear in the mapping with an empty list.</p></td>
308
<td class="parameter_annotations"> </td>
311
<td class="parameter_name"><p>error</p></td>
312
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
313
<td class="parameter_annotations"> </td>
316
<td class="parameter_name"><p>user_data</p></td>
317
<td class="parameter_description"><p>user-supplied data</p></td>
318
<td class="parameter_annotations"> </td>
321
<td class="parameter_name"><p>weak_object</p></td>
322
<td class="parameter_description"><p>user-supplied object</p></td>
323
<td class="parameter_annotations"> </td>
330
<div class="refsect2">
331
<a name="tp-cli-connection-interface-client-types-callback-for-request-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_request_client_types ()</h3>
332
<pre class="programlisting"><span class="returnvalue">void</span>
333
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_callback_for_request_client_types<span class="c_punctuation">)</span>
334
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
335
<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> **out_Client_Types</code></em>,
336
<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>,
337
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
338
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
339
<div class="warning"><p><code class="literal">tp_cli_connection_interface_client_types_callback_for_request_client_types</code> is deprecated and should not be used in newly-written code.</p></div>
340
<p>Signature of the callback called when a RequestClientTypes method call
341
succeeds or fails.</p>
342
<div class="refsect3">
343
<a name="id-1.4.10.7.5.6"></a><h4>Parameters</h4>
344
<div class="informaltable"><table width="100%" border="0">
346
<col width="150px" class="parameters_name">
347
<col class="parameters_description">
348
<col width="200px" class="parameters_annotations">
352
<td class="parameter_name"><p>proxy</p></td>
353
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
354
<td class="parameter_annotations"> </td>
357
<td class="parameter_name"><p>out_Client_Types</p></td>
358
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
359
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contact's client types. It MAY be empty, indicating that no client type information was found.</p></td>
360
<td class="parameter_annotations"> </td>
363
<td class="parameter_name"><p>error</p></td>
364
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
365
<td class="parameter_annotations"> </td>
368
<td class="parameter_name"><p>user_data</p></td>
369
<td class="parameter_description"><p>user-supplied data</p></td>
370
<td class="parameter_annotations"> </td>
373
<td class="parameter_name"><p>weak_object</p></td>
374
<td class="parameter_description"><p>user-supplied object</p></td>
375
<td class="parameter_annotations"> </td>
382
<div class="refsect2">
383
<a name="tp-cli-connection-interface-client-types-connect-to-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_connect_to_client_types_updated ()</h3>
384
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
385
tp_cli_connection_interface_client_types_connect_to_client_types_updated
386
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
387
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
388
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
389
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
390
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
391
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
392
<p>Connect a handler to the signal ClientTypesUpdated.</p>
393
<p>Emitted when a contact's client types change or become known.</p>
394
<div class="refsect3">
395
<a name="id-1.4.10.7.6.6"></a><h4>Parameters</h4>
396
<div class="informaltable"><table width="100%" border="0">
398
<col width="150px" class="parameters_name">
399
<col class="parameters_description">
400
<col width="200px" class="parameters_annotations">
404
<td class="parameter_name"><p>proxy</p></td>
405
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</p></td>
406
<td class="parameter_annotations"> </td>
409
<td class="parameter_name"><p>callback</p></td>
410
<td class="parameter_description"><p>Callback to be called when the signal is
412
<td class="parameter_annotations"> </td>
415
<td class="parameter_name"><p>user_data</p></td>
416
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
417
<td class="parameter_annotations"> </td>
420
<td class="parameter_name"><p>destroy</p></td>
421
<td class="parameter_description"><p>Destructor for the user-supplied data, which
100
<a name="telepathy-glib-connection-client-types.details"></a><h2>Details</h2>
101
<div class="refsect2">
102
<a name="tp-cli-connection-interface-client-types-call-get-client-types"></a><h3>tp_cli_connection_interface_client_types_call_get_client_types ()</h3>
103
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_client_types_call_get_client_types
104
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
105
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
106
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
107
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
108
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
109
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
110
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
112
Start a GetClientTypes method call.
115
Return the client types of the given contacts, if they are already known. If any of the given contacts' client types are not known, request their current client types, but return immediately without waiting for a reply; if a reply with a non-empty client type array is later received for those contacts, the <tp:member-ref>ClientTypesUpdated</tp:member-ref> signal will be emitted for them. <tp:rationale> This method is appropriate for &quot;lazy&quot; client type finding, for instance displaying the client types (if available) of everyone in your contact list. </tp:rationale>
117
<div class="variablelist"><table border="0" class="variablelist">
119
<col align="left" valign="top">
124
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
125
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
129
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
130
<td>the timeout in milliseconds, or -1 to use the
134
<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
135
<td>Used to pass an 'in' argument: The contacts whose client types should be returned or signalled.</td>
138
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
139
<td>called when the method call succeeds or fails;
140
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
144
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
145
<td>user-supplied data passed to the callback;
146
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
150
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
151
<td>called with the user_data as argument, after the
152
call has succeeded, failed or been cancelled;
153
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
157
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
158
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
159
weakly referenced; if it is destroyed, this call
160
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
161
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
165
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
166
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
167
progress. It is borrowed from the object, and will become
168
invalid when the callback is called, the call is
169
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
175
<div class="refsect2">
176
<a name="tp-cli-connection-interface-client-types-call-request-client-types"></a><h3>tp_cli_connection_interface_client_types_call_request_client_types ()</h3>
177
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_client_types_call_request_client_types
178
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
179
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
180
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
181
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</code></em>,
182
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
183
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
184
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
186
Start a RequestClientTypes method call.
189
Return the current client types of the given contact. If necessary, make a request to the server for up-to-date information, and wait for a reply. <tp:rationale> This method is appropriate for use in a &quot;Contact Information...&quot; dialog; it can be used to show progress information (while waiting for the method to return), and can distinguish between various error conditions. </tp:rationale>
191
<div class="variablelist"><table border="0" class="variablelist">
193
<col align="left" valign="top">
198
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
199
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
203
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
204
<td>the timeout in milliseconds, or -1 to use the
208
<td><p><span class="term"><em class="parameter"><code>in_Contact</code></em> :</span></p></td>
209
<td>Used to pass an 'in' argument: The contact whose client types should be returned. (<span class="type">TpContactHandle</span>)</td>
212
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
213
<td>called when the method call succeeds or fails;
214
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
218
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
219
<td>user-supplied data passed to the callback;
220
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
224
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
225
<td>called with the user_data as argument, after the
226
call has succeeded, failed or been cancelled;
227
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
231
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
232
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
233
weakly referenced; if it is destroyed, this call
234
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
235
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
239
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
241
progress. It is borrowed from the object, and will become
242
invalid when the callback is called, the call is
243
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
249
<div class="refsect2">
250
<a name="tp-cli-connection-interface-client-types-callback-for-get-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_get_client_types ()</h3>
251
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_client_types_callback_for_get_client_types)
252
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
253
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Client_Types</code></em>,
254
<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>,
255
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
256
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
258
Signature of the callback called when a GetClientTypes method call
261
<div class="variablelist"><table border="0" class="variablelist">
263
<col align="left" valign="top">
268
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
269
<td>the proxy on which the call was made</td>
272
<td><p><span class="term"><em class="parameter"><code>out_Client_Types</code></em> :</span></p></td>
273
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contacts' client types, if already known. Contacts whose client types are not already known are omitted from the mapping; contacts known to have no client type information appear in the mapping with an empty list.</td>
276
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
278
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
281
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
282
<td>user-supplied data</td>
285
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
286
<td>user-supplied object</td>
292
<div class="refsect2">
293
<a name="tp-cli-connection-interface-client-types-callback-for-request-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_request_client_types ()</h3>
294
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_client_types_callback_for_request_client_types)
295
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
296
<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> **out_Client_Types</code></em>,
297
<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>,
298
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
299
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
301
Signature of the callback called when a RequestClientTypes method call
304
<div class="variablelist"><table border="0" class="variablelist">
306
<col align="left" valign="top">
311
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
312
<td>the proxy on which the call was made</td>
315
<td><p><span class="term"><em class="parameter"><code>out_Client_Types</code></em> :</span></p></td>
316
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contact's client types. It MAY be empty, indicating that no client type information was found.</td>
319
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
321
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
324
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
325
<td>user-supplied data</td>
328
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
329
<td>user-supplied object</td>
335
<div class="refsect2">
336
<a name="tp-cli-connection-interface-client-types-connect-to-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_connect_to_client_types_updated ()</h3>
337
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_client_types_connect_to_client_types_updated
338
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
339
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
340
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
341
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
342
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
343
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
345
Connect a handler to the signal ClientTypesUpdated.
348
Emitted when a contact's client types change or become known.
350
<div class="variablelist"><table border="0" class="variablelist">
352
<col align="left" valign="top">
357
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
358
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</td>
361
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
362
<td>Callback to be called when the signal is
366
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
367
<td>User-supplied data for the callback</td>
370
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
371
<td>Destructor for the user-supplied data, which
422
372
will be called when this signal is disconnected, or
423
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
424
<td class="parameter_annotations"> </td>
373
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
427
<td class="parameter_name"><p>weak_object</p></td>
428
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
377
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
378
<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
429
379
if it is destroyed, this callback will automatically be
430
disconnected</p></td>
431
<td class="parameter_annotations"> </td>
434
<td class="parameter_name"><p>error</p></td>
435
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
437
<td class="parameter_annotations"> </td>
442
<div class="refsect3">
443
<a name="id-1.4.10.7.6.7"></a><h4>Returns</h4>
444
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
383
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
384
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
388
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
389
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
445
390
above, which can be used to disconnect the signal; or
446
391
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
447
or has become invalid.</p>
392
or has become invalid.</td>
452
398
<div class="refsect2">
453
<a name="tp-cli-connection-interface-client-types-signal-callback-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()</h3>
454
<pre class="programlisting"><span class="returnvalue">void</span>
455
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_signal_callback_client_types_updated<span class="c_punctuation">)</span>
456
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
457
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
458
<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> **arg_Client_Types</code></em>,
459
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
460
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
461
<p>Represents the signature of a callback for the signal ClientTypesUpdated.</p>
462
<div class="refsect3">
463
<a name="id-1.4.10.7.7.5"></a><h4>Parameters</h4>
464
<div class="informaltable"><table width="100%" border="0">
399
<a name="tp-cli-connection-interface-client-types-signal-callback-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()</h3>
400
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_client_types_signal_callback_client_types_updated)
401
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
402
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
403
<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> **arg_Client_Types</code></em>,
404
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
405
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
407
Represents the signature of a callback for the signal ClientTypesUpdated.
409
<div class="variablelist"><table border="0" class="variablelist">
466
<col width="150px" class="parameters_name">
467
<col class="parameters_description">
468
<col width="200px" class="parameters_annotations">
411
<col align="left" valign="top">
472
<td class="parameter_name"><p>proxy</p></td>
473
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()"><code class="function">tp_cli_connection_interface_client_types_connect_to_client_types_updated()</code></a>
475
<td class="parameter_annotations"> </td>
478
<td class="parameter_name"><p>arg_Contact</p></td>
479
<td class="parameter_description"><p>The contact. (<span class="type">TpContactHandle</span>)</p></td>
480
<td class="parameter_annotations"> </td>
483
<td class="parameter_name"><p>arg_Client_Types</p></td>
484
<td class="parameter_description"><p>The contact's client types, or an empty list to indicate that nothing is known about the contact's client types.</p></td>
485
<td class="parameter_annotations"> </td>
488
<td class="parameter_name"><p>user_data</p></td>
489
<td class="parameter_description"><p>User-supplied data</p></td>
490
<td class="parameter_annotations"> </td>
493
<td class="parameter_name"><p>weak_object</p></td>
494
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
495
<td class="parameter_annotations"> </td>
416
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
417
<td>The proxy on which <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()"><code class="function">tp_cli_connection_interface_client_types_connect_to_client_types_updated()</code></a>
421
<td><p><span class="term"><em class="parameter"><code>arg_Contact</code></em> :</span></p></td>
422
<td>The contact. (<span class="type">TpContactHandle</span>)</td>
425
<td><p><span class="term"><em class="parameter"><code>arg_Client_Types</code></em> :</span></p></td>
426
<td>The contact's client types, or an empty list to indicate that nothing is known about the contact's client types.</td>
429
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
430
<td>User-supplied data</td>
433
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
434
<td>User-supplied weakly referenced object</td>
502
<div class="refsect1">
503
<a name="telepathy-glib-connection-client-types.other_details"></a><h2>Types and Values</h2>
506
441
<div class="footer">
508
Generated by GTK-Doc V1.20</div>
443
Generated by GTK-Doc V1.19</div>
b'\\ No newline at end of file'