30
33
<h2><span class="refentrytitle"><a name="telepathy-glib-connection-caps.top_of_page"></a>Connection ContactCapabilities and Capabilities interfaces</span></h2>
31
34
<p>Connection ContactCapabilities and Capabilities interfaces — client-side wrappers for the capabilities interfaces</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-caps.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
<span class="returnvalue">void</span>
47
<td class="function_name">
48
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</a><span class="c_punctuation">)</span> <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-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</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-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
71
<td class="function_name">
72
<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</a> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<span class="returnvalue">void</span>
79
<td class="function_name">
80
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
87
<td class="function_name">
88
<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</a> <span class="c_punctuation">()</span>
92
<td class="function_type">
93
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
95
<td class="function_name">
96
<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities" title="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()">tp_cli_connection_interface_capabilities_call_advertise_capabilities</a> <span class="c_punctuation">()</span>
100
<td class="function_type">
101
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
103
<td class="function_name">
104
<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-get-capabilities" title="tp_cli_connection_interface_capabilities_call_get_capabilities ()">tp_cli_connection_interface_capabilities_call_get_capabilities</a> <span class="c_punctuation">()</span>
108
<td class="function_type">
109
<span class="returnvalue">void</span>
111
<td class="function_name">
112
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()">*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
116
<td class="function_type">
117
<span class="returnvalue">void</span>
119
<td class="function_name">
120
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()">*tp_cli_connection_interface_capabilities_callback_for_get_capabilities</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
124
<td class="function_type">
125
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
127
<td class="function_name">
128
<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" title="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed</a> <span class="c_punctuation">()</span>
132
<td class="function_type">
133
<span class="returnvalue">void</span>
135
<td class="function_name">
136
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" title="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()">*tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
142
<div class="refsect1">
143
<a name="telepathy-glib-connection-caps.object-hierarchy"></a><h2>Object Hierarchy</h2>
147
<div class="refsect1">
148
<a name="telepathy-glib-connection-caps.includes"></a><h2>Includes</h2>
149
<pre class="synopsis">#include <telepathy-glib/telepathy-glib-dbus.h>
38
<div class="refsynopsisdiv">
39
<a name="telepathy-glib-connection-caps.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
41
#include <telepathy-glib/telepathy-glib-dbus.h>
43
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</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-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Contact_Capabilities</code></em>,
46
<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>,
47
<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>,
48
<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>);
49
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities</a>
50
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
51
<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>,
52
<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_Handles</code></em>,
53
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</span></a> callback</code></em>,
54
<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>,
55
<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>,
56
<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>);
57
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()">*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</a>)
58
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
59
<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>,
60
<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>,
61
<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>);
62
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-call-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()">tp_cli_connection_interface_contact_capabilities_call_update_capabilities</a>
63
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
64
<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>,
65
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Handler_Capabilities</code></em>,
66
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</span></a> callback</code></em>,
67
<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>,
68
<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>,
69
<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>);
70
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()">*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</a>)
71
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
72
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_caps</code></em>,
73
<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>,
74
<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>);
75
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed</a>
76
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
77
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()"><span class="type">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</span></a> callback</code></em>,
78
<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>,
79
<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>,
80
<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>,
81
<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>);
84
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-advertise-capabilities" title="tp_cli_connection_interface_capabilities_call_advertise_capabilities ()">tp_cli_connection_interface_capabilities_call_advertise_capabilities</a>
85
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
86
<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>,
87
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Add</code></em>,
88
<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> **in_Remove</code></em>,
89
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</span></a> callback</code></em>,
90
<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>,
91
<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>,
92
<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>);
93
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-call-get-capabilities" title="tp_cli_connection_interface_capabilities_call_get_capabilities ()">tp_cli_connection_interface_capabilities_call_get_capabilities</a>
94
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
95
<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>,
96
<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_Handles</code></em>,
97
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</span></a> callback</code></em>,
98
<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>,
99
<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>,
100
<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>);
101
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()">*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</a>)
102
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
103
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Self_Capabilities</code></em>,
104
<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>,
105
<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>,
106
<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>);
107
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()">*tp_cli_connection_interface_capabilities_callback_for_get_capabilities</a>)
108
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
109
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Contact_Capabilities</code></em>,
110
<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>,
111
<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>,
112
<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>);
113
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" title="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed</a>
114
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
115
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" title="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()"><span class="type">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</span></a> callback</code></em>,
116
<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>,
117
<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>,
118
<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>,
119
<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>);
120
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" title="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()">*tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</a>)
121
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
122
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *arg_Caps</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/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
152
127
<div class="refsect1">
153
128
<a name="telepathy-glib-connection-caps.description"></a><h2>Description</h2>
154
<p>Some instant messaging protocols allow discovery of the capabilities of
130
Some instant messaging protocols allow discovery of the capabilities of
155
131
a user's client. In Telepathy, this is represented by the
156
132
ContactCapabilities interface, which lets applications advertise extra
157
133
capabilities for the local user, and query the interfaces supported by
159
<p>The Capabilities interface is an older API with similar functionality.</p>
160
<p>This section documents the auto-generated C wrappers for the
137
The Capabilities interface is an older API with similar functionality.
140
This section documents the auto-generated C wrappers for the
161
141
ContactCapabilities and Capabilities interfaces, used with
162
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
164
<div class="refsect1">
165
<a name="telepathy-glib-connection-caps.functions_details"></a><h2>Functions</h2>
166
<div class="refsect2">
167
<a name="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()</h3>
168
<pre class="programlisting"><span class="returnvalue">void</span>
169
<span class="c_punctuation">(</span>*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities<span class="c_punctuation">)</span>
170
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
171
<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_Contact_Capabilities</code></em>,
172
<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>,
173
<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>,
174
<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>
175
<div class="warning"><p><code class="literal">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</code> is deprecated and should not be used in newly-written code.</p></div>
176
<p>Signature of the callback called when a GetContactCapabilities method call
177
succeeds or fails.</p>
178
<div class="refsect3">
179
<a name="id-1.4.14.7.2.6"></a><h4>Parameters</h4>
180
<div class="informaltable"><table width="100%" border="0">
182
<col width="150px" class="parameters_name">
183
<col class="parameters_description">
184
<col width="200px" class="parameters_annotations">
188
<td class="parameter_name"><p>proxy</p></td>
189
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
190
<td class="parameter_annotations"> </td>
193
<td class="parameter_name"><p>out_Contact_Capabilities</p></td>
194
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
195
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A map from contact handles to lists of requestable channel classes, representing the channel requests that are expected to succeed for that contact.</p> <p>Contacts listed among Handles whose capabilities are unknown SHOULD be omitted from this map; contacts known to have an empty set of capabilities SHOULD be included in the keys of this map, with an empty array as the corresponding value.</p></p></td>
196
<td class="parameter_annotations"> </td>
199
<td class="parameter_name"><p>error</p></td>
200
<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>
201
<td class="parameter_annotations"> </td>
204
<td class="parameter_name"><p>user_data</p></td>
205
<td class="parameter_description"><p>user-supplied data</p></td>
206
<td class="parameter_annotations"> </td>
209
<td class="parameter_name"><p>weak_object</p></td>
210
<td class="parameter_description"><p>user-supplied object</p></td>
211
<td class="parameter_annotations"> </td>
218
<div class="refsect2">
219
<a name="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()</h3>
220
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
221
tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
222
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
223
<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>,
224
<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_Handles</code></em>,
225
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</span></a> callback</code></em>,
226
<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>,
227
<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>,
228
<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>
229
<p>Start a GetContactCapabilities method call.</p>
230
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Returns an array of requestable channel classes for the given contact handles, representing the channel requests that are expected to succeed.</p></p>
231
<div class="refsect3">
232
<a name="id-1.4.14.7.3.6"></a><h4>Parameters</h4>
233
<div class="informaltable"><table width="100%" border="0">
235
<col width="150px" class="parameters_name">
236
<col class="parameters_description">
237
<col width="200px" class="parameters_annotations">
241
<td class="parameter_name"><p>proxy</p></td>
242
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
243
<td class="parameter_annotations"> </td>
246
<td class="parameter_name"><p>timeout_ms</p></td>
247
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
249
<td class="parameter_annotations"> </td>
252
<td class="parameter_name"><p>in_Handles</p></td>
253
<td class="parameter_description"><p>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>The handle zero MUST NOT be included in the request.</p></p></td>
254
<td class="parameter_annotations"> </td>
257
<td class="parameter_name"><p>callback</p></td>
258
<td class="parameter_description"><p>called when the method call succeeds or fails;
259
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
260
reply tracking</p></td>
261
<td class="parameter_annotations"> </td>
264
<td class="parameter_name"><p>user_data</p></td>
265
<td class="parameter_description"><p>user-supplied data passed to the callback;
266
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>
267
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
268
<td class="parameter_annotations"> </td>
271
<td class="parameter_name"><p>destroy</p></td>
272
<td class="parameter_description"><p>called with the user_data as argument, after the
273
call has succeeded, failed or been cancelled;
274
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>
275
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
276
<td class="parameter_annotations"> </td>
279
<td class="parameter_name"><p>weak_object</p></td>
280
<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
281
weakly referenced; if it is destroyed, this call
282
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
283
<em class="parameter"><code>callback</code></em>
284
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
285
<td class="parameter_annotations"> </td>
290
<div class="refsect3">
291
<a name="id-1.4.14.7.3.7"></a><h4>Returns</h4>
292
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
293
progress. It is borrowed from the object, and will become
294
invalid when the callback is called, the call is
295
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
300
<div class="refsect2">
301
<a name="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()</h3>
302
<pre class="programlisting"><span class="returnvalue">void</span>
303
<span class="c_punctuation">(</span>*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities<span class="c_punctuation">)</span>
304
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
305
<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>,
306
<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>,
307
<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>
308
<p>Signature of the callback called when a UpdateCapabilities method call
309
succeeds or fails.</p>
310
<div class="refsect3">
311
<a name="id-1.4.14.7.4.5"></a><h4>Parameters</h4>
312
<div class="informaltable"><table width="100%" border="0">
314
<col width="150px" class="parameters_name">
315
<col class="parameters_description">
316
<col width="200px" class="parameters_annotations">
320
<td class="parameter_name"><p>proxy</p></td>
321
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
322
<td class="parameter_annotations"> </td>
325
<td class="parameter_name"><p>error</p></td>
326
<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>
327
<td class="parameter_annotations"> </td>
330
<td class="parameter_name"><p>user_data</p></td>
331
<td class="parameter_description"><p>user-supplied data</p></td>
332
<td class="parameter_annotations"> </td>
335
<td class="parameter_name"><p>weak_object</p></td>
336
<td class="parameter_description"><p>user-supplied object</p></td>
337
<td class="parameter_annotations"> </td>
344
<div class="refsect2">
345
<a name="tp-cli-connection-interface-contact-capabilities-call-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()</h3>
346
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
347
tp_cli_connection_interface_contact_capabilities_call_update_capabilities
348
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
349
<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>,
350
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Handler_Capabilities</code></em>,
351
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</span></a> callback</code></em>,
352
<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>,
353
<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>,
354
<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>
355
<p>Start a UpdateCapabilities method call.</p>
356
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Alter the connection's advertised capabilities to include the intersection of the given clients' capabilities with what the connection manager is able to implement.</p> <p>On connections managed by the ChannelDispatcher, processes other than the ChannelDispatcher SHOULD NOT call this method, and the ChannelDispatcher SHOULD use this method to advertise the capabilities of all the registered <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref> implementations.On connections not managed by the ChannelDispatcher, clients MAY use this method directly, to indicate the channels they will handle and the extra capabilities they have.</p> <p>Upon a successful invocation of this method, the connection manager will only emit the <tp:member-ref>ContactCapabilitiesChanged</tp:member-ref> signal for the user's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">SelfHandle</tp:dbus-ref> if, in the underlying protocol, the new capabilities are distinct from the previous state.</p> <tp:rationale> <p>The connection manager will essentially intersect the provided capabilities and the channel classes it implements. Therefore, certain properties which are never fixed for a channel class (such as the target handle, or the Parameters property of a tube channel) will almost certainly not be advertised.</p> </tp:rationale> <p>This method MAY be called on a newly-created connection while it is still in the DISCONNECTED state, to request that when the connection connects, it will do so with the appropriate capabilities. Doing so MUST NOT fail.</p></p>
357
<div class="refsect3">
358
<a name="id-1.4.14.7.5.6"></a><h4>Parameters</h4>
359
<div class="informaltable"><table width="100%" border="0">
361
<col width="150px" class="parameters_name">
362
<col class="parameters_description">
363
<col width="200px" class="parameters_annotations">
367
<td class="parameter_name"><p>proxy</p></td>
368
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
369
<td class="parameter_annotations"> </td>
372
<td class="parameter_name"><p>timeout_ms</p></td>
373
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
375
<td class="parameter_annotations"> </td>
378
<td class="parameter_name"><p>in_Handler_Capabilities</p></td>
379
<td class="parameter_description"><p>Used to pass an 'in' argument: <p>The capabilities of one or more clients.</p> <p>For each client in the given list, any capabilities previously advertised for the same client name are discarded, then replaced by the capabilities indicated.</p> <p>As a result, if a client becomes unavailable, this method SHOULD be called with a <tp:type>Handler_Capabilities</tp:type> structure containing its name, an empty list of channel classes, and an empty list of capabilities. When this is done, the connection manager SHOULD free all memory associated with that client name.</p> <tp:rationale> <p>This method takes a list of clients so that when the channel dispatcher first calls it (with a list of all the Handlers that are initially available), the changes can be made atomically, with only one transmission of updated capabilities to the network. Afterwards, the channel dispatcher will call this method with a single-element list every time a Handler becomes available or unavailable.</p> </tp:rationale> <p>The connection manager MUST ignore any channel classes and client capabilities for which there is no representation in the protocol or no support in the connection manager.</p></p></td>
380
<td class="parameter_annotations"> </td>
383
<td class="parameter_name"><p>callback</p></td>
384
<td class="parameter_description"><p>called when the method call succeeds or fails;
385
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
386
reply tracking</p></td>
387
<td class="parameter_annotations"> </td>
390
<td class="parameter_name"><p>user_data</p></td>
391
<td class="parameter_description"><p>user-supplied data passed to the callback;
392
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>
393
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
394
<td class="parameter_annotations"> </td>
397
<td class="parameter_name"><p>destroy</p></td>
398
<td class="parameter_description"><p>called with the user_data as argument, after the
399
call has succeeded, failed or been cancelled;
400
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>
401
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
402
<td class="parameter_annotations"> </td>
405
<td class="parameter_name"><p>weak_object</p></td>
406
<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
407
weakly referenced; if it is destroyed, this call
408
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
409
<em class="parameter"><code>callback</code></em>
410
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
411
<td class="parameter_annotations"> </td>
416
<div class="refsect3">
417
<a name="id-1.4.14.7.5.7"></a><h4>Returns</h4>
418
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
419
progress. It is borrowed from the object, and will become
420
invalid when the callback is called, the call is
421
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
426
<div class="refsect2">
427
<a name="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()</h3>
428
<pre class="programlisting"><span class="returnvalue">void</span>
429
<span class="c_punctuation">(</span>*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed<span class="c_punctuation">)</span>
430
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
431
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_caps</code></em>,
432
<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>,
433
<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>
434
<div class="warning"><p><code class="literal">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</code> is deprecated and should not be used in newly-written code.</p></div>
435
<p>Represents the signature of a callback for the signal ContactCapabilitiesChanged.</p>
436
<div class="refsect3">
437
<a name="id-1.4.14.7.6.6"></a><h4>Parameters</h4>
438
<div class="informaltable"><table width="100%" border="0">
440
<col width="150px" class="parameters_name">
441
<col class="parameters_description">
442
<col width="200px" class="parameters_annotations">
446
<td class="parameter_name"><p>proxy</p></td>
447
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()"><code class="function">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed()</code></a>
449
<td class="parameter_annotations"> </td>
452
<td class="parameter_name"><p>arg_caps</p></td>
453
<td class="parameter_description"><p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> All the capabilities of the contacts</p></td>
454
<td class="parameter_annotations"> </td>
457
<td class="parameter_name"><p>user_data</p></td>
458
<td class="parameter_description"><p>User-supplied data</p></td>
459
<td class="parameter_annotations"> </td>
462
<td class="parameter_name"><p>weak_object</p></td>
463
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
464
<td class="parameter_annotations"> </td>
471
<div class="refsect2">
472
<a name="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()</h3>
473
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
474
tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
475
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
476
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()"><span class="type">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</span></a> callback</code></em>,
477
<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>,
478
<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>,
479
<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>,
480
<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>
481
<p>Connect a handler to the signal ContactCapabilitiesChanged.</p>
482
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handles. A single signal can be emitted for several contacts.</p> <tp:rationale> <p>The underlying protocol can get several contacts' capabilities at the same time.</p> </tp:rationale></p>
483
<div class="refsect3">
484
<a name="id-1.4.14.7.7.6"></a><h4>Parameters</h4>
485
<div class="informaltable"><table width="100%" border="0">
487
<col width="150px" class="parameters_name">
488
<col class="parameters_description">
489
<col width="200px" class="parameters_annotations">
493
<td class="parameter_name"><p>proxy</p></td>
494
<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>
495
<td class="parameter_annotations"> </td>
498
<td class="parameter_name"><p>callback</p></td>
499
<td class="parameter_description"><p>Callback to be called when the signal is
501
<td class="parameter_annotations"> </td>
504
<td class="parameter_name"><p>user_data</p></td>
505
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
506
<td class="parameter_annotations"> </td>
509
<td class="parameter_name"><p>destroy</p></td>
510
<td class="parameter_description"><p>Destructor for the user-supplied data, which
511
will be called when this signal is disconnected, or
512
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>
513
<td class="parameter_annotations"> </td>
516
<td class="parameter_name"><p>weak_object</p></td>
517
<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;
518
if it is destroyed, this callback will automatically be
519
disconnected</p></td>
520
<td class="parameter_annotations"> </td>
523
<td class="parameter_name"><p>error</p></td>
524
<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
526
<td class="parameter_annotations"> </td>
531
<div class="refsect3">
532
<a name="id-1.4.14.7.7.7"></a><h4>Returns</h4>
533
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
534
above, which can be used to disconnect the signal; or
535
<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
536
or has become invalid.</p>
541
<div class="refsect2">
542
<a name="tp-cli-connection-interface-capabilities-call-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</h3>
543
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
544
tp_cli_connection_interface_capabilities_call_advertise_capabilities
545
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
546
<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>,
547
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Add</code></em>,
548
<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> **in_Remove</code></em>,
549
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</span></a> callback</code></em>,
550
<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>,
551
<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>,
552
<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>
553
<p>Start a AdvertiseCapabilities method call.</p>
554
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p></p>
555
<div class="refsect3">
556
<a name="id-1.4.14.7.8.6"></a><h4>Parameters</h4>
557
<div class="informaltable"><table width="100%" border="0">
559
<col width="150px" class="parameters_name">
560
<col class="parameters_description">
561
<col width="200px" class="parameters_annotations">
565
<td class="parameter_name"><p>proxy</p></td>
566
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
567
<td class="parameter_annotations"> </td>
570
<td class="parameter_name"><p>timeout_ms</p></td>
571
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
573
<td class="parameter_annotations"> </td>
576
<td class="parameter_name"><p>in_Add</p></td>
577
<td class="parameter_description"><p>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul></p></td>
578
<td class="parameter_annotations"> </td>
581
<td class="parameter_name"><p>in_Remove</p></td>
582
<td class="parameter_description"><p>Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove</p></td>
583
<td class="parameter_annotations"> </td>
586
<td class="parameter_name"><p>callback</p></td>
587
<td class="parameter_description"><p>called when the method call succeeds or fails;
588
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
589
reply tracking</p></td>
590
<td class="parameter_annotations"> </td>
593
<td class="parameter_name"><p>user_data</p></td>
594
<td class="parameter_description"><p>user-supplied data passed to the callback;
595
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>
596
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
597
<td class="parameter_annotations"> </td>
600
<td class="parameter_name"><p>destroy</p></td>
601
<td class="parameter_description"><p>called with the user_data as argument, after the
602
call has succeeded, failed or been cancelled;
603
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>
604
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
605
<td class="parameter_annotations"> </td>
608
<td class="parameter_name"><p>weak_object</p></td>
609
<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
610
weakly referenced; if it is destroyed, this call
611
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
612
<em class="parameter"><code>callback</code></em>
613
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
614
<td class="parameter_annotations"> </td>
619
<div class="refsect3">
620
<a name="id-1.4.14.7.8.7"></a><h4>Returns</h4>
621
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
622
progress. It is borrowed from the object, and will become
623
invalid when the callback is called, the call is
624
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
629
<div class="refsect2">
630
<a name="tp-cli-connection-interface-capabilities-call-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_get_capabilities ()</h3>
631
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
632
tp_cli_connection_interface_capabilities_call_get_capabilities
633
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
634
<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>,
635
<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_Handles</code></em>,
636
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</span></a> callback</code></em>,
637
<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>,
638
<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>,
639
<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>
640
<p>Start a GetCapabilities method call.</p>
641
<p>Returns an array of capabilities for the given contact handles.</p>
642
<div class="refsect3">
643
<a name="id-1.4.14.7.9.6"></a><h4>Parameters</h4>
644
<div class="informaltable"><table width="100%" border="0">
646
<col width="150px" class="parameters_name">
647
<col class="parameters_description">
648
<col width="200px" class="parameters_annotations">
652
<td class="parameter_name"><p>proxy</p></td>
653
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
654
<td class="parameter_annotations"> </td>
657
<td class="parameter_name"><p>timeout_ms</p></td>
658
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
660
<td class="parameter_annotations"> </td>
663
<td class="parameter_name"><p>in_Handles</p></td>
664
<td class="parameter_description"><p>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p></p></td>
665
<td class="parameter_annotations"> </td>
668
<td class="parameter_name"><p>callback</p></td>
669
<td class="parameter_description"><p>called when the method call succeeds or fails;
670
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
671
reply tracking</p></td>
672
<td class="parameter_annotations"> </td>
675
<td class="parameter_name"><p>user_data</p></td>
676
<td class="parameter_description"><p>user-supplied data passed to the callback;
677
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>
678
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
679
<td class="parameter_annotations"> </td>
682
<td class="parameter_name"><p>destroy</p></td>
683
<td class="parameter_description"><p>called with the user_data as argument, after the
684
call has succeeded, failed or been cancelled;
685
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>
686
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
687
<td class="parameter_annotations"> </td>
690
<td class="parameter_name"><p>weak_object</p></td>
691
<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
692
weakly referenced; if it is destroyed, this call
693
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
694
<em class="parameter"><code>callback</code></em>
695
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
696
<td class="parameter_annotations"> </td>
701
<div class="refsect3">
702
<a name="id-1.4.14.7.9.7"></a><h4>Returns</h4>
703
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
704
progress. It is borrowed from the object, and will become
705
invalid when the callback is called, the call is
706
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
711
<div class="refsect2">
712
<a name="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()</h3>
713
<pre class="programlisting"><span class="returnvalue">void</span>
714
<span class="c_punctuation">(</span>*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities<span class="c_punctuation">)</span>
715
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
716
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Self_Capabilities</code></em>,
717
<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>,
718
<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>,
719
<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>
720
<p>Signature of the callback called when a AdvertiseCapabilities method call
721
succeeds or fails.</p>
722
<div class="refsect3">
723
<a name="id-1.4.14.7.10.5"></a><h4>Parameters</h4>
724
<div class="informaltable"><table width="100%" border="0">
726
<col width="150px" class="parameters_name">
727
<col class="parameters_description">
728
<col width="200px" class="parameters_annotations">
732
<td class="parameter_name"><p>proxy</p></td>
733
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
734
<td class="parameter_annotations"> </td>
737
<td class="parameter_name"><p>out_Self_Capabilities</p></td>
738
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
739
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul></p></td>
740
<td class="parameter_annotations"> </td>
743
<td class="parameter_name"><p>error</p></td>
744
<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>
745
<td class="parameter_annotations"> </td>
748
<td class="parameter_name"><p>user_data</p></td>
749
<td class="parameter_description"><p>user-supplied data</p></td>
750
<td class="parameter_annotations"> </td>
753
<td class="parameter_name"><p>weak_object</p></td>
754
<td class="parameter_description"><p>user-supplied object</p></td>
755
<td class="parameter_annotations"> </td>
762
<div class="refsect2">
763
<a name="tp-cli-connection-interface-capabilities-callback-for-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()</h3>
764
<pre class="programlisting"><span class="returnvalue">void</span>
765
<span class="c_punctuation">(</span>*tp_cli_connection_interface_capabilities_callback_for_get_capabilities<span class="c_punctuation">)</span>
766
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
767
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Contact_Capabilities</code></em>,
768
<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>,
769
<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>,
770
<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>
771
<div class="warning"><p><code class="literal">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</code> is deprecated and should not be used in newly-written code.</p></div>
772
<p>Signature of the callback called when a GetCapabilities method call
773
succeeds or fails.</p>
774
<div class="refsect3">
775
<a name="id-1.4.14.7.11.6"></a><h4>Parameters</h4>
776
<div class="informaltable"><table width="100%" border="0">
778
<col width="150px" class="parameters_name">
779
<col class="parameters_description">
780
<col width="200px" class="parameters_annotations">
784
<td class="parameter_name"><p>proxy</p></td>
785
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
786
<td class="parameter_annotations"> </td>
789
<td class="parameter_name"><p>out_Contact_Capabilities</p></td>
790
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
791
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul></p></td>
792
<td class="parameter_annotations"> </td>
795
<td class="parameter_name"><p>error</p></td>
796
<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>
797
<td class="parameter_annotations"> </td>
800
<td class="parameter_name"><p>user_data</p></td>
801
<td class="parameter_description"><p>user-supplied data</p></td>
802
<td class="parameter_annotations"> </td>
805
<td class="parameter_name"><p>weak_object</p></td>
806
<td class="parameter_description"><p>user-supplied object</p></td>
807
<td class="parameter_annotations"> </td>
814
<div class="refsect2">
815
<a name="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed"></a><h3>tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()</h3>
816
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
817
tp_cli_connection_interface_capabilities_connect_to_capabilities_changed
818
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
819
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" title="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()"><span class="type">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</span></a> callback</code></em>,
820
<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>,
821
<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>,
822
<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>,
823
<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>
824
<p>Connect a handler to the signal CapabilitiesChanged.</p>
825
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handle.</p> <p>If the handle is zero, the capabilities refer to the connection itself, in some poorly defined way. This usage is deprecated and clients should ignore it.</p></p>
826
<div class="refsect3">
827
<a name="id-1.4.14.7.12.6"></a><h4>Parameters</h4>
828
<div class="informaltable"><table width="100%" border="0">
830
<col width="150px" class="parameters_name">
831
<col class="parameters_description">
832
<col width="200px" class="parameters_annotations">
836
<td class="parameter_name"><p>proxy</p></td>
837
<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>
838
<td class="parameter_annotations"> </td>
841
<td class="parameter_name"><p>callback</p></td>
842
<td class="parameter_description"><p>Callback to be called when the signal is
844
<td class="parameter_annotations"> </td>
847
<td class="parameter_name"><p>user_data</p></td>
848
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
849
<td class="parameter_annotations"> </td>
852
<td class="parameter_name"><p>destroy</p></td>
853
<td class="parameter_description"><p>Destructor for the user-supplied data, which
854
will be called when this signal is disconnected, or
855
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>
856
<td class="parameter_annotations"> </td>
859
<td class="parameter_name"><p>weak_object</p></td>
860
<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;
861
if it is destroyed, this callback will automatically be
862
disconnected</p></td>
863
<td class="parameter_annotations"> </td>
866
<td class="parameter_name"><p>error</p></td>
867
<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
869
<td class="parameter_annotations"> </td>
874
<div class="refsect3">
875
<a name="id-1.4.14.7.12.7"></a><h4>Returns</h4>
876
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
877
above, which can be used to disconnect the signal; or
878
<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
879
or has become invalid.</p>
884
<div class="refsect2">
885
<a name="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed"></a><h3>tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()</h3>
886
<pre class="programlisting"><span class="returnvalue">void</span>
887
<span class="c_punctuation">(</span>*tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed<span class="c_punctuation">)</span>
888
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
889
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *arg_Caps</code></em>,
890
<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>,
891
<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>
892
<p>Represents the signature of a callback for the signal CapabilitiesChanged.</p>
893
<div class="refsect3">
894
<a name="id-1.4.14.7.13.5"></a><h4>Parameters</h4>
895
<div class="informaltable"><table width="100%" border="0">
897
<col width="150px" class="parameters_name">
898
<col class="parameters_description">
899
<col width="200px" class="parameters_annotations">
903
<td class="parameter_name"><p>proxy</p></td>
904
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" title="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()"><code class="function">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed()</code></a>
906
<td class="parameter_annotations"> </td>
909
<td class="parameter_name"><p>arg_Caps</p></td>
910
<td class="parameter_description"><p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of the contact's old generic capability flags</li> <li>a bitwise OR of the contact's new generic capability flags</li> <li>a bitwise OR of the contact's old type specific capability flags</li> <li>a bitwise OR of the contact's new type specific capability flags</li> </ul></p></td>
911
<td class="parameter_annotations"> </td>
914
<td class="parameter_name"><p>user_data</p></td>
915
<td class="parameter_description"><p>User-supplied data</p></td>
916
<td class="parameter_annotations"> </td>
919
<td class="parameter_name"><p>weak_object</p></td>
920
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
921
<td class="parameter_annotations"> </td>
928
<div class="refsect1">
929
<a name="telepathy-glib-connection-caps.other_details"></a><h2>Types and Values</h2>
142
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.
145
<div class="refsect1">
146
<a name="telepathy-glib-connection-caps.details"></a><h2>Details</h2>
147
<div class="refsect2">
148
<a name="tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()</h3>
149
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities)
150
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
151
<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_Contact_Capabilities</code></em>,
152
<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>,
153
<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>,
154
<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>
156
Signature of the callback called when a GetContactCapabilities method call
159
<div class="variablelist"><table border="0" class="variablelist">
161
<col align="left" valign="top">
166
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
167
<td>the proxy on which the call was made</td>
170
<td><p><span class="term"><em class="parameter"><code>out_Contact_Capabilities</code></em> :</span></p></td>
171
<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>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A map from contact handles to lists of requestable channel classes, representing the channel requests that are expected to succeed for that contact.</p> <p>Contacts listed among Handles whose capabilities are unknown SHOULD be omitted from this map; contacts known to have an empty set of capabilities SHOULD be included in the keys of this map, with an empty array as the corresponding value.</p></td>
174
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
176
<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>
179
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
180
<td>user-supplied data</td>
183
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
184
<td>user-supplied object</td>
190
<div class="refsect2">
191
<a name="tp-cli-connection-interface-contact-capabilities-call-get-contact-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities ()</h3>
192
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_capabilities_call_get_contact_capabilities
193
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
194
<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>,
195
<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_Handles</code></em>,
196
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-get-contact-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_get_contact_capabilities</span></a> callback</code></em>,
197
<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>,
198
<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>,
199
<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>
201
Start a GetContactCapabilities method call.
204
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Returns an array of requestable channel classes for the given contact handles, representing the channel requests that are expected to succeed.</p>
206
<div class="variablelist"><table border="0" class="variablelist">
208
<col align="left" valign="top">
213
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
214
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
218
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
219
<td>the timeout in milliseconds, or -1 to use the
223
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
224
<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>The handle zero MUST NOT be included in the request.</p></td>
227
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
228
<td>called when the method call succeeds or fails;
229
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
233
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
234
<td>user-supplied data passed to the callback;
235
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>
239
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
240
<td>called with the user_data as argument, after the
241
call has succeeded, failed or been cancelled;
242
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>
246
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
247
<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
248
weakly referenced; if it is destroyed, this call
249
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
250
<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>
254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
255
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
256
progress. It is borrowed from the object, and will become
257
invalid when the callback is called, the call is
258
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
264
<div class="refsect2">
265
<a name="tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()</h3>
266
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities)
267
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
268
<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>,
269
<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>,
270
<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>
272
Signature of the callback called when a UpdateCapabilities method call
275
<div class="variablelist"><table border="0" class="variablelist">
277
<col align="left" valign="top">
282
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
283
<td>the proxy on which the call was made</td>
286
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
288
<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>
291
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
292
<td>user-supplied data</td>
295
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
296
<td>user-supplied object</td>
302
<div class="refsect2">
303
<a name="tp-cli-connection-interface-contact-capabilities-call-update-capabilities"></a><h3>tp_cli_connection_interface_contact_capabilities_call_update_capabilities ()</h3>
304
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_contact_capabilities_call_update_capabilities
305
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
306
<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>,
307
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Handler_Capabilities</code></em>,
308
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-callback-for-update-capabilities" title="tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities ()"><span class="type">tp_cli_connection_interface_contact_capabilities_callback_for_update_capabilities</span></a> callback</code></em>,
309
<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>,
310
<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>,
311
<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>
313
Start a UpdateCapabilities method call.
316
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Alter the connection's advertised capabilities to include the intersection of the given clients' capabilities with what the connection manager is able to implement.</p> <p>On connections managed by the ChannelDispatcher, processes other than the ChannelDispatcher SHOULD NOT call this method, and the ChannelDispatcher SHOULD use this method to advertise the capabilities of all the registered <tp:dbus-ref namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref> implementations.On connections not managed by the ChannelDispatcher, clients MAY use this method directly, to indicate the channels they will handle and the extra capabilities they have.</p> <p>Upon a successful invocation of this method, the connection manager will only emit the <tp:member-ref>ContactCapabilitiesChanged</tp:member-ref> signal for the user's <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">SelfHandle</tp:dbus-ref> if, in the underlying protocol, the new capabilities are distinct from the previous state.</p> <tp:rationale> <p>The connection manager will essentially intersect the provided capabilities and the channel classes it implements. Therefore, certain properties which are never fixed for a channel class (such as the target handle, or the Parameters property of a tube channel) will almost certainly not be advertised.</p> </tp:rationale> <p>This method MAY be called on a newly-created connection while it is still in the DISCONNECTED state, to request that when the connection connects, it will do so with the appropriate capabilities. Doing so MUST NOT fail.</p>
318
<div class="variablelist"><table border="0" class="variablelist">
320
<col align="left" valign="top">
325
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
326
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
330
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
331
<td>the timeout in milliseconds, or -1 to use the
335
<td><p><span class="term"><em class="parameter"><code>in_Handler_Capabilities</code></em> :</span></p></td>
336
<td>Used to pass an 'in' argument: <p>The capabilities of one or more clients.</p> <p>For each client in the given list, any capabilities previously advertised for the same client name are discarded, then replaced by the capabilities indicated.</p> <p>As a result, if a client becomes unavailable, this method SHOULD be called with a <tp:type>Handler_Capabilities</tp:type> structure containing its name, an empty list of channel classes, and an empty list of capabilities. When this is done, the connection manager SHOULD free all memory associated with that client name.</p> <tp:rationale> <p>This method takes a list of clients so that when the channel dispatcher first calls it (with a list of all the Handlers that are initially available), the changes can be made atomically, with only one transmission of updated capabilities to the network. Afterwards, the channel dispatcher will call this method with a single-element list every time a Handler becomes available or unavailable.</p> </tp:rationale> <p>The connection manager MUST ignore any channel classes and client capabilities for which there is no representation in the protocol or no support in the connection manager.</p></td>
339
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
340
<td>called when the method call succeeds or fails;
341
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
345
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
346
<td>user-supplied data passed to the callback;
347
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>
351
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
352
<td>called with the user_data as argument, after the
353
call has succeeded, failed or been cancelled;
354
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>
358
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
359
<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
360
weakly referenced; if it is destroyed, this call
361
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
362
<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>
366
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
367
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
368
progress. It is borrowed from the object, and will become
369
invalid when the callback is called, the call is
370
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
376
<div class="refsect2">
377
<a name="tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()</h3>
378
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed)
379
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
380
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_caps</code></em>,
381
<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>,
382
<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>
384
Represents the signature of a callback for the signal ContactCapabilitiesChanged.
386
<div class="variablelist"><table border="0" class="variablelist">
388
<col align="left" valign="top">
393
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
394
<td>The proxy on which <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()"><code class="function">tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed()</code></a>
398
<td><p><span class="term"><em class="parameter"><code>arg_caps</code></em> :</span></p></td>
399
<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> All the capabilities of the contacts</td>
402
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
403
<td>User-supplied data</td>
406
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
407
<td>User-supplied weakly referenced object</td>
413
<div class="refsect2">
414
<a name="tp-cli-connection-interface-contact-capabilities-connect-to-contact-capabilities-changed"></a><h3>tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed ()</h3>
415
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_contact_capabilities_connect_to_contact_capabilities_changed
416
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
417
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-contact-capabilities-signal-callback-contact-capabilities-changed" title="tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed ()"><span class="type">tp_cli_connection_interface_contact_capabilities_signal_callback_contact_capabilities_changed</span></a> callback</code></em>,
418
<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>,
419
<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>,
420
<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>,
421
<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>
423
Connect a handler to the signal ContactCapabilitiesChanged.
426
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handles. A single signal can be emitted for several contacts.</p> <tp:rationale> <p>The underlying protocol can get several contacts' capabilities at the same time.</p> </tp:rationale>
428
<div class="variablelist"><table border="0" class="variablelist">
430
<col align="left" valign="top">
435
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
436
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</td>
439
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
440
<td>Callback to be called when the signal is
444
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
445
<td>User-supplied data for the callback</td>
448
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
449
<td>Destructor for the user-supplied data, which
450
will be called when this signal is disconnected, or
451
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>
455
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
456
<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;
457
if it is destroyed, this callback will automatically be
461
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
462
<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
466
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
467
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
468
above, which can be used to disconnect the signal; or
469
<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
470
or has become invalid.</td>
476
<div class="refsect2">
477
<a name="tp-cli-connection-interface-capabilities-call-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_advertise_capabilities ()</h3>
478
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_capabilities_call_advertise_capabilities
479
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
480
<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>,
481
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *in_Add</code></em>,
482
<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> **in_Remove</code></em>,
483
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities</span></a> callback</code></em>,
484
<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>,
485
<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>,
486
<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>
488
Start a AdvertiseCapabilities method call.
491
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used by user interfaces to indicate which channel types they are able to handle on this connection. Because these may be provided by different client processes, this method accepts channel types to add and remove from the set already advertised on this connection. The type of advertised capabilities (create versus invite) is protocol-dependent and hence cannot be set by the this method. In the case of a client adding an already advertised channel type but with new channel type specific flags, the connection manager should simply add the new flags to the set of advertised capabilities.</p> <p>Upon a successful invocation of this method, the <tp:member-ref>CapabilitiesChanged</tp:member-ref> signal will be emitted for the user's own handle ( <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.GetSelfHandle</tp:dbus-ref>) by the connection manager to indicate the changes that have been made. This signal should also be monitored to ensure that the set is kept accurate - for example, a client may remove capabilities or type specific capability flags when it exits which are still provided by another client.</p> <p>On connections managed by the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>, this method SHOULD NOT be used by clients other than the ChannelDispatcher itself.</p>
493
<div class="variablelist"><table border="0" class="variablelist">
495
<col align="left" valign="top">
500
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
501
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
505
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
506
<td>the timeout in milliseconds, or -1 to use the
510
<td><p><span class="term"><em class="parameter"><code>in_Add</code></em> :</span></p></td>
511
<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul></td>
514
<td><p><span class="term"><em class="parameter"><code>in_Remove</code></em> :</span></p></td>
515
<td>Used to pass an 'in' argument: An array of D-Bus interface names of channel types to remove</td>
518
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
519
<td>called when the method call succeeds or fails;
520
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
524
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
525
<td>user-supplied data passed to the callback;
526
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>
530
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
531
<td>called with the user_data as argument, after the
532
call has succeeded, failed or been cancelled;
533
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>
537
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
538
<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
539
weakly referenced; if it is destroyed, this call
540
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
541
<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>
545
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
546
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
547
progress. It is borrowed from the object, and will become
548
invalid when the callback is called, the call is
549
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
555
<div class="refsect2">
556
<a name="tp-cli-connection-interface-capabilities-call-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_call_get_capabilities ()</h3>
557
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_capabilities_call_get_capabilities
558
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
559
<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>,
560
<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_Handles</code></em>,
561
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-callback-for-get-capabilities" title="tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()"><span class="type">tp_cli_connection_interface_capabilities_callback_for_get_capabilities</span></a> callback</code></em>,
562
<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>,
563
<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>,
564
<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>
566
Start a GetCapabilities method call.
569
Returns an array of capabilities for the given contact handles.
571
<div class="variablelist"><table border="0" class="variablelist">
573
<col align="left" valign="top">
578
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
579
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
583
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
584
<td>the timeout in milliseconds, or -1 to use the
588
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
589
<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>An array of contact handles for this connection.</p> <p>This may include zero, which originally meant a query for capabilities available on the connection itself. This usage is deprecated; clients SHOULD NOT do this, and connection managers SHOULD proceed as though zero had not been present in this list.</p></td>
592
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
593
<td>called when the method call succeeds or fails;
594
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
598
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
599
<td>user-supplied data passed to the callback;
600
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>
604
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
605
<td>called with the user_data as argument, after the
606
call has succeeded, failed or been cancelled;
607
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>
611
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
612
<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
613
weakly referenced; if it is destroyed, this call
614
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
615
<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>
619
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
620
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
621
progress. It is borrowed from the object, and will become
622
invalid when the callback is called, the call is
623
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
629
<div class="refsect2">
630
<a name="tp-cli-connection-interface-capabilities-callback-for-advertise-capabilities"></a><h3>tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities ()</h3>
631
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_capabilities_callback_for_advertise_capabilities)
632
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
633
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Self_Capabilities</code></em>,
634
<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>,
635
<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>,
636
<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>
638
Signature of the callback called when a AdvertiseCapabilities method call
641
<div class="variablelist"><table border="0" class="variablelist">
643
<col align="left" valign="top">
648
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
649
<td>the proxy on which the call was made</td>
652
<td><p><span class="term"><em class="parameter"><code>out_Self_Capabilities</code></em> :</span></p></td>
653
<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>: An array of structures describing the current capabilities containing: <ul> <li>a string channel type</li> <li>a bitwise OR of type specific capability flags</li> </ul></td>
656
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
658
<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>
661
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
662
<td>user-supplied data</td>
665
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
666
<td>user-supplied object</td>
672
<div class="refsect2">
673
<a name="tp-cli-connection-interface-capabilities-callback-for-get-capabilities"></a><h3>tp_cli_connection_interface_capabilities_callback_for_get_capabilities ()</h3>
674
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_capabilities_callback_for_get_capabilities)
675
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
676
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Contact_Capabilities</code></em>,
677
<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>,
678
<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>,
679
<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>
681
Signature of the callback called when a GetCapabilities method call
684
<div class="variablelist"><table border="0" class="variablelist">
686
<col align="left" valign="top">
691
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
692
<td>the proxy on which the call was made</td>
695
<td><p><span class="term"><em class="parameter"><code>out_Contact_Capabilities</code></em> :</span></p></td>
696
<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>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of generic capability flags for the type</li> <li>a bitwise OR of type specific capability flags for the type</li> </ul></td>
699
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
701
<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>
704
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
705
<td>user-supplied data</td>
708
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
709
<td>user-supplied object</td>
715
<div class="refsect2">
716
<a name="tp-cli-connection-interface-capabilities-connect-to-capabilities-changed"></a><h3>tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()</h3>
717
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_capabilities_connect_to_capabilities_changed
718
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
719
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed" title="tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()"><span class="type">tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed</span></a> callback</code></em>,
720
<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>,
721
<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>,
722
<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>,
723
<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>
725
Connect a handler to the signal CapabilitiesChanged.
728
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Announce that there has been a change of capabilities on the given handle.</p> <p>If the handle is zero, the capabilities refer to the connection itself, in some poorly defined way. This usage is deprecated and clients should ignore it.</p>
730
<div class="variablelist"><table border="0" class="variablelist">
732
<col align="left" valign="top">
737
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
738
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</td>
741
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
742
<td>Callback to be called when the signal is
746
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
747
<td>User-supplied data for the callback</td>
750
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
751
<td>Destructor for the user-supplied data, which
752
will be called when this signal is disconnected, or
753
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>
757
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
758
<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;
759
if it is destroyed, this callback will automatically be
763
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
764
<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
768
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
769
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
770
above, which can be used to disconnect the signal; or
771
<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
772
or has become invalid.</td>
778
<div class="refsect2">
779
<a name="tp-cli-connection-interface-capabilities-signal-callback-capabilities-changed"></a><h3>tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed ()</h3>
780
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_capabilities_signal_callback_capabilities_changed)
781
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
782
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *arg_Caps</code></em>,
783
<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>,
784
<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>
786
Represents the signature of a callback for the signal CapabilitiesChanged.
788
<div class="variablelist"><table border="0" class="variablelist">
790
<col align="left" valign="top">
795
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
796
<td>The proxy on which <a class="link" href="telepathy-glib-connection-caps.html#tp-cli-connection-interface-capabilities-connect-to-capabilities-changed" title="tp_cli_connection_interface_capabilities_connect_to_capabilities_changed ()"><code class="function">tp_cli_connection_interface_capabilities_connect_to_capabilities_changed()</code></a>
800
<td><p><span class="term"><em class="parameter"><code>arg_Caps</code></em> :</span></p></td>
801
<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> An array of structures containing: <ul> <li>an integer handle representing the contact</li> <li>a string channel type</li> <li>a bitwise OR of the contact's old generic capability flags</li> <li>a bitwise OR of the contact's new generic capability flags</li> <li>a bitwise OR of the contact's old type specific capability flags</li> <li>a bitwise OR of the contact's new type specific capability flags</li> </ul></td>
804
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
805
<td>User-supplied data</td>
808
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
809
<td>User-supplied weakly referenced object</td>
931
815
<div class="refsect1">
932
816
<a name="telepathy-glib-connection-caps.see-also"></a><h2>See Also</h2>
933
<p><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a></p>
817
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
936
820
<div class="footer">
938
Generated by GTK-Doc V1.20</div>
822
Generated by GTK-Doc V1.19</div>
b'\\ No newline at end of file'