~ubuntu-branches/ubuntu/wily/telepathy-glib/wily
» Revision
18
: docs/reference/html/telepathy-glib-connection.html
« back to all changes in this revision
Viewing changes to docs/reference/html/telepathy-glib-connection.html
- browse files at revision 18
- compare with another revision
- download diff
- download tarball
- view history from revision 18
- Committer: Bazaar Package Importer
- Author(s): Simon McVittie
- Date: 2009-03-24 22:06:52 UTC
- mfrom: (1.3.1 upstream) (17.1.10 sid)
- Revision ID: james.westby@ubuntu.com-20090324220652-c8dvom0nsqomp23d
Tags: 0.7.28-1
* New upstream version (ABI, API added)
* Put the -dbg package in section debug, as per recent archive changes
* Remove obsolete Conflicts/Replaces with libtelepathy-glib-static-dev, which
was never in a stable release (and probably never in Debian at all)
* Put the -dbg package in section debug, as per recent archive changes
* Remove obsolete Conflicts/Replaces with libtelepathy-glib-static-dev, which
was never in a stable release (and probably never in Debian at all)
- files added:
- debian/gbp.conf
- examples/cm/callable
- examples/cm/contactlist
- examples/cm/echo-message-parts
- tests/dbus/dbus-1
- tests/dbus/dbus-1/services
- tests/dbus/telepathy
- tests/dbus/telepathy/managers
- telepathy-glib/_gen
- tests/dbus/_gen
- files modified:
- AUTHORS
- autogen.sh *
- tests/tools/test-gobject-foo.sh *
added
removed
docs/reference/html/telepathy-glib-connection.html
7
7
<link rel="start" href="index.html" title="telepathy-glib Reference Manual">
8
8
<link rel="up" href="ch-client.html" title="Client-side proxies">
9
9
<link rel="prev" href="telepathy-glib-connection-manager.html" title="TpConnectionManager">
10
<link rel="next" href="telepathy-glib-connection-aliasing.html" title="Connection Aliasing interface">
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
10
<link rel="next" href="telepathy-glib-contact.html" title="TpContact">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
14
14
<link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
25
25
<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
26
26
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
27
27
<th width="100%" align="center">telepathy-glib Reference Manual</th>
28
<td><a accesskey="n" href="telepathy-glib-connection-aliasing.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28
<td><a accesskey="n" href="telepathy-glib-contact.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
29
29
</tr>
30
<tr><td colspan="5" class="shortcuts"><nobr><a href="#telepathy-glib-connection.synopsis" class="shortcut">Top</a>
31
|
32
<a href="#telepathy-glib-connection.description" class="shortcut">Description</a>
33
|
34
<a href="#telepathy-glib-connection.object-hierarchy" class="shortcut">Object Hierarchy</a>
35
|
36
<a href="#telepathy-glib-connection.properties" class="shortcut">Properties</a></nobr></td></tr>
30
<tr><td colspan="5" class="shortcuts">
31
<a href="#telepathy-glib-connection.synopsis" class="shortcut">Top</a>
32
|
33
<a href="#telepathy-glib-connection.description" class="shortcut">Description</a>
34
|
35
<a href="#telepathy-glib-connection.object-hierarchy" class="shortcut">Object Hierarchy</a>
36
|
37
<a href="#telepathy-glib-connection.properties" class="shortcut">Properties</a>
38
</td></tr>
37
39
</table>
38
40
<div class="refentry" lang="en">
39
41
<a name="telepathy-glib-connection"></a><div class="titlepage"></div>
51
53
#include <telepathy-glib/connection.h>
52
54
53
55
void (<a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()">*TpConnectionNameListCb</a>) (const <a
54
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
56
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
55
57
>gchar</a> * const *names,
56
58
<a
57
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
59
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
58
60
>gsize</a> n,
59
61
const <a
60
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
62
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
61
63
>gchar</a> * const *cms,
62
64
const <a
63
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
65
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
64
66
>gchar</a> * const *protocols,
65
67
const <a
66
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
68
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
67
69
>GError</a> *error,
68
70
<a
69
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
71
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
70
72
>gpointer</a> user_data,
71
73
<a
72
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
74
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
73
75
>GObject</a> *weak_object);
74
76
void <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()">tp_list_connection_names</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
75
77
<a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()">TpConnectionNameListCb</a> callback,
76
78
<a
77
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
79
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
78
80
>gpointer</a> user_data,
79
81
<a
80
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
82
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
81
83
>GDestroyNotify</a> destroy,
82
84
<a
83
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
85
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
84
86
>GObject</a> *weak_object);
85
<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a>* <a class="link" href="telepathy-glib-connection.html#tp-connection-new" title="tp_connection_new ()">tp_connection_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *dbus,
87
<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> * <a class="link" href="telepathy-glib-connection.html#tp-connection-new" title="tp_connection_new ()">tp_connection_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *dbus,
86
88
const <a
87
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
89
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
88
90
>gchar</a> *bus_name,
89
91
const <a
90
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
92
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
91
93
>gchar</a> *object_path,
92
94
<a
93
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
95
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
94
96
>GError</a> **error);
95
97
<a
96
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
98
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
97
99
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-run-until-ready" title="tp_connection_run_until_ready ()">tp_connection_run_until_ready</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
98
100
<a
99
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
101
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
100
102
>gboolean</a> connect,
101
103
<a
102
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
104
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
103
105
>GError</a> **error,
104
106
<a
105
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
107
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
106
108
>GMainLoop</a> **loop);
107
109
void (<a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()">*TpConnectionWhenReadyCb</a>) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
108
110
const <a
109
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
111
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
110
112
>GError</a> *error,
111
113
<a
112
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
114
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
113
115
>gpointer</a> user_data);
114
116
void <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()">tp_connection_call_when_ready</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
115
117
<a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()">TpConnectionWhenReadyCb</a> callback,
116
118
<a
117
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
119
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
118
120
>gpointer</a> user_data);
121
<a
122
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
123
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-is-ready" title="tp_connection_is_ready ()">tp_connection_is_ready</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self);
124
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus">TpConnectionStatus</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-get-status" title="tp_connection_get_status ()">tp_connection_get_status</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
125
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason">TpConnectionStatusReason</a> *reason);
126
<a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-get-self-handle" title="tp_connection_get_self_handle ()">tp_connection_get_self_handle</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self);
127
void (<a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()">*TpConnectionRequestHandlesCb</a>) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
128
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
129
<a
130
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
131
>guint</a> n_handles,
132
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
133
const <a
134
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
135
>gchar</a> * const *ids,
136
const <a
137
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
138
>GError</a> *error,
139
<a
140
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
141
>gpointer</a> user_data,
142
<a
143
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
144
>GObject</a> *weak_object);
145
void <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()">tp_connection_request_handles</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
146
<a
147
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
148
>gint</a> timeout_ms,
149
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
150
const <a
151
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
152
>gchar</a> * const *ids,
153
<a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()">TpConnectionRequestHandlesCb</a> callback,
154
<a
155
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
156
>gpointer</a> user_data,
157
<a
158
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
159
>GDestroyNotify</a> destroy,
160
<a
161
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
162
>GObject</a> *weak_object);
163
void (<a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()">*TpConnectionHoldHandlesCb</a>) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
164
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
165
<a
166
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
167
>guint</a> n_handles,
168
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
169
const <a
170
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
171
>GError</a> *error,
172
<a
173
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
174
>gpointer</a> user_data,
175
<a
176
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
177
>GObject</a> *weak_object);
178
void <a class="link" href="telepathy-glib-connection.html#tp-connection-get-contact-attributes" title="tp_connection_get_contact_attributes ()">tp_connection_get_contact_attributes</a>
179
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
180
<a
181
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
182
>gint</a> timeout_ms,
183
<a
184
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
185
>guint</a> n_handles,
186
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
187
const <a
188
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
189
>gchar</a> * const *interfaces,
190
<a
191
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
192
>gboolean</a> hold,
193
<a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</a> callback,
194
<a
195
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
196
>gpointer</a> user_data,
197
<a
198
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
199
>GDestroyNotify</a> destroy,
200
<a
201
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
202
>GObject</a> *weak_object);
203
void <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()">tp_connection_hold_handles</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
204
<a
205
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
206
>gint</a> timeout_ms,
207
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
208
<a
209
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
210
>guint</a> n_handles,
211
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
212
<a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()">TpConnectionHoldHandlesCb</a> callback,
213
<a
214
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
215
>gpointer</a> user_data,
216
<a
217
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
218
>GDestroyNotify</a> destroy,
219
<a
220
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
221
>GObject</a> *weak_object);
222
void <a class="link" href="telepathy-glib-connection.html#tp-connection-unref-handles" title="tp_connection_unref_handles ()">tp_connection_unref_handles</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
223
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
224
<a
225
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
226
>guint</a> n_handles,
227
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles);
119
228
void <a class="link" href="telepathy-glib-connection.html#tp-connection-init-known-interfaces" title="tp_connection_init_known_interfaces ()">tp_connection_init_known_interfaces</a> (void);
229
<a
230
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
231
>gint</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-presence-type-cmp-availability" title="tp_connection_presence_type_cmp_availability ()">tp_connection_presence_type_cmp_availability</a>
232
(<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> p1,
233
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> p2);
234
<a
235
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
236
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-connection-parse-object-path" title="tp_connection_parse_object_path ()">tp_connection_parse_object_path</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
237
<a
238
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
239
>gchar</a> **protocol,
240
<a
241
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
242
>gchar</a> **cm_name);
120
243
<a class="link" href="telepathy-glib-connection.html#TpConnection-struct" title="TpConnection">TpConnection</a>;
121
244
<a class="link" href="telepathy-glib-connection.html#TpConnectionClass" title="TpConnectionClass">TpConnectionClass</a>;
122
#define <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS:CAPS" title="TP_UNKNOWN_CONNECTION_STATUS">TP_UNKNOWN_CONNECTION_STATUS</a>
123
#define <a class="link" href="telepathy-glib-connection.html#TP-ERRORS-DISCONNECTED:CAPS" title="TP_ERRORS_DISCONNECTED">TP_ERRORS_DISCONNECTED</a>
245
#define <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS--CAPS" title="TP_UNKNOWN_CONNECTION_STATUS">TP_UNKNOWN_CONNECTION_STATUS</a>
246
#define <a class="link" href="telepathy-glib-connection.html#TP-ERRORS-DISCONNECTED--CAPS" title="TP_ERRORS_DISCONNECTED">TP_ERRORS_DISCONNECTED</a>
124
247
125
248
126
249
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()">*tp_cli_connection_callback_for_connect</a>)
127
250
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
128
251
const <a
129
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
252
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
130
253
>GError</a> *error,
131
254
<a
132
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
255
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
133
256
>gpointer</a> user_data,
134
257
<a
135
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
258
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
136
259
>GObject</a> *weak_object);
137
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()">tp_cli_connection_call_connect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
260
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()">tp_cli_connection_call_connect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
138
261
<a
139
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
262
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
140
263
>gint</a> timeout_ms,
141
264
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()">tp_cli_connection_callback_for_connect</a> callback,
142
265
<a
143
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
266
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
144
267
>gpointer</a> user_data,
145
268
<a
146
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
269
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
147
270
>GDestroyNotify</a> destroy,
148
271
<a
149
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
272
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
150
273
>GObject</a> *weak_object);
151
274
<a
152
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
275
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
153
276
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-connect" title="tp_cli_connection_run_connect ()">tp_cli_connection_run_connect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
154
277
<a
155
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
278
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
156
279
>gint</a> timeout_ms,
157
280
<a
158
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
281
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
159
282
>GError</a> **error,
160
283
<a
161
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
284
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
162
285
>GMainLoop</a> **loop);
163
286
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()">*tp_cli_connection_callback_for_disconnect</a>)
164
287
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
165
288
const <a
166
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
289
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
167
290
>GError</a> *error,
168
291
<a
169
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
292
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
170
293
>gpointer</a> user_data,
171
294
<a
172
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
295
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
173
296
>GObject</a> *weak_object);
174
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-disconnect" title="tp_cli_connection_call_disconnect ()">tp_cli_connection_call_disconnect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
297
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-disconnect" title="tp_cli_connection_call_disconnect ()">tp_cli_connection_call_disconnect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
175
298
<a
176
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
299
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
177
300
>gint</a> timeout_ms,
178
301
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()">tp_cli_connection_callback_for_disconnect</a> callback,
179
302
<a
180
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
303
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
181
304
>gpointer</a> user_data,
182
305
<a
183
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
306
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
184
307
>GDestroyNotify</a> destroy,
185
308
<a
186
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
309
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
187
310
>GObject</a> *weak_object);
188
311
<a
189
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
312
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
190
313
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-disconnect" title="tp_cli_connection_run_disconnect ()">tp_cli_connection_run_disconnect</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
191
314
<a
192
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
315
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
193
316
>gint</a> timeout_ms,
194
317
<a
195
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
318
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
196
319
>GError</a> **error,
197
320
<a
198
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
321
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
199
322
>GMainLoop</a> **loop);
200
323
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()">*tp_cli_connection_callback_for_get_interfaces</a>)
201
324
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
202
325
const <a
203
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
204
>gchar</a> **out0,
326
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
327
>gchar</a> **out_Interfaces,
205
328
const <a
206
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
329
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
207
330
>GError</a> *error,
208
331
<a
209
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
332
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
210
333
>gpointer</a> user_data,
211
334
<a
212
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
335
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
213
336
>GObject</a> *weak_object);
214
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-interfaces" title="tp_cli_connection_call_get_interfaces ()">tp_cli_connection_call_get_interfaces</a>
337
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-interfaces" title="tp_cli_connection_call_get_interfaces ()">tp_cli_connection_call_get_interfaces</a>
215
338
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
216
339
<a
217
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
340
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
218
341
>gint</a> timeout_ms,
219
342
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()">tp_cli_connection_callback_for_get_interfaces</a> callback,
220
343
<a
221
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
344
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
222
345
>gpointer</a> user_data,
223
346
<a
224
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
347
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
225
348
>GDestroyNotify</a> destroy,
226
349
<a
227
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
350
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
228
351
>GObject</a> *weak_object);
229
352
<a
230
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
353
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
231
354
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-interfaces" title="tp_cli_connection_run_get_interfaces ()">tp_cli_connection_run_get_interfaces</a>
232
355
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
233
356
<a
234
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
357
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
235
358
>gint</a> timeout_ms,
236
359
<a
237
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
238
>gchar</a> ***out0,
360
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
361
>gchar</a> ***out_Interfaces,
239
362
<a
240
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
363
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
241
364
>GError</a> **error,
242
365
<a
243
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
366
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
244
367
>GMainLoop</a> **loop);
245
368
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()">*tp_cli_connection_callback_for_get_protocol</a>)
246
369
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
247
370
const <a
248
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
249
>gchar</a> *out0,
371
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
372
>gchar</a> *out_Protocol,
250
373
const <a
251
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
374
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
252
375
>GError</a> *error,
253
376
<a
254
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
377
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
255
378
>gpointer</a> user_data,
256
379
<a
257
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
380
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
258
381
>GObject</a> *weak_object);
259
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-protocol" title="tp_cli_connection_call_get_protocol ()">tp_cli_connection_call_get_protocol</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
382
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-protocol" title="tp_cli_connection_call_get_protocol ()">tp_cli_connection_call_get_protocol</a>
383
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
260
384
<a
261
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
385
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
262
386
>gint</a> timeout_ms,
263
387
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()">tp_cli_connection_callback_for_get_protocol</a> callback,
264
388
<a
265
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
389
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
266
390
>gpointer</a> user_data,
267
391
<a
268
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
392
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
269
393
>GDestroyNotify</a> destroy,
270
394
<a
271
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
395
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
272
396
>GObject</a> *weak_object);
273
397
<a
274
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
398
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
275
399
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-protocol" title="tp_cli_connection_run_get_protocol ()">tp_cli_connection_run_get_protocol</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
276
400
<a
277
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
401
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
278
402
>gint</a> timeout_ms,
279
403
<a
280
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
281
>gchar</a> **out0,
404
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
405
>gchar</a> **out_Protocol,
282
406
<a
283
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
407
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
284
408
>GError</a> **error,
285
409
<a
286
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
410
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
287
411
>GMainLoop</a> **loop);
288
412
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()">*tp_cli_connection_callback_for_get_self_handle</a>)
289
413
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
290
414
<a
291
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
292
>guint</a> out0,
415
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
416
>guint</a> out_Self_Handle,
293
417
const <a
294
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
418
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
295
419
>GError</a> *error,
296
420
<a
297
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
421
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
298
422
>gpointer</a> user_data,
299
423
<a
300
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
424
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
301
425
>GObject</a> *weak_object);
302
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-self-handle" title="tp_cli_connection_call_get_self_handle ()">tp_cli_connection_call_get_self_handle</a>
426
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-self-handle" title="tp_cli_connection_call_get_self_handle ()">tp_cli_connection_call_get_self_handle</a>
303
427
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
304
428
<a
305
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
429
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
306
430
>gint</a> timeout_ms,
307
431
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()">tp_cli_connection_callback_for_get_self_handle</a> callback,
308
432
<a
309
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
433
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
310
434
>gpointer</a> user_data,
311
435
<a
312
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
436
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
313
437
>GDestroyNotify</a> destroy,
314
438
<a
315
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
439
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
316
440
>GObject</a> *weak_object);
317
441
<a
318
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
442
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
319
443
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-self-handle" title="tp_cli_connection_run_get_self_handle ()">tp_cli_connection_run_get_self_handle</a>
320
444
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
321
445
<a
322
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
446
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
323
447
>gint</a> timeout_ms,
324
448
<a
325
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
326
>guint</a> *out0,
449
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
450
>guint</a> *out_Self_Handle,
327
451
<a
328
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
452
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
329
453
>GError</a> **error,
330
454
<a
331
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
455
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
332
456
>GMainLoop</a> **loop);
333
457
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()">*tp_cli_connection_callback_for_get_status</a>)
334
458
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
335
459
<a
336
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
337
>guint</a> out0,
460
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
461
>guint</a> out_Status,
338
462
const <a
339
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
463
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
340
464
>GError</a> *error,
341
465
<a
342
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
466
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
343
467
>gpointer</a> user_data,
344
468
<a
345
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
469
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
346
470
>GObject</a> *weak_object);
347
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-status" title="tp_cli_connection_call_get_status ()">tp_cli_connection_call_get_status</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
471
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-status" title="tp_cli_connection_call_get_status ()">tp_cli_connection_call_get_status</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
348
472
<a
349
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
473
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
350
474
>gint</a> timeout_ms,
351
475
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()">tp_cli_connection_callback_for_get_status</a> callback,
352
476
<a
353
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
477
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
354
478
>gpointer</a> user_data,
355
479
<a
356
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
480
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
357
481
>GDestroyNotify</a> destroy,
358
482
<a
359
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
483
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
360
484
>GObject</a> *weak_object);
361
485
<a
362
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
486
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
363
487
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-status" title="tp_cli_connection_run_get_status ()">tp_cli_connection_run_get_status</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
364
488
<a
365
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
489
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
366
490
>gint</a> timeout_ms,
367
491
<a
368
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
369
>guint</a> *out0,
492
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
493
>guint</a> *out_Status,
370
494
<a
371
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
495
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
372
496
>GError</a> **error,
373
497
<a
374
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
498
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
375
499
>GMainLoop</a> **loop);
376
500
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()">*tp_cli_connection_callback_for_hold_handles</a>)
377
501
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
378
502
const <a
379
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
503
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
380
504
>GError</a> *error,
381
505
<a
382
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
506
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
383
507
>gpointer</a> user_data,
384
508
<a
385
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
509
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
386
510
>GObject</a> *weak_object);
387
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-hold-handles" title="tp_cli_connection_call_hold_handles ()">tp_cli_connection_call_hold_handles</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
511
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-hold-handles" title="tp_cli_connection_call_hold_handles ()">tp_cli_connection_call_hold_handles</a>
512
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
388
513
<a
389
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
514
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
390
515
>gint</a> timeout_ms,
391
516
<a
392
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
393
>guint</a> in_handle_type,
517
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
518
>guint</a> in_Handle_Type,
394
519
const <a
395
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
396
>GArray</a> *in_handles,
520
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
521
>GArray</a> *in_Handles,
397
522
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()">tp_cli_connection_callback_for_hold_handles</a> callback,
398
523
<a
399
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
524
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
400
525
>gpointer</a> user_data,
401
526
<a
402
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
527
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
403
528
>GDestroyNotify</a> destroy,
404
529
<a
405
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
530
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
406
531
>GObject</a> *weak_object);
407
532
<a
408
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
533
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
409
534
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-hold-handles" title="tp_cli_connection_run_hold_handles ()">tp_cli_connection_run_hold_handles</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
410
535
<a
411
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
536
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
412
537
>gint</a> timeout_ms,
413
538
<a
414
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
415
>guint</a> in_handle_type,
539
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
540
>guint</a> in_Handle_Type,
416
541
const <a
417
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
418
>GArray</a> *in_handles,
542
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
543
>GArray</a> *in_Handles,
419
544
<a
420
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
545
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
421
546
>GError</a> **error,
422
547
<a
423
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
548
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
424
549
>GMainLoop</a> **loop);
425
550
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()">*tp_cli_connection_callback_for_inspect_handles</a>)
426
551
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
427
552
const <a
428
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
429
>gchar</a> **out0,
553
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
554
>gchar</a> **out_Identifiers,
430
555
const <a
431
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
556
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
432
557
>GError</a> *error,
433
558
<a
434
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
559
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
435
560
>gpointer</a> user_data,
436
561
<a
437
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
562
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
438
563
>GObject</a> *weak_object);
439
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-inspect-handles" title="tp_cli_connection_call_inspect_handles ()">tp_cli_connection_call_inspect_handles</a>
564
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-inspect-handles" title="tp_cli_connection_call_inspect_handles ()">tp_cli_connection_call_inspect_handles</a>
440
565
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
441
566
<a
442
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
567
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
443
568
>gint</a> timeout_ms,
444
569
<a
445
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
446
>guint</a> in_handle_type,
570
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
571
>guint</a> in_Handle_Type,
447
572
const <a
448
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
449
>GArray</a> *in_handles,
573
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
574
>GArray</a> *in_Handles,
450
575
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()">tp_cli_connection_callback_for_inspect_handles</a> callback,
451
576
<a
452
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
577
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
453
578
>gpointer</a> user_data,
454
579
<a
455
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
580
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
456
581
>GDestroyNotify</a> destroy,
457
582
<a
458
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
583
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
459
584
>GObject</a> *weak_object);
460
585
<a
461
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
586
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
462
587
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-inspect-handles" title="tp_cli_connection_run_inspect_handles ()">tp_cli_connection_run_inspect_handles</a>
463
588
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
464
589
<a
465
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
590
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
466
591
>gint</a> timeout_ms,
467
592
<a
468
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
469
>guint</a> in_handle_type,
593
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
594
>guint</a> in_Handle_Type,
470
595
const <a
471
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
472
>GArray</a> *in_handles,
473
<a
474
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
475
>gchar</a> ***out0,
476
<a
477
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
596
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
597
>GArray</a> *in_Handles,
598
<a
599
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
600
>gchar</a> ***out_Identifiers,
601
<a
602
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
478
603
>GError</a> **error,
479
604
<a
480
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
605
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
481
606
>GMainLoop</a> **loop);
482
607
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()">*tp_cli_connection_callback_for_list_channels</a>)
483
608
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
484
609
const <a
485
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
486
>GPtrArray</a> *out0,
610
href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
611
>GPtrArray</a> *out_Channel_Info,
487
612
const <a
488
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
613
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
489
614
>GError</a> *error,
490
615
<a
491
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
616
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
492
617
>gpointer</a> user_data,
493
618
<a
494
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
619
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
495
620
>GObject</a> *weak_object);
496
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-list-channels" title="tp_cli_connection_call_list_channels ()">tp_cli_connection_call_list_channels</a>
621
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-list-channels" title="tp_cli_connection_call_list_channels ()">tp_cli_connection_call_list_channels</a>
497
622
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
498
623
<a
499
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
624
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
500
625
>gint</a> timeout_ms,
501
626
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()">tp_cli_connection_callback_for_list_channels</a> callback,
502
627
<a
503
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
628
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
504
629
>gpointer</a> user_data,
505
630
<a
506
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
631
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
507
632
>GDestroyNotify</a> destroy,
508
633
<a
509
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
634
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
510
635
>GObject</a> *weak_object);
511
636
<a
512
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
637
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
513
638
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-list-channels" title="tp_cli_connection_run_list_channels ()">tp_cli_connection_run_list_channels</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
514
639
<a
515
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
640
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
516
641
>gint</a> timeout_ms,
517
642
<a
518
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
519
>GPtrArray</a> **out0,
643
href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
644
>GPtrArray</a> **out_Channel_Info,
520
645
<a
521
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
646
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
522
647
>GError</a> **error,
523
648
<a
524
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
649
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
525
650
>GMainLoop</a> **loop);
526
651
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()">*tp_cli_connection_callback_for_release_handles</a>)
527
652
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
528
653
const <a
529
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
654
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
530
655
>GError</a> *error,
531
656
<a
532
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
657
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
533
658
>gpointer</a> user_data,
534
659
<a
535
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
660
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
536
661
>GObject</a> *weak_object);
537
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-release-handles" title="tp_cli_connection_call_release_handles ()">tp_cli_connection_call_release_handles</a>
662
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-release-handles" title="tp_cli_connection_call_release_handles ()">tp_cli_connection_call_release_handles</a>
538
663
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
539
664
<a
540
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
665
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
541
666
>gint</a> timeout_ms,
542
667
<a
543
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
544
>guint</a> in_handle_type,
668
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
669
>guint</a> in_Handle_Type,
545
670
const <a
546
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
547
>GArray</a> *in_handles,
671
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
672
>GArray</a> *in_Handles,
548
673
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()">tp_cli_connection_callback_for_release_handles</a> callback,
549
674
<a
550
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
675
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
551
676
>gpointer</a> user_data,
552
677
<a
553
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
678
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
554
679
>GDestroyNotify</a> destroy,
555
680
<a
556
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
681
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
557
682
>GObject</a> *weak_object);
558
683
<a
559
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
684
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
560
685
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-release-handles" title="tp_cli_connection_run_release_handles ()">tp_cli_connection_run_release_handles</a>
561
686
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
562
687
<a
563
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
688
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
564
689
>gint</a> timeout_ms,
565
690
<a
566
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
567
>guint</a> in_handle_type,
691
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
692
>guint</a> in_Handle_Type,
568
693
const <a
569
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
570
>GArray</a> *in_handles,
694
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
695
>GArray</a> *in_Handles,
571
696
<a
572
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
697
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
573
698
>GError</a> **error,
574
699
<a
575
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
700
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
576
701
>GMainLoop</a> **loop);
577
702
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()">*tp_cli_connection_callback_for_request_channel</a>)
578
703
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
579
704
const <a
580
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
581
>gchar</a> *out0,
705
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
706
>gchar</a> *out_Object_Path,
582
707
const <a
583
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
708
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
584
709
>GError</a> *error,
585
710
<a
586
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
711
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
587
712
>gpointer</a> user_data,
588
713
<a
589
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
714
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
590
715
>GObject</a> *weak_object);
591
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-channel" title="tp_cli_connection_call_request_channel ()">tp_cli_connection_call_request_channel</a>
716
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-channel" title="tp_cli_connection_call_request_channel ()">tp_cli_connection_call_request_channel</a>
592
717
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
593
718
<a
594
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
719
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
595
720
>gint</a> timeout_ms,
596
721
const <a
597
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
598
>gchar</a> *in_type,
599
<a
600
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
601
>guint</a> in_handle_type,
602
<a
603
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
604
>guint</a> in_handle,
605
<a
606
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
607
>gboolean</a> in_suppress_handler,
722
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
723
>gchar</a> *in_Type,
724
<a
725
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
726
>guint</a> in_Handle_Type,
727
<a
728
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
729
>guint</a> in_Handle,
730
<a
731
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
732
>gboolean</a> in_Suppress_Handler,
608
733
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()">tp_cli_connection_callback_for_request_channel</a> callback,
609
734
<a
610
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
735
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
611
736
>gpointer</a> user_data,
612
737
<a
613
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
738
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
614
739
>GDestroyNotify</a> destroy,
615
740
<a
616
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
741
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
617
742
>GObject</a> *weak_object);
618
743
<a
619
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
744
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
620
745
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-request-channel" title="tp_cli_connection_run_request_channel ()">tp_cli_connection_run_request_channel</a>
621
746
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
622
747
<a
623
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
748
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
624
749
>gint</a> timeout_ms,
625
750
const <a
626
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
627
>gchar</a> *in_type,
628
<a
629
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
630
>guint</a> in_handle_type,
631
<a
632
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
633
>guint</a> in_handle,
634
<a
635
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
636
>gboolean</a> in_suppress_handler,
637
<a
638
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
639
>gchar</a> **out0,
640
<a
641
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
751
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
752
>gchar</a> *in_Type,
753
<a
754
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
755
>guint</a> in_Handle_Type,
756
<a
757
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
758
>guint</a> in_Handle,
759
<a
760
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
761
>gboolean</a> in_Suppress_Handler,
762
<a
763
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
764
>gchar</a> **out_Object_Path,
765
<a
766
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
642
767
>GError</a> **error,
643
768
<a
644
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
769
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
645
770
>GMainLoop</a> **loop);
646
771
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">*tp_cli_connection_callback_for_request_handles</a>)
647
772
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
648
773
const <a
649
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
650
>GArray</a> *out0,
774
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
775
>GArray</a> *out_Handles,
651
776
const <a
652
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
777
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
653
778
>GError</a> *error,
654
779
<a
655
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
780
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
656
781
>gpointer</a> user_data,
657
782
<a
658
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
783
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
659
784
>GObject</a> *weak_object);
660
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-handles" title="tp_cli_connection_call_request_handles ()">tp_cli_connection_call_request_handles</a>
785
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-handles" title="tp_cli_connection_call_request_handles ()">tp_cli_connection_call_request_handles</a>
661
786
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
662
787
<a
663
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
788
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
664
789
>gint</a> timeout_ms,
665
790
<a
666
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
667
>guint</a> in_handle_type,
791
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
792
>guint</a> in_Handle_Type,
668
793
const <a
669
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
670
>gchar</a> **in_names,
794
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
795
>gchar</a> **in_Names,
671
796
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">tp_cli_connection_callback_for_request_handles</a> callback,
672
797
<a
673
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
798
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
674
799
>gpointer</a> user_data,
675
800
<a
676
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
801
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
677
802
>GDestroyNotify</a> destroy,
678
803
<a
679
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
804
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
680
805
>GObject</a> *weak_object);
681
806
<a
682
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
807
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
683
808
>gboolean</a> <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-request-handles" title="tp_cli_connection_run_request_handles ()">tp_cli_connection_run_request_handles</a>
684
809
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
685
810
<a
686
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
811
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
687
812
>gint</a> timeout_ms,
688
813
<a
689
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
690
>guint</a> in_handle_type,
814
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
815
>guint</a> in_Handle_Type,
691
816
const <a
692
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
693
>gchar</a> **in_names,
694
<a
695
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
696
>GArray</a> **out0,
697
<a
698
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
817
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
818
>gchar</a> **in_Names,
819
<a
820
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
821
>GArray</a> **out_Handles,
822
<a
823
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
699
824
>GError</a> **error,
700
825
<a
701
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
826
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
702
827
>GMainLoop</a> **loop);
703
828
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()">*tp_cli_connection_signal_callback_new_channel</a>)
704
829
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
705
830
const <a
706
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
707
>gchar</a> *arg_object_path,
831
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
832
>gchar</a> *arg_Object_Path,
708
833
const <a
709
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
710
>gchar</a> *arg_channel_type,
711
<a
712
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
713
>guint</a> arg_handle_type,
714
<a
715
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
716
>guint</a> arg_handle,
717
<a
718
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
719
>gboolean</a> arg_suppress_handler,
720
<a
721
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
834
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
835
>gchar</a> *arg_Channel_Type,
836
<a
837
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
838
>guint</a> arg_Handle_Type,
839
<a
840
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
841
>guint</a> arg_Handle,
842
<a
843
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
844
>gboolean</a> arg_Suppress_Handler,
845
<a
846
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
722
847
>gpointer</a> user_data,
723
848
<a
724
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
849
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
725
850
>GObject</a> *weak_object);
726
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-new-channel" title="tp_cli_connection_connect_to_new_channel ()">tp_cli_connection_connect_to_new_channel</a>
851
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-new-channel" title="tp_cli_connection_connect_to_new_channel ()">tp_cli_connection_connect_to_new_channel</a>
727
852
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
728
853
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()">tp_cli_connection_signal_callback_new_channel</a> callback,
729
854
<a
730
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
731
>gpointer</a> user_data,
732
<a
733
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
734
>GDestroyNotify</a> destroy,
735
<a
736
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
737
>GObject</a> *weak_object,
738
<a
739
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
855
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
856
>gpointer</a> user_data,
857
<a
858
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
859
>GDestroyNotify</a> destroy,
860
<a
861
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
862
>GObject</a> *weak_object,
863
<a
864
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
865
>GError</a> **error);
866
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()">*tp_cli_connection_signal_callback_self_handle_changed</a>)
867
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
868
<a
869
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
870
>guint</a> arg_Self_Handle,
871
<a
872
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
873
>gpointer</a> user_data,
874
<a
875
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
876
>GObject</a> *weak_object);
877
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-self-handle-changed" title="tp_cli_connection_connect_to_self_handle_changed ()">tp_cli_connection_connect_to_self_handle_changed</a>
878
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
879
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()">tp_cli_connection_signal_callback_self_handle_changed</a> callback,
880
<a
881
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
882
>gpointer</a> user_data,
883
<a
884
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
885
>GDestroyNotify</a> destroy,
886
<a
887
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
888
>GObject</a> *weak_object,
889
<a
890
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
740
891
>GError</a> **error);
741
892
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()">*tp_cli_connection_signal_callback_status_changed</a>)
742
893
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
743
894
<a
744
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
745
>guint</a> arg_status,
746
<a
747
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
748
>guint</a> arg_reason,
749
<a
750
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
895
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
896
>guint</a> arg_Status,
897
<a
898
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
899
>guint</a> arg_Reason,
900
<a
901
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
751
902
>gpointer</a> user_data,
752
903
<a
753
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
904
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
754
905
>GObject</a> *weak_object);
755
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a>* <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-status-changed" title="tp_cli_connection_connect_to_status_changed ()">tp_cli_connection_connect_to_status_changed</a>
906
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-status-changed" title="tp_cli_connection_connect_to_status_changed ()">tp_cli_connection_connect_to_status_changed</a>
756
907
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
757
908
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()">tp_cli_connection_signal_callback_status_changed</a> callback,
758
909
<a
759
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
760
>gpointer</a> user_data,
761
<a
762
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
763
>GDestroyNotify</a> destroy,
764
<a
765
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
766
>GObject</a> *weak_object,
767
<a
768
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
910
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
911
>gpointer</a> user_data,
912
<a
913
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
914
>GDestroyNotify</a> destroy,
915
<a
916
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
917
>GObject</a> *weak_object,
918
<a
919
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
920
>GError</a> **error);
921
void (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()">*tp_cli_connection_signal_callback_connection_error</a>)
922
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
923
const <a
924
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
925
>gchar</a> *arg_Error,
926
<a
927
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
928
>GHashTable</a> *arg_Details,
929
<a
930
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
931
>gpointer</a> user_data,
932
<a
933
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
934
>GObject</a> *weak_object);
935
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-connection-error" title="tp_cli_connection_connect_to_connection_error ()">tp_cli_connection_connect_to_connection_error</a>
936
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
937
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()">tp_cli_connection_signal_callback_connection_error</a> callback,
938
<a
939
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
940
>gpointer</a> user_data,
941
<a
942
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
943
>GDestroyNotify</a> destroy,
944
<a
945
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
946
>GObject</a> *weak_object,
947
<a
948
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
769
949
>GError</a> **error);
770
950
</pre>
771
951
</div>
773
953
<a name="telepathy-glib-connection.object-hierarchy"></a><h2>Object Hierarchy</h2>
774
954
<pre class="synopsis">
775
955
<a
776
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
956
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
777
957
>GObject</a>
778
958
+----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
779
959
+----TpConnection
783
963
<a name="telepathy-glib-connection.properties"></a><h2>Properties</h2>
784
964
<pre class="synopsis">
785
965
"<a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'>connection-ready</a>" <a
786
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
966
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
787
967
>gboolean</a> : Read
968
"<a class="link" href="telepathy-glib-connection.html#TpConnection--self-handle" title='The "self-handle" property'>self-handle</a>" <a
969
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
970
>guint</a> : Read
788
971
"<a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'>status</a>" <a
789
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
972
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
790
973
>guint</a> : Read
791
974
"<a class="link" href="telepathy-glib-connection.html#TpConnection--status-reason" title='The "status-reason" property'>status-reason</a>" <a
792
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
975
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
793
976
>guint</a> : Read
794
977
</pre>
795
978
</div>
804
987
features:
805
988
</p>
806
989
<p>
807
* connection status tracking
808
990
</p>
809
<p>
810
* calling <code class="function">GetInterfaces()</code> automatically</p>
811
<p>
812
991
<div class="itemizedlist"><ul type="disc">
992
<li>connection status tracking</li>
993
<li>calling <code class="function">GetInterfaces()</code> automatically</li>
994
</ul></div>
995
<p>
813
996
</p>
814
997
</div>
815
998
<div class="refsect1" lang="en">
817
1000
<div class="refsect2" lang="en">
818
1001
<a name="TpConnectionNameListCb"></a><h3>TpConnectionNameListCb ()</h3>
819
1002
<pre class="programlisting">void (*TpConnectionNameListCb) (const <a
820
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1003
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
821
1004
>gchar</a> * const *names,
822
1005
<a
823
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
1006
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
824
1007
>gsize</a> n,
825
1008
const <a
826
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1009
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
827
1010
>gchar</a> * const *cms,
828
1011
const <a
829
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1012
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
830
1013
>gchar</a> * const *protocols,
831
1014
const <a
832
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
1015
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
833
1016
>GError</a> *error,
834
1017
<a
835
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
1018
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
836
1019
>gpointer</a> user_data,
837
1020
<a
838
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
1021
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
839
1022
>GObject</a> *weak_object);</pre>
840
1023
<p>
841
Signature of the callback supplied to <a class="link" href="telepathy-glib-connection-manager.html#tp-list-connection-managers" title="tp_list_connection_managers ()"><code class="function">tp_list_connection_managers()</code></a>.</p>
1024
Signature of the callback supplied to <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()"><code class="function">tp_list_connection_names()</code></a>.</p>
842
1025
<p>
843
844
1026
</p>
845
1027
<div class="variablelist"><table border="0">
846
1028
<col align="left" valign="top">
848
1030
<tr>
849
1031
<td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
850
1032
<td> <a
851
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
852
><code class="literal">NULL</code></a>-terminated array of connection bus names,
1033
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1034
><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> connection bus names,
853
1035
or <a
854
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1036
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
855
1037
><code class="literal">NULL</code></a> on error
856
1038
</td>
857
1039
</tr>
858
1040
<tr>
859
1041
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
860
1042
<td> number of names (not including the final <a
861
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1043
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
862
1044
><code class="literal">NULL</code></a>), or 0 on error
863
1045
</td>
864
1046
</tr>
865
1047
<tr>
866
1048
<td><p><span class="term"><em class="parameter"><code>cms</code></em> :</span></p></td>
867
1049
<td> <a
868
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
869
><code class="literal">NULL</code></a>-terminated array of connection manager names in the same order
870
as <em class="parameter"><code>names</code></em>, or <a
871
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1050
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1051
><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> connection manager names
1052
(e.g. "gabble") in the same order as <em class="parameter"><code>names</code></em>, or <a
1053
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
872
1054
><code class="literal">NULL</code></a> on error
873
1055
</td>
874
1056
</tr>
875
1057
<tr>
876
1058
<td><p><span class="term"><em class="parameter"><code>protocols</code></em> :</span></p></td>
877
1059
<td> <a
878
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
879
><code class="literal">NULL</code></a>-terminated array of protocol names in the same order
880
as <em class="parameter"><code>names</code></em>, or <a
881
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
882
><code class="literal">NULL</code></a> on error
1060
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1061
><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> protocol names as defined in the
1062
Telepathy spec (e.g. "jabber") in the same order as <em class="parameter"><code>names</code></em>, or <a
1063
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1064
><code class="literal">NULL</code></a> on
1065
error
883
1066
</td>
884
1067
</tr>
885
1068
<tr>
886
1069
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
887
1070
<td> <a
888
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1071
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
889
1072
><code class="literal">NULL</code></a> on success, or an error that occurred
890
1073
</td>
891
1074
</tr>
901
1084
</tr>
902
1085
</tbody>
903
1086
</table></div>
904
<p class="since">Since 0.7.1
905
</p>
1087
<p class="since">Since 0.7.1</p>
906
1088
</div>
907
1089
<hr>
908
1090
<div class="refsect2" lang="en">
910
1092
<pre class="programlisting">void tp_list_connection_names (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
911
1093
<a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()">TpConnectionNameListCb</a> callback,
912
1094
<a
913
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
1095
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
914
1096
>gpointer</a> user_data,
915
1097
<a
916
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
1098
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
917
1099
>GDestroyNotify</a> destroy,
918
1100
<a
919
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
1101
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
920
1102
>GObject</a> *weak_object);</pre>
921
1103
<p>
922
List the available (running or installed) connection managers. Call the
923
callback when done.</p>
924
<p>
925
1104
List the bus names of all the connections that currently exist, together
1105
with the connection manager name and the protocol name for each connection.
1106
Call the callback when done.
1107
</p>
1108
<p>
1109
The bus names passed to the callback can be used to construct <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
1110
objects for any connections that are of interest.</p>
1111
<p>
926
1112
</p>
927
1113
<div class="variablelist"><table border="0">
928
1114
<col align="left" valign="top">
954
1140
<tr>
955
1141
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
956
1142
<td> if not <a
957
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1143
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
958
1144
><code class="literal">NULL</code></a>, will be weakly referenced; the callback will
959
not be called, and the call will be cancelled, if the object has vanished
1145
not be called if the object has vanished
960
1146
</td>
961
1147
</tr>
962
1148
</tbody>
963
1149
</table></div>
964
<p class="since">Since 0.7.1
965
</p>
1150
<p class="since">Since 0.7.1</p>
966
1151
</div>
967
1152
<hr>
968
1153
<div class="refsect2" lang="en">
969
1154
<a name="tp-connection-new"></a><h3>tp_connection_new ()</h3>
970
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a>* tp_connection_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *dbus,
1155
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> * tp_connection_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *dbus,
971
1156
const <a
972
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1157
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
973
1158
>gchar</a> *bus_name,
974
1159
const <a
975
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1160
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
976
1161
>gchar</a> *object_path,
977
1162
<a
978
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
1163
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
979
1164
>GError</a> **error);</pre>
980
1165
<p>
981
1166
</p>
982
1167
<p>
983
984
1168
</p>
985
1169
<div class="variablelist"><table border="0">
986
1170
<col align="left" valign="top">
988
1172
<tr>
989
1173
<td><p><span class="term"><em class="parameter"><code>dbus</code></em> :</span></p></td>
990
1174
<td> a D-Bus daemon; may not be <a
991
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1175
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
992
1176
><code class="literal">NULL</code></a>
993
1177
</td>
994
1178
</tr>
997
1181
<td> the well-known or unique name of the connection process;
998
1182
if well-known, this function will make a blocking call to the bus daemon
999
1183
to resolve the unique name. May be <a
1000
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1184
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1001
1185
><code class="literal">NULL</code></a> if <em class="parameter"><code>object_path</code></em> is not, in which
1002
1186
case a well-known name will be derived from <em class="parameter"><code>object_path</code></em>.
1003
1187
</td>
1005
1189
<tr>
1006
1190
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
1007
1191
<td> the object path of the connection process. May be <a
1008
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1192
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1009
1193
><code class="literal">NULL</code></a>
1010
1194
if <em class="parameter"><code>bus_name</code></em> is a well-known name, in which case the object path will
1011
1195
be derived from <em class="parameter"><code>bus_name</code></em>.
1014
1198
<tr>
1015
1199
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1016
1200
<td> used to indicate the error if <a
1017
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1201
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1018
1202
><code class="literal">NULL</code></a> is returned
1019
1203
</td>
1020
1204
</tr>
1021
1205
<tr>
1022
1206
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1023
1207
<td> a new connection proxy, or <a
1024
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1208
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1025
1209
><code class="literal">NULL</code></a> if unique-name resolution
1026
1210
fails or on invalid arguments
1027
1211
1029
1213
</tr>
1030
1214
</tbody>
1031
1215
</table></div>
1032
<p class="since">Since 0.7.1
1033
</p>
1216
<p class="since">Since 0.7.1</p>
1034
1217
</div>
1035
1218
<hr>
1036
1219
<div class="refsect2" lang="en">
1037
1220
<a name="tp-connection-run-until-ready"></a><h3>tp_connection_run_until_ready ()</h3>
1038
1221
<pre class="programlisting"><a
1039
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
1222
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1040
1223
>gboolean</a> tp_connection_run_until_ready (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1041
1224
<a
1042
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
1225
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1043
1226
>gboolean</a> connect,
1044
1227
<a
1045
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
1228
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1046
1229
>GError</a> **error,
1047
1230
<a
1048
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
1231
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1049
1232
>GMainLoop</a> **loop);</pre>
1050
1233
<p>
1051
1234
If <em class="parameter"><code>self</code></em> is connected and ready for use, return immediately. Otherwise,
1052
1235
call <code class="function">Connect()</code> (unless <em class="parameter"><code>connect</code></em> is <a
1053
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1236
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1054
1237
><code class="literal">FALSE</code></a>) and re-enter the main loop
1055
1238
until the connection becomes invalid, the connection connects successfully
1056
1239
and is introspected, or the main loop stored via <em class="parameter"><code>loop</code></em> is cancelled.</p>
1057
1240
<p>
1058
1059
1241
</p>
1060
1242
<div class="variablelist"><table border="0">
1061
1243
<col align="left" valign="top">
1068
1250
<tr>
1069
1251
<td><p><span class="term"><em class="parameter"><code>connect</code></em> :</span></p></td>
1070
1252
<td> if <a
1071
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1253
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1072
1254
><code class="literal">TRUE</code></a>, call <code class="function">Connect()</code> if it appears to be necessary;
1073
1255
if <a
1074
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1256
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1075
1257
><code class="literal">FALSE</code></a>, rely on <code class="function">Connect()</code> to be called by another client
1076
1258
</td>
1077
1259
</tr>
1078
1260
<tr>
1079
1261
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1080
1262
<td> if not <a
1081
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1263
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1082
1264
><code class="literal">NULL</code></a> and <a
1083
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1265
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1084
1266
><code class="literal">FALSE</code></a> is returned, used to raise an error
1085
1267
</td>
1086
1268
</tr>
1087
1269
<tr>
1088
1270
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1089
1271
<td> if not <a
1090
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1272
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1091
1273
><code class="literal">NULL</code></a>, a <a
1092
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
1274
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1093
1275
><span class="type">GMainLoop</span></a> is placed here while it is being run
1094
1276
(so calling code can call <a
1095
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
1277
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
1096
1278
><code class="function">g_main_loop_quit()</code></a> to abort), and <a
1097
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1279
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1098
1280
><code class="literal">NULL</code></a> is
1099
1281
placed here after the loop has been run
1100
1282
</td>
1102
1284
<tr>
1103
1285
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1104
1286
<td> <a
1105
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
1287
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1106
1288
><code class="literal">TRUE</code></a> if the connection is now connected and ready for use,
1107
1289
<a
1108
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1290
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1109
1291
><code class="literal">FALSE</code></a> if the connection has become invalid.
1110
1292
1111
1293
</td>
1112
1294
</tr>
1113
1295
</tbody>
1114
1296
</table></div>
1115
<p class="since">Since 0.7.1
1116
</p>
1297
<p class="since">Since 0.7.1</p>
1117
1298
</div>
1118
1299
<hr>
1119
1300
<div class="refsect2" lang="en">
1120
1301
<a name="TpConnectionWhenReadyCb"></a><h3>TpConnectionWhenReadyCb ()</h3>
1121
1302
<pre class="programlisting">void (*TpConnectionWhenReadyCb) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
1122
1303
const <a
1123
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
1304
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1124
1305
>GError</a> *error,
1125
1306
<a
1126
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
1307
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1127
1308
>gpointer</a> user_data);</pre>
1128
1309
<p>
1129
1310
Signature of a callback passed to <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()"><code class="function">tp_connection_call_when_ready()</code></a>, which
1130
1311
will be called exactly once, when the connection becomes ready or
1131
1312
invalid (whichever happens first)</p>
1132
1313
<p>
1133
1134
1314
</p>
1135
1315
<div class="variablelist"><table border="0">
1136
1316
<col align="left" valign="top">
1139
1319
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
1140
1320
<td> the connection (which may be in the middle of being disposed,
1141
1321
if error is non-<a
1142
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1322
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1143
1323
><code class="literal">NULL</code></a>, error->domain is TP_DBUS_ERRORS and error->code is
1144
1324
TP_DBUS_ERROR_PROXY_UNREFERENCED)
1145
1325
</td>
1147
1327
<tr>
1148
1328
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1149
1329
<td> <a
1150
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
1330
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1151
1331
><code class="literal">NULL</code></a> if the connection is ready for use, or the error with which
1152
1332
it was invalidated if it is now invalid
1153
1333
</td>
1166
1346
<pre class="programlisting">void tp_connection_call_when_ready (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1167
1347
<a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()">TpConnectionWhenReadyCb</a> callback,
1168
1348
<a
1169
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
1349
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1170
1350
>gpointer</a> user_data);</pre>
1171
1351
<p>
1172
1352
If <em class="parameter"><code>self</code></em> is ready for use or has been invalidated, call <em class="parameter"><code>callback</code></em>
1181
1361
unreferenced). In particular, this method does not call <code class="function">Connect()</code>.
1182
1362
Call <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()"><code class="function">tp_cli_connection_call_connect()</code></a> too, if you want to do that.</p>
1183
1363
<p>
1184
1185
1364
</p>
1186
1365
<div class="variablelist"><table border="0">
1187
1366
<col align="left" valign="top">
1204
1383
</tr>
1205
1384
</tbody>
1206
1385
</table></div>
1207
<p class="since">Since 0.7.7
1208
</p>
1386
<p class="since">Since 0.7.7</p>
1387
</div>
1388
<hr>
1389
<div class="refsect2" lang="en">
1390
<a name="tp-connection-is-ready"></a><h3>tp_connection_is_ready ()</h3>
1391
<pre class="programlisting"><a
1392
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1393
>gboolean</a> tp_connection_is_ready (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self);</pre>
1394
<p>
1395
Returns the same thing as the <a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'><span class="type">"connection-ready"</span></a> property.</p>
1396
<p>
1397
</p>
1398
<div class="variablelist"><table border="0">
1399
<col align="left" valign="top">
1400
<tbody>
1401
<tr>
1402
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1403
<td> a connection
1404
</td>
1405
</tr>
1406
<tr>
1407
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1408
<td> <a
1409
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1410
><code class="literal">TRUE</code></a> if introspection has completed
1411
</td>
1412
</tr>
1413
</tbody>
1414
</table></div>
1415
<p class="since">Since 0.7.17</p>
1416
</div>
1417
<hr>
1418
<div class="refsect2" lang="en">
1419
<a name="tp-connection-get-status"></a><h3>tp_connection_get_status ()</h3>
1420
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus">TpConnectionStatus</a> tp_connection_get_status (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1421
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason">TpConnectionStatusReason</a> *reason);</pre>
1422
<p>
1423
If <em class="parameter"><code>reason</code></em> is not <a
1424
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1425
><code class="literal">NULL</code></a> it is set to the reason why "status" changed to its
1426
current value, or <a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-REASON-NONE-SPECIFIED--CAPS"><code class="literal">TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED</code></a> if unknown.</p>
1427
<p>
1428
</p>
1429
<div class="variablelist"><table border="0">
1430
<col align="left" valign="top">
1431
<tbody>
1432
<tr>
1433
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1434
<td> a connection
1435
</td>
1436
</tr>
1437
<tr>
1438
<td><p><span class="term"><em class="parameter"><code>reason</code></em> :</span></p></td>
1439
<td> a TpConnectionStatusReason, or <a
1440
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1441
><code class="literal">NULL</code></a>
1442
</td>
1443
</tr>
1444
<tr>
1445
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1446
<td> This connection's status, or <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS--CAPS" title="TP_UNKNOWN_CONNECTION_STATUS"><code class="literal">TP_UNKNOWN_CONNECTION_STATUS</code></a> if we
1447
don't know yet.
1448
1449
</td>
1450
</tr>
1451
</tbody>
1452
</table></div>
1453
<p class="since">Since 0.7.14</p>
1454
</div>
1455
<hr>
1456
<div class="refsect2" lang="en">
1457
<a name="tp-connection-get-self-handle"></a><h3>tp_connection_get_self_handle ()</h3>
1458
<pre class="programlisting"><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> tp_connection_get_self_handle (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self);</pre>
1459
<p>
1460
Return the <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-CONTACT--CAPS"><code class="literal">TP_HANDLE_TYPE_CONTACT</code></a> handle of the local user on this
1461
connection, or 0 if the connection is not ready (the
1462
TpConnection:connection-ready property is false) or has become invalid
1463
(the TpProxy::invalidated signal).
1464
</p>
1465
<p>
1466
The returned handle is not necessarily valid forever (the
1467
notify::self-handle signal will be emitted if it changes, which can happen
1468
on protocols such as IRC). Construct a <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> object if you want to
1469
track the local user's identifier in the protocol, or other information
1470
like their presence status, over time.</p>
1471
<p>
1472
</p>
1473
<div class="variablelist"><table border="0">
1474
<col align="left" valign="top">
1475
<tbody>
1476
<tr>
1477
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1478
<td> a connection
1479
</td>
1480
</tr>
1481
<tr>
1482
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1483
<td> the value of the TpConnection:self-handle property
1484
1485
</td>
1486
</tr>
1487
</tbody>
1488
</table></div>
1489
<p class="since">Since 0.7.26</p>
1490
</div>
1491
<hr>
1492
<div class="refsect2" lang="en">
1493
<a name="TpConnectionRequestHandlesCb"></a><h3>TpConnectionRequestHandlesCb ()</h3>
1494
<pre class="programlisting">void (*TpConnectionRequestHandlesCb) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
1495
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
1496
<a
1497
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1498
>guint</a> n_handles,
1499
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
1500
const <a
1501
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1502
>gchar</a> * const *ids,
1503
const <a
1504
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1505
>GError</a> *error,
1506
<a
1507
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1508
>gpointer</a> user_data,
1509
<a
1510
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1511
>GObject</a> *weak_object);</pre>
1512
<p>
1513
Signature of the callback called when <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
1514
succeeds or fails.
1515
</p>
1516
<p>
1517
On success, the caller has one reference to each handle in <em class="parameter"><code>handles</code></em>, which
1518
may be released later with <a class="link" href="telepathy-glib-connection.html#tp-connection-unref-handles" title="tp_connection_unref_handles ()"><code class="function">tp_connection_unref_handles()</code></a>. If not
1519
released, the handles will remain valid until <em class="parameter"><code>connection</code></em> becomes invalid
1520
(signalled by TpProxy::invalidated).
1521
</p>
1522
<p>
1523
For convenience, the handle type and IDs requested by the caller are
1524
passed through to this callback, so the caller does not have to include
1525
them in <em class="parameter"><code>user_data</code></em>.</p>
1526
<p>
1527
</p>
1528
<div class="variablelist"><table border="0">
1529
<col align="left" valign="top">
1530
<tbody>
1531
<tr>
1532
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
1533
<td> the connection
1534
</td>
1535
</tr>
1536
<tr>
1537
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1538
<td> the handle type that was passed to
1539
<a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
1540
</td>
1541
</tr>
1542
<tr>
1543
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1544
<td> the number of IDs that were passed to
1545
<a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> on success, or 0 on failure
1546
</td>
1547
</tr>
1548
<tr>
1549
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1550
<td> the <em class="parameter"><code>n_handles</code></em> handles corresponding to <em class="parameter"><code>ids</code></em>, in the same order,
1551
or <a
1552
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1553
><code class="literal">NULL</code></a> on failure
1554
</td>
1555
</tr>
1556
<tr>
1557
<td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
1558
<td> a copy of the array of <em class="parameter"><code>n_handles</code></em> IDs that was passed to
1559
<a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> on success, or <a
1560
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1561
><code class="literal">NULL</code></a> on failure
1562
</td>
1563
</tr>
1564
<tr>
1565
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1566
<td> <a
1567
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1568
><code class="literal">NULL</code></a> on success, or an error on failure
1569
</td>
1570
</tr>
1571
<tr>
1572
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1573
<td> the same arbitrary pointer that was passed to
1574
<a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
1575
</td>
1576
</tr>
1577
<tr>
1578
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1579
<td> the same object that was passed to
1580
<a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
1581
</td>
1582
</tr>
1583
</tbody>
1584
</table></div>
1585
</div>
1586
<hr>
1587
<div class="refsect2" lang="en">
1588
<a name="tp-connection-request-handles"></a><h3>tp_connection_request_handles ()</h3>
1589
<pre class="programlisting">void tp_connection_request_handles (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1590
<a
1591
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1592
>gint</a> timeout_ms,
1593
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
1594
const <a
1595
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1596
>gchar</a> * const *ids,
1597
<a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()">TpConnectionRequestHandlesCb</a> callback,
1598
<a
1599
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1600
>gpointer</a> user_data,
1601
<a
1602
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1603
>GDestroyNotify</a> destroy,
1604
<a
1605
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1606
>GObject</a> *weak_object);</pre>
1607
<p>
1608
Request the handles corresponding to the given identifiers, and if they
1609
are valid, hold (ensure a reference to) the corresponding handles.
1610
</p>
1611
<p>
1612
If they are valid, the callback will later be called with the given
1613
handles; if not all of them are valid, the callback will be called with
1614
an error.</p>
1615
<p>
1616
</p>
1617
<div class="variablelist"><table border="0">
1618
<col align="left" valign="top">
1619
<tbody>
1620
<tr>
1621
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1622
<td> a connection
1623
</td>
1624
</tr>
1625
<tr>
1626
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1627
<td> the timeout in milliseconds, or -1 to use the default
1628
</td>
1629
</tr>
1630
<tr>
1631
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1632
<td> the handle type
1633
</td>
1634
</tr>
1635
<tr>
1636
<td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
1637
<td> an array of string identifiers for which handles are required,
1638
terminated by <a
1639
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1640
><code class="literal">NULL</code></a> (must not be <a
1641
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1642
><code class="literal">NULL</code></a> or empty)
1643
</td>
1644
</tr>
1645
<tr>
1646
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1647
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
1648
unreferenced)
1649
</td>
1650
</tr>
1651
<tr>
1652
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1653
<td> arbitrary user-supplied data
1654
</td>
1655
</tr>
1656
<tr>
1657
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1658
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
1659
<em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
1660
</td>
1661
</tr>
1662
<tr>
1663
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1664
<td> if not <a
1665
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1666
><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
1667
destroyed, <em class="parameter"><code>callback</code></em> will not be called
1668
</td>
1669
</tr>
1670
</tbody>
1671
</table></div>
1672
</div>
1673
<hr>
1674
<div class="refsect2" lang="en">
1675
<a name="TpConnectionHoldHandlesCb"></a><h3>TpConnectionHoldHandlesCb ()</h3>
1676
<pre class="programlisting">void (*TpConnectionHoldHandlesCb) (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *connection,
1677
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
1678
<a
1679
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1680
>guint</a> n_handles,
1681
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
1682
const <a
1683
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1684
>GError</a> *error,
1685
<a
1686
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1687
>gpointer</a> user_data,
1688
<a
1689
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1690
>GObject</a> *weak_object);</pre>
1691
<p>
1692
Signature of the callback called when <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> succeeds
1693
or fails.
1694
</p>
1695
<p>
1696
On success, the caller has one reference to each handle in <em class="parameter"><code>handles</code></em>, which
1697
may be released later with <a class="link" href="telepathy-glib-connection.html#tp-connection-unref-handles" title="tp_connection_unref_handles ()"><code class="function">tp_connection_unref_handles()</code></a>. If not
1698
released, the handles will remain valid until <em class="parameter"><code>connection</code></em> becomes invalid
1699
(signalled by <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a>).
1700
</p>
1701
<p>
1702
For convenience, the handle type and handles requested by the caller are
1703
passed through to this callback on success, so the caller does not have to
1704
include them in <em class="parameter"><code>user_data</code></em>.</p>
1705
<p>
1706
</p>
1707
<div class="variablelist"><table border="0">
1708
<col align="left" valign="top">
1709
<tbody>
1710
<tr>
1711
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
1712
<td> the connection
1713
</td>
1714
</tr>
1715
<tr>
1716
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1717
<td> the handle type that was passed to
1718
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1719
</td>
1720
</tr>
1721
<tr>
1722
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1723
<td> the number of handles that were passed to
1724
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> on success, or 0 on failure
1725
</td>
1726
</tr>
1727
<tr>
1728
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1729
<td> a copy of the array of <em class="parameter"><code>n_handles</code></em> handles that was passed to
1730
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> on success, or <a
1731
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1732
><code class="literal">NULL</code></a> on failure
1733
</td>
1734
</tr>
1735
<tr>
1736
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1737
<td> <a
1738
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1739
><code class="literal">NULL</code></a> on success, or an error on failure
1740
</td>
1741
</tr>
1742
<tr>
1743
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1744
<td> the same arbitrary pointer that was passed to
1745
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1746
</td>
1747
</tr>
1748
<tr>
1749
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1750
<td> the same object that was passed to
1751
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1752
</td>
1753
</tr>
1754
</tbody>
1755
</table></div>
1756
</div>
1757
<hr>
1758
<div class="refsect2" lang="en">
1759
<a name="tp-connection-get-contact-attributes"></a><h3>tp_connection_get_contact_attributes ()</h3>
1760
<pre class="programlisting">void tp_connection_get_contact_attributes
1761
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1762
<a
1763
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1764
>gint</a> timeout_ms,
1765
<a
1766
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1767
>guint</a> n_handles,
1768
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
1769
const <a
1770
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1771
>gchar</a> * const *interfaces,
1772
<a
1773
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1774
>gboolean</a> hold,
1775
<a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</a> callback,
1776
<a
1777
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1778
>gpointer</a> user_data,
1779
<a
1780
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1781
>GDestroyNotify</a> destroy,
1782
<a
1783
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1784
>GObject</a> *weak_object);</pre>
1785
<p>
1786
Return (via a callback) any number of attributes of the given handles, and
1787
if they are valid and <em class="parameter"><code>hold</code></em> is TRUE, hold a reference to them.
1788
</p>
1789
<p>
1790
This is a thin wrapper around the GetContactAttributes D-Bus method, and
1791
should be used in preference to
1792
<code class="function">tp_cli_connection_interface_contacts_get_contact_attributes()</code>.
1793
The <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> API provides a higher-level abstraction which should
1794
usually be used instead.
1795
</p>
1796
<p>
1797
<em class="parameter"><code>callback</code></em> will later be called with the attributes of those of the given
1798
handles that were valid. Invalid handles are simply omitted from the
1799
parameter to the callback.
1800
</p>
1801
<p>
1802
If <em class="parameter"><code>hold</code></em> is <a
1803
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1804
><code class="literal">TRUE</code></a>, the <em class="parameter"><code>callback</code></em> is given one reference to each handle
1805
that appears as a key in the callback's <em class="parameter"><code>attributes</code></em> parameter.</p>
1806
<p>
1807
</p>
1808
<div class="variablelist"><table border="0">
1809
<col align="left" valign="top">
1810
<tbody>
1811
<tr>
1812
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1813
<td> a connection
1814
</td>
1815
</tr>
1816
<tr>
1817
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1818
<td> the timeout in milliseconds, or -1 to use the default
1819
</td>
1820
</tr>
1821
<tr>
1822
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1823
<td> the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
1824
</td>
1825
</tr>
1826
<tr>
1827
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1828
<td> an array of handles
1829
</td>
1830
</tr>
1831
<tr>
1832
<td><p><span class="term"><em class="parameter"><code>interfaces</code></em> :</span></p></td>
1833
<td> a <a
1834
href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"
1835
><span class="type">GStrv</span></a> of interfaces
1836
</td>
1837
</tr>
1838
<tr>
1839
<td><p><span class="term"><em class="parameter"><code>hold</code></em> :</span></p></td>
1840
<td> if <a
1841
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1842
><code class="literal">TRUE</code></a>, the callback will hold one reference to each valid handle
1843
</td>
1844
</tr>
1845
<tr>
1846
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1847
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
1848
unreferenced)
1849
</td>
1850
</tr>
1851
<tr>
1852
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1853
<td> arbitrary user-supplied data
1854
</td>
1855
</tr>
1856
<tr>
1857
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1858
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
1859
<em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
1860
</td>
1861
</tr>
1862
<tr>
1863
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1864
<td> if not <a
1865
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1866
><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
1867
destroyed, <em class="parameter"><code>callback</code></em> will not be called
1868
</td>
1869
</tr>
1870
</tbody>
1871
</table></div>
1872
</div>
1873
<hr>
1874
<div class="refsect2" lang="en">
1875
<a name="tp-connection-hold-handles"></a><h3>tp_connection_hold_handles ()</h3>
1876
<pre class="programlisting">void tp_connection_hold_handles (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1877
<a
1878
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1879
>gint</a> timeout_ms,
1880
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
1881
<a
1882
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1883
>guint</a> n_handles,
1884
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles,
1885
<a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()">TpConnectionHoldHandlesCb</a> callback,
1886
<a
1887
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1888
>gpointer</a> user_data,
1889
<a
1890
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1891
>GDestroyNotify</a> destroy,
1892
<a
1893
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1894
>GObject</a> *weak_object);</pre>
1895
<p>
1896
Hold (ensure a reference to) the given handles, if they are valid.
1897
</p>
1898
<p>
1899
If they are valid, the callback will later be called with the given
1900
handles; if not all of them are valid, the callback will be called with
1901
an error.</p>
1902
<p>
1903
</p>
1904
<div class="variablelist"><table border="0">
1905
<col align="left" valign="top">
1906
<tbody>
1907
<tr>
1908
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1909
<td> a connection
1910
</td>
1911
</tr>
1912
<tr>
1913
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1914
<td> the timeout in milliseconds, or -1 to use the default
1915
</td>
1916
</tr>
1917
<tr>
1918
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1919
<td> the handle type
1920
</td>
1921
</tr>
1922
<tr>
1923
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1924
<td> the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
1925
</td>
1926
</tr>
1927
<tr>
1928
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1929
<td> an array of handles
1930
</td>
1931
</tr>
1932
<tr>
1933
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1934
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
1935
unreferenced)
1936
</td>
1937
</tr>
1938
<tr>
1939
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1940
<td> arbitrary user-supplied data
1941
</td>
1942
</tr>
1943
<tr>
1944
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1945
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
1946
<em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
1947
</td>
1948
</tr>
1949
<tr>
1950
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1951
<td> if not <a
1952
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1953
><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
1954
destroyed, <em class="parameter"><code>callback</code></em> will not be called
1955
</td>
1956
</tr>
1957
</tbody>
1958
</table></div>
1959
</div>
1960
<hr>
1961
<div class="refsect2" lang="en">
1962
<a name="tp-connection-unref-handles"></a><h3>tp_connection_unref_handles ()</h3>
1963
<pre class="programlisting">void tp_connection_unref_handles (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
1964
<a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType">TpHandleType</a> handle_type,
1965
<a
1966
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1967
>guint</a> n_handles,
1968
const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle">TpHandle</a> *handles);</pre>
1969
<p>
1970
Release the reference to the handles in <em class="parameter"><code>handles</code></em> that was obtained by
1971
calling <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> or <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>.
1972
</p>
1973
<p>
1974
This function might release any references held by calling
1975
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-handles" title="tp_cli_connection_call_request_handles ()"><code class="function">tp_cli_connection_call_request_handles()</code></a>,
1976
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-request-handles" title="tp_cli_connection_run_request_handles ()"><code class="function">tp_cli_connection_run_request_handles()</code></a>,
1977
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-hold-handles" title="tp_cli_connection_call_hold_handles ()"><code class="function">tp_cli_connection_call_hold_handles()</code></a>,
1978
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-hold-handles" title="tp_cli_connection_run_hold_handles ()"><code class="function">tp_cli_connection_run_hold_handles()</code></a>,
1979
<a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-call-get-contact-attributes" title="tp_cli_connection_interface_contacts_call_get_contact_attributes ()"><code class="function">tp_cli_connection_interface_contacts_call_get_contact_attributes()</code></a> or
1980
<a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-run-get-contact-attributes" title="tp_cli_connection_interface_contacts_run_get_contact_attributes ()"><code class="function">tp_cli_connection_interface_contacts_run_get_contact_attributes()</code></a> directly.
1981
Those functions should be avoided in favour of using <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a>,
1982
<a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>, <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> and
1983
<a class="link" href="telepathy-glib-connection.html#tp-connection-get-contact-attributes" title="tp_connection_get_contact_attributes ()"><code class="function">tp_connection_get_contact_attributes()</code></a>.
1984
</p>
1985
<p>
1986
If <em class="parameter"><code>self</code></em> has already become invalid, this function does nothing.</p>
1987
<p>
1988
</p>
1989
<div class="variablelist"><table border="0">
1990
<col align="left" valign="top">
1991
<tbody>
1992
<tr>
1993
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1994
<td> a connection
1995
</td>
1996
</tr>
1997
<tr>
1998
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1999
<td> a handle type
2000
</td>
2001
</tr>
2002
<tr>
2003
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
2004
<td> the number of handles in <em class="parameter"><code>handles</code></em>
2005
</td>
2006
</tr>
2007
<tr>
2008
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
2009
<td> an array of <em class="parameter"><code>n_handles</code></em> handles
2010
</td>
2011
</tr>
2012
</tbody>
2013
</table></div>
1209
2014
</div>
1210
2015
<hr>
1211
2016
<div class="refsect2" lang="en">
1219
2024
<a class="link" href="telepathy-glib-proxy-subclass.html#tp-proxy-or-subclass-hook-on-interface-add" title="tp_proxy_or_subclass_hook_on_interface_add ()"><code class="function">tp_proxy_or_subclass_hook_on_interface_add()</code></a> with first argument
1220
2025
<code class="literal">TP_TYPE_CONNECTION</code>.</p>
1221
2026
<p>
1222
1223
</p>
1224
<p class="since">Since 0.7.6
1225
</p>
2027
</p>
2028
<p class="since">Since 0.7.6</p>
2029
</div>
2030
<hr>
2031
<div class="refsect2" lang="en">
2032
<a name="tp-connection-presence-type-cmp-availability"></a><h3>tp_connection_presence_type_cmp_availability ()</h3>
2033
<pre class="programlisting"><a
2034
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2035
>gint</a> tp_connection_presence_type_cmp_availability
2036
(<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> p1,
2037
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> p2);</pre>
2038
<p>
2039
Compares <em class="parameter"><code>p1</code></em> and <em class="parameter"><code>p2</code></em> like <code class="function">strcmp()</code>. <em class="parameter"><code>p1</code></em> > <em class="parameter"><code>p2</code></em> means <em class="parameter"><code>p1</code></em> is more available
2040
than <em class="parameter"><code>p2</code></em>.
2041
</p>
2042
<p>
2043
The order used is: available > busy > away > xa > hidden > offline > error >
2044
unknown > unset</p>
2045
<p>
2046
</p>
2047
<div class="variablelist"><table border="0">
2048
<col align="left" valign="top">
2049
<tbody>
2050
<tr>
2051
<td><p><span class="term"><em class="parameter"><code>p1</code></em> :</span></p></td>
2052
<td> a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
2053
</td>
2054
</tr>
2055
<tr>
2056
<td><p><span class="term"><em class="parameter"><code>p2</code></em> :</span></p></td>
2057
<td> a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
2058
</td>
2059
</tr>
2060
<tr>
2061
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2062
<td> -1, 0 or 1, if <em class="parameter"><code>p1</code></em> is <, == or > than <em class="parameter"><code>p2</code></em>.
2063
2064
</td>
2065
</tr>
2066
</tbody>
2067
</table></div>
2068
<p class="since">Since 0.7.16</p>
2069
</div>
2070
<hr>
2071
<div class="refsect2" lang="en">
2072
<a name="tp-connection-parse-object-path"></a><h3>tp_connection_parse_object_path ()</h3>
2073
<pre class="programlisting"><a
2074
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2075
>gboolean</a> tp_connection_parse_object_path (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *self,
2076
<a
2077
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2078
>gchar</a> **protocol,
2079
<a
2080
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2081
>gchar</a> **cm_name);</pre>
2082
<p>
2083
If the object path of <em class="parameter"><code>connection</code></em> is in the correct form, set
2084
<em class="parameter"><code>protocol</code></em> and <em class="parameter"><code>cm_name</code></em>, return TRUE. Otherwise leave them unchanged and
2085
return FALSE.</p>
2086
<p>
2087
</p>
2088
<div class="variablelist"><table border="0">
2089
<col align="left" valign="top">
2090
<tbody>
2091
<tr>
2092
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2093
<td> a connection
2094
</td>
2095
</tr>
2096
<tr>
2097
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
2098
<td> If not NULL, used to return the protocol of the connection
2099
</td>
2100
</tr>
2101
<tr>
2102
<td><p><span class="term"><em class="parameter"><code>cm_name</code></em> :</span></p></td>
2103
<td> If not NULL, used to return the connection manager name of the
2104
connection
2105
</td>
2106
</tr>
2107
<tr>
2108
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2109
<td> TRUE if the object path was correctly parsed, FALSE otherwise.
2110
2111
</td>
2112
</tr>
2113
</tbody>
2114
</table></div>
2115
<p class="since">Since 0.7.27</p>
1226
2116
</div>
1227
2117
<hr>
1228
2118
<div class="refsect2" lang="en">
1229
2119
<a name="TpConnection-struct"></a><h3>TpConnection</h3>
1230
2120
<pre class="programlisting">typedef struct _TpConnection TpConnection;</pre>
1231
2121
<p>
1232
A proxy object for a Telepathy connection.</p>
1233
<p>
1234
2122
A proxy object for a Telepathy connection.
2123
</p>
2124
<p>
2125
(Changed in 0.7.12: the layout of the structure is visible, allowing
2126
subclassing.)</p>
2127
<p>
1235
2128
</p>
1236
2129
<div class="variablelist"><table border="0">
1237
2130
<col align="left" valign="top">
1238
2131
<tbody></tbody>
1239
2132
</table></div>
1240
<p class="since">Since 0.7.1; structure layout visible since 0.7.12
1241
</p>
2133
<p class="since">Since 0.7.1</p>
1242
2134
</div>
1243
2135
<hr>
1244
2136
<div class="refsect2" lang="en">
1249
2141
</pre>
1250
2142
<p>
1251
2143
The class of a <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>. In addition to <em class="parameter"><code>parent_class</code></em> there are four
1252
pointers reserved for possible future use.</p>
1253
<p>
1254
2144
pointers reserved for possible future use.
2145
</p>
2146
<p>
2147
(Changed in 0.7.12: the layout of the structure is visible, allowing
2148
subclassing.)</p>
2149
<p>
1255
2150
</p>
1256
2151
<div class="variablelist"><table border="0">
1257
2152
<col align="left" valign="top">
1261
2156
</td>
1262
2157
</tr></tbody>
1263
2158
</table></div>
1264
<p class="since">Since 0.7.1; structure layout visible since 0.7.12
1265
</p>
2159
<p class="since">Since 0.7.1</p>
1266
2160
</div>
1267
2161
<hr>
1268
2162
<div class="refsect2" lang="en">
1269
<a name="TP-UNKNOWN-CONNECTION-STATUS:CAPS"></a><h3>TP_UNKNOWN_CONNECTION_STATUS</h3>
2163
<a name="TP-UNKNOWN-CONNECTION-STATUS--CAPS"></a><h3>TP_UNKNOWN_CONNECTION_STATUS</h3>
1270
2164
<pre class="programlisting">#define TP_UNKNOWN_CONNECTION_STATUS ((TpConnectionStatus) -1)
1271
2165
</pre>
1272
2166
<p>
1273
2167
An invalid connection status used in <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> to indicate that the
1274
2168
status has not yet been discovered.</p>
1275
2169
<p>
1276
1277
</p>
1278
<p class="since">Since 0.7.1
1279
</p>
2170
</p>
2171
<p class="since">Since 0.7.1</p>
1280
2172
</div>
1281
2173
<hr>
1282
2174
<div class="refsect2" lang="en">
1283
<a name="TP-ERRORS-DISCONNECTED:CAPS"></a><h3>TP_ERRORS_DISCONNECTED</h3>
2175
<a name="TP-ERRORS-DISCONNECTED--CAPS"></a><h3>TP_ERRORS_DISCONNECTED</h3>
1284
2176
<pre class="programlisting">#define TP_ERRORS_DISCONNECTED (tp_errors_disconnected_quark ())
1285
2177
</pre>
1286
2178
<p>
1287
2179
<a
1288
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2180
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1289
2181
><span class="type">GError</span></a> domain representing a Telepathy connection becoming disconnected.
1290
2182
The <em class="parameter"><code>code</code></em> in a <a
1291
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2183
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1292
2184
><span class="type">GError</span></a> with this domain must be a member of
1293
2185
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a>.
1294
2186
</p>
1295
2187
<p>
1296
2188
This macro expands to a function call returning a <a
1297
href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"
2189
href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"
1298
2190
><span class="type">GQuark</span></a>.</p>
1299
2191
<p>
1300
1301
</p>
1302
<p class="since">Since 0.7.1
1303
</p>
2192
</p>
2193
<p class="since">Since 0.7.1</p>
1304
2194
</div>
1305
2195
<hr>
1306
2196
<div class="refsect2" lang="en">
1308
2198
<pre class="programlisting">void (*tp_cli_connection_callback_for_connect)
1309
2199
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1310
2200
const <a
1311
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2201
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1312
2202
>GError</a> *error,
1313
2203
<a
1314
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2204
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1315
2205
>gpointer</a> user_data,
1316
2206
<a
1317
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2207
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1318
2208
>GObject</a> *weak_object);</pre>
1319
2209
<p>
1320
2210
Signature of the callback called when a Connect method call
1321
2211
succeeds or fails.</p>
1322
2212
<p>
1323
1324
2213
</p>
1325
2214
<div class="variablelist"><table border="0">
1326
2215
<col align="left" valign="top">
1333
2222
<tr>
1334
2223
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1335
2224
<td> <a
1336
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2225
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1337
2226
><code class="literal">NULL</code></a> on success, or an error on failure
1338
2227
</td>
1339
2228
</tr>
1353
2242
<hr>
1354
2243
<div class="refsect2" lang="en">
1355
2244
<a name="tp-cli-connection-call-connect"></a><h3>tp_cli_connection_call_connect ()</h3>
1356
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_connect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2245
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_connect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1357
2246
<a
1358
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2247
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1359
2248
>gint</a> timeout_ms,
1360
2249
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()">tp_cli_connection_callback_for_connect</a> callback,
1361
2250
<a
1362
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2251
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1363
2252
>gpointer</a> user_data,
1364
2253
<a
1365
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
2254
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1366
2255
>GDestroyNotify</a> destroy,
1367
2256
<a
1368
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2257
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1369
2258
>GObject</a> *weak_object);</pre>
1370
2259
<p>
1371
2260
Start a Connect method call.
1372
2261
</p>
1373
2262
<p>
1374
Request that the connection be established. This will be done asynchronously and errors will be returned by emitting StatusChanged signals.</p>
2263
Request that the connection be established. This will be done asynchronously and errors will be returned by emitting <tp:member-ref>StatusChanged</tp:member-ref> signals.</p>
1375
2264
<p>
1376
1377
2265
</p>
1378
2266
<div class="variablelist"><table border="0">
1379
2267
<col align="left" valign="top">
1393
2281
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1394
2282
<td> called when the method call succeeds or fails;
1395
2283
may be <a
1396
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2284
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1397
2285
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
1398
2286
reply tracking
1399
2287
</td>
1402
2290
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1403
2291
<td> user-supplied data passed to the callback;
1404
2292
must be <a
1405
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2293
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1406
2294
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1407
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2295
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1408
2296
><code class="literal">NULL</code></a>
1409
2297
</td>
1410
2298
</tr>
1413
2301
<td> called with the user_data as argument, after the
1414
2302
call has succeeded, failed or been cancelled;
1415
2303
must be <a
1416
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2304
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1417
2305
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1418
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2306
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1419
2307
><code class="literal">NULL</code></a>
1420
2308
</td>
1421
2309
</tr>
1422
2310
<tr>
1423
2311
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1424
2312
<td> If not <a
1425
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2313
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1426
2314
><code class="literal">NULL</code></a>, a <a
1427
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2315
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1428
2316
><span class="type">GObject</span></a> which will be
1429
2317
weakly referenced; if it is destroyed, this call
1430
2318
will automatically be cancelled. Must be <a
1431
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2319
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1432
2320
><code class="literal">NULL</code></a> if
1433
2321
<em class="parameter"><code>callback</code></em> is <a
1434
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2322
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1435
2323
><code class="literal">NULL</code></a>
1436
2324
</td>
1437
2325
</tr>
1450
2338
<div class="refsect2" lang="en">
1451
2339
<a name="tp-cli-connection-run-connect"></a><h3>tp_cli_connection_run_connect ()</h3>
1452
2340
<pre class="programlisting"><a
1453
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
2341
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1454
2342
>gboolean</a> tp_cli_connection_run_connect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1455
2343
<a
1456
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2344
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1457
2345
>gint</a> timeout_ms,
1458
2346
<a
1459
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2347
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1460
2348
>GError</a> **error,
1461
2349
<a
1462
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2350
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1463
2351
>GMainLoop</a> **loop);</pre>
1464
2352
<p>
1465
2353
Call the method Connect and run the main loop
1469
2357
state.
1470
2358
</p>
1471
2359
<p>
1472
Request that the connection be established. This will be done asynchronously and errors will be returned by emitting StatusChanged signals.</p>
2360
Request that the connection be established. This will be done asynchronously and errors will be returned by emitting <tp:member-ref>StatusChanged</tp:member-ref> signals.</p>
1473
2361
<p>
1474
1475
2362
</p>
1476
2363
<div class="variablelist"><table border="0">
1477
2364
<col align="left" valign="top">
1489
2376
<tr>
1490
2377
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1491
2378
<td> If not <a
1492
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2379
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1493
2380
><code class="literal">NULL</code></a>, used to return errors if <a
1494
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2381
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1495
2382
><code class="literal">FALSE</code></a>
1496
2383
is returned
1497
2384
</td>
1499
2386
<tr>
1500
2387
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1501
2388
<td> If not <a
1502
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2389
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1503
2390
><code class="literal">NULL</code></a>, set before re-entering
1504
2391
the main loop, to point to a <a
1505
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2392
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1506
2393
><span class="type">GMainLoop</span></a>
1507
2394
which can be used to cancel this call with
1508
2395
<a
1509
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2396
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
1510
2397
><code class="function">g_main_loop_quit()</code></a>, causing a return of
1511
2398
<a
1512
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1513
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2399
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2400
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1514
2401
</td>
1515
2402
</tr>
1516
2403
<tr>
1527
2414
<pre class="programlisting">void (*tp_cli_connection_callback_for_disconnect)
1528
2415
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1529
2416
const <a
1530
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2417
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1531
2418
>GError</a> *error,
1532
2419
<a
1533
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2420
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1534
2421
>gpointer</a> user_data,
1535
2422
<a
1536
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2423
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1537
2424
>GObject</a> *weak_object);</pre>
1538
2425
<p>
1539
2426
Signature of the callback called when a Disconnect method call
1540
2427
succeeds or fails.</p>
1541
2428
<p>
1542
1543
2429
</p>
1544
2430
<div class="variablelist"><table border="0">
1545
2431
<col align="left" valign="top">
1552
2438
<tr>
1553
2439
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1554
2440
<td> <a
1555
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2441
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1556
2442
><code class="literal">NULL</code></a> on success, or an error on failure
1557
2443
</td>
1558
2444
</tr>
1572
2458
<hr>
1573
2459
<div class="refsect2" lang="en">
1574
2460
<a name="tp-cli-connection-call-disconnect"></a><h3>tp_cli_connection_call_disconnect ()</h3>
1575
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_disconnect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2461
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_disconnect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1576
2462
<a
1577
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2463
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1578
2464
>gint</a> timeout_ms,
1579
2465
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()">tp_cli_connection_callback_for_disconnect</a> callback,
1580
2466
<a
1581
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2467
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1582
2468
>gpointer</a> user_data,
1583
2469
<a
1584
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
2470
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1585
2471
>GDestroyNotify</a> destroy,
1586
2472
<a
1587
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2473
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1588
2474
>GObject</a> *weak_object);</pre>
1589
2475
<p>
1590
2476
Start a Disconnect method call.
1592
2478
<p>
1593
2479
Request that the connection be closed. This closes the connection if it's not already in DISCONNECTED state, and destroys the connection object.</p>
1594
2480
<p>
1595
1596
2481
</p>
1597
2482
<div class="variablelist"><table border="0">
1598
2483
<col align="left" valign="top">
1612
2497
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1613
2498
<td> called when the method call succeeds or fails;
1614
2499
may be <a
1615
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2500
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1616
2501
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
1617
2502
reply tracking
1618
2503
</td>
1621
2506
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1622
2507
<td> user-supplied data passed to the callback;
1623
2508
must be <a
1624
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2509
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1625
2510
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1626
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2511
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1627
2512
><code class="literal">NULL</code></a>
1628
2513
</td>
1629
2514
</tr>
1632
2517
<td> called with the user_data as argument, after the
1633
2518
call has succeeded, failed or been cancelled;
1634
2519
must be <a
1635
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2520
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1636
2521
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1637
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2522
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1638
2523
><code class="literal">NULL</code></a>
1639
2524
</td>
1640
2525
</tr>
1641
2526
<tr>
1642
2527
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1643
2528
<td> If not <a
1644
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2529
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1645
2530
><code class="literal">NULL</code></a>, a <a
1646
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2531
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1647
2532
><span class="type">GObject</span></a> which will be
1648
2533
weakly referenced; if it is destroyed, this call
1649
2534
will automatically be cancelled. Must be <a
1650
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2535
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1651
2536
><code class="literal">NULL</code></a> if
1652
2537
<em class="parameter"><code>callback</code></em> is <a
1653
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2538
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1654
2539
><code class="literal">NULL</code></a>
1655
2540
</td>
1656
2541
</tr>
1669
2554
<div class="refsect2" lang="en">
1670
2555
<a name="tp-cli-connection-run-disconnect"></a><h3>tp_cli_connection_run_disconnect ()</h3>
1671
2556
<pre class="programlisting"><a
1672
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
2557
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1673
2558
>gboolean</a> tp_cli_connection_run_disconnect (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1674
2559
<a
1675
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2560
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1676
2561
>gint</a> timeout_ms,
1677
2562
<a
1678
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2563
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1679
2564
>GError</a> **error,
1680
2565
<a
1681
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2566
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1682
2567
>GMainLoop</a> **loop);</pre>
1683
2568
<p>
1684
2569
Call the method Disconnect and run the main loop
1690
2575
<p>
1691
2576
Request that the connection be closed. This closes the connection if it's not already in DISCONNECTED state, and destroys the connection object.</p>
1692
2577
<p>
1693
1694
2578
</p>
1695
2579
<div class="variablelist"><table border="0">
1696
2580
<col align="left" valign="top">
1708
2592
<tr>
1709
2593
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1710
2594
<td> If not <a
1711
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2595
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1712
2596
><code class="literal">NULL</code></a>, used to return errors if <a
1713
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2597
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1714
2598
><code class="literal">FALSE</code></a>
1715
2599
is returned
1716
2600
</td>
1718
2602
<tr>
1719
2603
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1720
2604
<td> If not <a
1721
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2605
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1722
2606
><code class="literal">NULL</code></a>, set before re-entering
1723
2607
the main loop, to point to a <a
1724
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2608
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1725
2609
><span class="type">GMainLoop</span></a>
1726
2610
which can be used to cancel this call with
1727
2611
<a
1728
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2612
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
1729
2613
><code class="function">g_main_loop_quit()</code></a>, causing a return of
1730
2614
<a
1731
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1732
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2615
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2616
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1733
2617
</td>
1734
2618
</tr>
1735
2619
<tr>
1746
2630
<pre class="programlisting">void (*tp_cli_connection_callback_for_get_interfaces)
1747
2631
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1748
2632
const <a
1749
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1750
>gchar</a> **out0,
2633
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2634
>gchar</a> **out_Interfaces,
1751
2635
const <a
1752
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2636
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1753
2637
>GError</a> *error,
1754
2638
<a
1755
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2639
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1756
2640
>gpointer</a> user_data,
1757
2641
<a
1758
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2642
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1759
2643
>GObject</a> *weak_object);</pre>
1760
2644
<p>
1761
2645
Signature of the callback called when a GetInterfaces method call
1762
2646
succeeds or fails.</p>
1763
2647
<p>
1764
1765
2648
</p>
1766
2649
<div class="variablelist"><table border="0">
1767
2650
<col align="left" valign="top">
1772
2655
</td>
1773
2656
</tr>
1774
2657
<tr>
1775
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
2658
<td><p><span class="term"><em class="parameter"><code>out_Interfaces</code></em> :</span></p></td>
1776
2659
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
1777
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2660
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1778
2661
><code class="literal">NULL</code></a>: An array of D-Bus interface names
1779
2662
</td>
1780
2663
</tr>
1781
2664
<tr>
1782
2665
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1783
2666
<td> <a
1784
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2667
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1785
2668
><code class="literal">NULL</code></a> on success, or an error on failure
1786
2669
</td>
1787
2670
</tr>
1801
2684
<hr>
1802
2685
<div class="refsect2" lang="en">
1803
2686
<a name="tp-cli-connection-call-get-interfaces"></a><h3>tp_cli_connection_call_get_interfaces ()</h3>
1804
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_get_interfaces
2687
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_get_interfaces
1805
2688
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1806
2689
<a
1807
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2690
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1808
2691
>gint</a> timeout_ms,
1809
2692
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()">tp_cli_connection_callback_for_get_interfaces</a> callback,
1810
2693
<a
1811
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2694
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1812
2695
>gpointer</a> user_data,
1813
2696
<a
1814
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
2697
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1815
2698
>GDestroyNotify</a> destroy,
1816
2699
<a
1817
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2700
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1818
2701
>GObject</a> *weak_object);</pre>
1819
2702
<p>
1820
2703
Start a GetInterfaces method call.
1821
2704
</p>
1822
2705
<p>
1823
Get the optional interfaces supported by this connection.</p>
2706
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Get the optional interfaces supported by this connection. Before the connection status changes to CONNECTED, the return from this method may change at any time, but it is guaranteed that interfaces will only be added, not removed. After the connection status changes to CONNECTED, the return from this method cannot change further.</p> <p>There is no explicit change notification; reasonable behaviour for a client would be to retrieve the interfaces list once initially, and once more when it becomes CONNECTED.</p> <tp:rationale> <p>In some connection managers, certain capabilities of a connection are known to be implemented for all connections (e.g. support for SimplePresence), and some interfaces (like SimplePresence) can even be used before connecting. Other capabilities may or may not exist, depending on server functionality; by the time the connection goes CONNECTED, the connection manager is expected to have evaluated the server's functionality and enabled any extra interfaces for the remainder of the Connection's lifetime.</p> </tp:rationale></p>
1824
2707
<p>
1825
1826
2708
</p>
1827
2709
<div class="variablelist"><table border="0">
1828
2710
<col align="left" valign="top">
1842
2724
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1843
2725
<td> called when the method call succeeds or fails;
1844
2726
may be <a
1845
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2727
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1846
2728
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
1847
2729
reply tracking
1848
2730
</td>
1851
2733
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1852
2734
<td> user-supplied data passed to the callback;
1853
2735
must be <a
1854
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2736
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1855
2737
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1856
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2738
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1857
2739
><code class="literal">NULL</code></a>
1858
2740
</td>
1859
2741
</tr>
1862
2744
<td> called with the user_data as argument, after the
1863
2745
call has succeeded, failed or been cancelled;
1864
2746
must be <a
1865
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2747
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1866
2748
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1867
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2749
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1868
2750
><code class="literal">NULL</code></a>
1869
2751
</td>
1870
2752
</tr>
1871
2753
<tr>
1872
2754
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1873
2755
<td> If not <a
1874
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2756
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1875
2757
><code class="literal">NULL</code></a>, a <a
1876
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2758
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1877
2759
><span class="type">GObject</span></a> which will be
1878
2760
weakly referenced; if it is destroyed, this call
1879
2761
will automatically be cancelled. Must be <a
1880
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2762
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1881
2763
><code class="literal">NULL</code></a> if
1882
2764
<em class="parameter"><code>callback</code></em> is <a
1883
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2765
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1884
2766
><code class="literal">NULL</code></a>
1885
2767
</td>
1886
2768
</tr>
1899
2781
<div class="refsect2" lang="en">
1900
2782
<a name="tp-cli-connection-run-get-interfaces"></a><h3>tp_cli_connection_run_get_interfaces ()</h3>
1901
2783
<pre class="programlisting"><a
1902
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
2784
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1903
2785
>gboolean</a> tp_cli_connection_run_get_interfaces
1904
2786
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1905
2787
<a
1906
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2788
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1907
2789
>gint</a> timeout_ms,
1908
2790
<a
1909
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1910
>gchar</a> ***out0,
2791
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2792
>gchar</a> ***out_Interfaces,
1911
2793
<a
1912
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2794
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1913
2795
>GError</a> **error,
1914
2796
<a
1915
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2797
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1916
2798
>GMainLoop</a> **loop);</pre>
1917
2799
<p>
1918
2800
Call the method GetInterfaces and run the main loop
1922
2804
state.
1923
2805
</p>
1924
2806
<p>
1925
Get the optional interfaces supported by this connection.</p>
2807
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Get the optional interfaces supported by this connection. Before the connection status changes to CONNECTED, the return from this method may change at any time, but it is guaranteed that interfaces will only be added, not removed. After the connection status changes to CONNECTED, the return from this method cannot change further.</p> <p>There is no explicit change notification; reasonable behaviour for a client would be to retrieve the interfaces list once initially, and once more when it becomes CONNECTED.</p> <tp:rationale> <p>In some connection managers, certain capabilities of a connection are known to be implemented for all connections (e.g. support for SimplePresence), and some interfaces (like SimplePresence) can even be used before connecting. Other capabilities may or may not exist, depending on server functionality; by the time the connection goes CONNECTED, the connection manager is expected to have evaluated the server's functionality and enabled any extra interfaces for the remainder of the Connection's lifetime.</p> </tp:rationale></p>
1926
2808
<p>
1927
1928
2809
</p>
1929
2810
<div class="variablelist"><table border="0">
1930
2811
<col align="left" valign="top">
1940
2821
</td>
1941
2822
</tr>
1942
2823
<tr>
1943
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
2824
<td><p><span class="term"><em class="parameter"><code>out_Interfaces</code></em> :</span></p></td>
1944
2825
<td> Used to return an 'out' argument if <a
1945
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
2826
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1946
2827
><code class="literal">TRUE</code></a> is returned: An array of D-Bus interface names
1947
2828
</td>
1948
2829
</tr>
1949
2830
<tr>
1950
2831
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1951
2832
<td> If not <a
1952
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2833
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1953
2834
><code class="literal">NULL</code></a>, used to return errors if <a
1954
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2835
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1955
2836
><code class="literal">FALSE</code></a>
1956
2837
is returned
1957
2838
</td>
1959
2840
<tr>
1960
2841
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1961
2842
<td> If not <a
1962
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2843
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1963
2844
><code class="literal">NULL</code></a>, set before re-entering
1964
2845
the main loop, to point to a <a
1965
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
2846
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
1966
2847
><span class="type">GMainLoop</span></a>
1967
2848
which can be used to cancel this call with
1968
2849
<a
1969
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2850
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
1970
2851
><code class="function">g_main_loop_quit()</code></a>, causing a return of
1971
2852
<a
1972
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
1973
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2853
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2854
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1974
2855
</td>
1975
2856
</tr>
1976
2857
<tr>
1987
2868
<pre class="programlisting">void (*tp_cli_connection_callback_for_get_protocol)
1988
2869
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
1989
2870
const <a
1990
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
1991
>gchar</a> *out0,
2871
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
2872
>gchar</a> *out_Protocol,
1992
2873
const <a
1993
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
2874
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1994
2875
>GError</a> *error,
1995
2876
<a
1996
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2877
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1997
2878
>gpointer</a> user_data,
1998
2879
<a
1999
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2880
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2000
2881
>GObject</a> *weak_object);</pre>
2001
2882
<p>
2002
2883
Signature of the callback called when a GetProtocol method call
2003
2884
succeeds or fails.</p>
2004
2885
<p>
2005
2006
2886
</p>
2007
2887
<div class="variablelist"><table border="0">
2008
2888
<col align="left" valign="top">
2013
2893
</td>
2014
2894
</tr>
2015
2895
<tr>
2016
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
2896
<td><p><span class="term"><em class="parameter"><code>out_Protocol</code></em> :</span></p></td>
2017
2897
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
2018
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2898
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2019
2899
><code class="literal">NULL</code></a>: A string identifier for the protocol
2020
2900
</td>
2021
2901
</tr>
2022
2902
<tr>
2023
2903
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2024
2904
<td> <a
2025
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2905
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2026
2906
><code class="literal">NULL</code></a> on success, or an error on failure
2027
2907
</td>
2028
2908
</tr>
2042
2922
<hr>
2043
2923
<div class="refsect2" lang="en">
2044
2924
<a name="tp-cli-connection-call-get-protocol"></a><h3>tp_cli_connection_call_get_protocol ()</h3>
2045
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_get_protocol (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2925
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_get_protocol
2926
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2046
2927
<a
2047
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
2928
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2048
2929
>gint</a> timeout_ms,
2049
2930
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()">tp_cli_connection_callback_for_get_protocol</a> callback,
2050
2931
<a
2051
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
2932
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2052
2933
>gpointer</a> user_data,
2053
2934
<a
2054
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
2935
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
2055
2936
>GDestroyNotify</a> destroy,
2056
2937
<a
2057
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2938
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2058
2939
>GObject</a> *weak_object);</pre>
2059
2940
<p>
2060
2941
Start a GetProtocol method call.
2062
2943
<p>
2063
2944
Get the protocol this connection is using.</p>
2064
2945
<p>
2065
2066
2946
</p>
2067
2947
<div class="variablelist"><table border="0">
2068
2948
<col align="left" valign="top">
2082
2962
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2083
2963
<td> called when the method call succeeds or fails;
2084
2964
may be <a
2085
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2965
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2086
2966
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
2087
2967
reply tracking
2088
2968
</td>
2091
2971
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2092
2972
<td> user-supplied data passed to the callback;
2093
2973
must be <a
2094
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2974
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2095
2975
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2096
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2976
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2097
2977
><code class="literal">NULL</code></a>
2098
2978
</td>
2099
2979
</tr>
2102
2982
<td> called with the user_data as argument, after the
2103
2983
call has succeeded, failed or been cancelled;
2104
2984
must be <a
2105
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2985
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2106
2986
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2107
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2987
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2108
2988
><code class="literal">NULL</code></a>
2109
2989
</td>
2110
2990
</tr>
2111
2991
<tr>
2112
2992
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2113
2993
<td> If not <a
2114
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2994
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2115
2995
><code class="literal">NULL</code></a>, a <a
2116
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
2996
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2117
2997
><span class="type">GObject</span></a> which will be
2118
2998
weakly referenced; if it is destroyed, this call
2119
2999
will automatically be cancelled. Must be <a
2120
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3000
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2121
3001
><code class="literal">NULL</code></a> if
2122
3002
<em class="parameter"><code>callback</code></em> is <a
2123
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3003
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2124
3004
><code class="literal">NULL</code></a>
2125
3005
</td>
2126
3006
</tr>
2139
3019
<div class="refsect2" lang="en">
2140
3020
<a name="tp-cli-connection-run-get-protocol"></a><h3>tp_cli_connection_run_get_protocol ()</h3>
2141
3021
<pre class="programlisting"><a
2142
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3022
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2143
3023
>gboolean</a> tp_cli_connection_run_get_protocol (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2144
3024
<a
2145
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3025
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2146
3026
>gint</a> timeout_ms,
2147
3027
<a
2148
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
2149
>gchar</a> **out0,
3028
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
3029
>gchar</a> **out_Protocol,
2150
3030
<a
2151
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3031
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2152
3032
>GError</a> **error,
2153
3033
<a
2154
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3034
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2155
3035
>GMainLoop</a> **loop);</pre>
2156
3036
<p>
2157
3037
Call the method GetProtocol and run the main loop
2163
3043
<p>
2164
3044
Get the protocol this connection is using.</p>
2165
3045
<p>
2166
2167
3046
</p>
2168
3047
<div class="variablelist"><table border="0">
2169
3048
<col align="left" valign="top">
2179
3058
</td>
2180
3059
</tr>
2181
3060
<tr>
2182
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3061
<td><p><span class="term"><em class="parameter"><code>out_Protocol</code></em> :</span></p></td>
2183
3062
<td> Used to return an 'out' argument if <a
2184
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
3063
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2185
3064
><code class="literal">TRUE</code></a> is returned: A string identifier for the protocol
2186
3065
</td>
2187
3066
</tr>
2188
3067
<tr>
2189
3068
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2190
3069
<td> If not <a
2191
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3070
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2192
3071
><code class="literal">NULL</code></a>, used to return errors if <a
2193
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3072
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2194
3073
><code class="literal">FALSE</code></a>
2195
3074
is returned
2196
3075
</td>
2198
3077
<tr>
2199
3078
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2200
3079
<td> If not <a
2201
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3080
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2202
3081
><code class="literal">NULL</code></a>, set before re-entering
2203
3082
the main loop, to point to a <a
2204
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3083
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2205
3084
><span class="type">GMainLoop</span></a>
2206
3085
which can be used to cancel this call with
2207
3086
<a
2208
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3087
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2209
3088
><code class="function">g_main_loop_quit()</code></a>, causing a return of
2210
3089
<a
2211
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2212
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3090
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3091
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2213
3092
</td>
2214
3093
</tr>
2215
3094
<tr>
2226
3105
<pre class="programlisting">void (*tp_cli_connection_callback_for_get_self_handle)
2227
3106
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2228
3107
<a
2229
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2230
>guint</a> out0,
3108
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3109
>guint</a> out_Self_Handle,
2231
3110
const <a
2232
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3111
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2233
3112
>GError</a> *error,
2234
3113
<a
2235
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3114
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2236
3115
>gpointer</a> user_data,
2237
3116
<a
2238
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3117
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2239
3118
>GObject</a> *weak_object);</pre>
2240
3119
<p>
2241
3120
Signature of the callback called when a GetSelfHandle method call
2242
3121
succeeds or fails.</p>
2243
3122
<p>
2244
2245
3123
</p>
2246
3124
<div class="variablelist"><table border="0">
2247
3125
<col align="left" valign="top">
2252
3130
</td>
2253
3131
</tr>
2254
3132
<tr>
2255
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3133
<td><p><span class="term"><em class="parameter"><code>out_Self_Handle</code></em> :</span></p></td>
2256
3134
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
2257
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
2258
><code class="literal">NULL</code></a>: An integer handle representing the user
3135
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3136
><code class="literal">NULL</code></a>: The value of the <tp:member-ref>SelfHandle</tp:member-ref> property
2259
3137
</td>
2260
3138
</tr>
2261
3139
<tr>
2262
3140
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2263
3141
<td> <a
2264
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3142
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2265
3143
><code class="literal">NULL</code></a> on success, or an error on failure
2266
3144
</td>
2267
3145
</tr>
2281
3159
<hr>
2282
3160
<div class="refsect2" lang="en">
2283
3161
<a name="tp-cli-connection-call-get-self-handle"></a><h3>tp_cli_connection_call_get_self_handle ()</h3>
2284
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_get_self_handle
3162
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_get_self_handle
2285
3163
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2286
3164
<a
2287
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3165
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2288
3166
>gint</a> timeout_ms,
2289
3167
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()">tp_cli_connection_callback_for_get_self_handle</a> callback,
2290
3168
<a
2291
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3169
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2292
3170
>gpointer</a> user_data,
2293
3171
<a
2294
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
3172
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
2295
3173
>GDestroyNotify</a> destroy,
2296
3174
<a
2297
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3175
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2298
3176
>GObject</a> *weak_object);</pre>
2299
3177
<p>
2300
3178
Start a GetSelfHandle method call.
2301
3179
</p>
2302
3180
<p>
2303
Get the handle which represents the user on this connection, which will remain valid for the lifetime of this connection, or until a change in the user's identifier is signalled by the Renamed signal on the Renaming interface (if present).</p>
3181
Returns the value of the SelfHandle property. Change notification is via the SelfHandleChanged signal.</p>
2304
3182
<p>
2305
2306
3183
</p>
2307
3184
<div class="variablelist"><table border="0">
2308
3185
<col align="left" valign="top">
2322
3199
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2323
3200
<td> called when the method call succeeds or fails;
2324
3201
may be <a
2325
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3202
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2326
3203
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
2327
3204
reply tracking
2328
3205
</td>
2331
3208
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2332
3209
<td> user-supplied data passed to the callback;
2333
3210
must be <a
2334
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3211
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2335
3212
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2336
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3213
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2337
3214
><code class="literal">NULL</code></a>
2338
3215
</td>
2339
3216
</tr>
2342
3219
<td> called with the user_data as argument, after the
2343
3220
call has succeeded, failed or been cancelled;
2344
3221
must be <a
2345
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3222
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2346
3223
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2347
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3224
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2348
3225
><code class="literal">NULL</code></a>
2349
3226
</td>
2350
3227
</tr>
2351
3228
<tr>
2352
3229
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2353
3230
<td> If not <a
2354
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3231
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2355
3232
><code class="literal">NULL</code></a>, a <a
2356
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3233
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2357
3234
><span class="type">GObject</span></a> which will be
2358
3235
weakly referenced; if it is destroyed, this call
2359
3236
will automatically be cancelled. Must be <a
2360
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3237
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2361
3238
><code class="literal">NULL</code></a> if
2362
3239
<em class="parameter"><code>callback</code></em> is <a
2363
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3240
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2364
3241
><code class="literal">NULL</code></a>
2365
3242
</td>
2366
3243
</tr>
2379
3256
<div class="refsect2" lang="en">
2380
3257
<a name="tp-cli-connection-run-get-self-handle"></a><h3>tp_cli_connection_run_get_self_handle ()</h3>
2381
3258
<pre class="programlisting"><a
2382
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3259
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2383
3260
>gboolean</a> tp_cli_connection_run_get_self_handle
2384
3261
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2385
3262
<a
2386
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3263
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2387
3264
>gint</a> timeout_ms,
2388
3265
<a
2389
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2390
>guint</a> *out0,
3266
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3267
>guint</a> *out_Self_Handle,
2391
3268
<a
2392
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3269
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2393
3270
>GError</a> **error,
2394
3271
<a
2395
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3272
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2396
3273
>GMainLoop</a> **loop);</pre>
2397
3274
<p>
2398
3275
Call the method GetSelfHandle and run the main loop
2402
3279
state.
2403
3280
</p>
2404
3281
<p>
2405
Get the handle which represents the user on this connection, which will remain valid for the lifetime of this connection, or until a change in the user's identifier is signalled by the Renamed signal on the Renaming interface (if present).</p>
3282
Returns the value of the SelfHandle property. Change notification is via the SelfHandleChanged signal.</p>
2406
3283
<p>
2407
2408
3284
</p>
2409
3285
<div class="variablelist"><table border="0">
2410
3286
<col align="left" valign="top">
2420
3296
</td>
2421
3297
</tr>
2422
3298
<tr>
2423
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3299
<td><p><span class="term"><em class="parameter"><code>out_Self_Handle</code></em> :</span></p></td>
2424
3300
<td> Used to return an 'out' argument if <a
2425
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
2426
><code class="literal">TRUE</code></a> is returned: An integer handle representing the user
3301
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3302
><code class="literal">TRUE</code></a> is returned: The value of the <tp:member-ref>SelfHandle</tp:member-ref> property
2427
3303
</td>
2428
3304
</tr>
2429
3305
<tr>
2430
3306
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2431
3307
<td> If not <a
2432
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3308
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2433
3309
><code class="literal">NULL</code></a>, used to return errors if <a
2434
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3310
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2435
3311
><code class="literal">FALSE</code></a>
2436
3312
is returned
2437
3313
</td>
2439
3315
<tr>
2440
3316
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2441
3317
<td> If not <a
2442
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3318
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2443
3319
><code class="literal">NULL</code></a>, set before re-entering
2444
3320
the main loop, to point to a <a
2445
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3321
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2446
3322
><span class="type">GMainLoop</span></a>
2447
3323
which can be used to cancel this call with
2448
3324
<a
2449
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3325
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2450
3326
><code class="function">g_main_loop_quit()</code></a>, causing a return of
2451
3327
<a
2452
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2453
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3328
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3329
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2454
3330
</td>
2455
3331
</tr>
2456
3332
<tr>
2467
3343
<pre class="programlisting">void (*tp_cli_connection_callback_for_get_status)
2468
3344
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2469
3345
<a
2470
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2471
>guint</a> out0,
3346
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3347
>guint</a> out_Status,
2472
3348
const <a
2473
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3349
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2474
3350
>GError</a> *error,
2475
3351
<a
2476
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3352
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2477
3353
>gpointer</a> user_data,
2478
3354
<a
2479
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3355
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2480
3356
>GObject</a> *weak_object);</pre>
2481
3357
<p>
2482
3358
Signature of the callback called when a GetStatus method call
2483
3359
succeeds or fails.</p>
2484
3360
<p>
2485
2486
3361
</p>
2487
3362
<div class="variablelist"><table border="0">
2488
3363
<col align="left" valign="top">
2493
3368
</td>
2494
3369
</tr>
2495
3370
<tr>
2496
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3371
<td><p><span class="term"><em class="parameter"><code>out_Status</code></em> :</span></p></td>
2497
3372
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
2498
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3373
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2499
3374
><code class="literal">NULL</code></a>: An integer representing the current status
2500
3375
</td>
2501
3376
</tr>
2502
3377
<tr>
2503
3378
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2504
3379
<td> <a
2505
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3380
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2506
3381
><code class="literal">NULL</code></a> on success, or an error on failure
2507
3382
</td>
2508
3383
</tr>
2522
3397
<hr>
2523
3398
<div class="refsect2" lang="en">
2524
3399
<a name="tp-cli-connection-call-get-status"></a><h3>tp_cli_connection_call_get_status ()</h3>
2525
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_get_status (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3400
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_get_status (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2526
3401
<a
2527
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3402
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2528
3403
>gint</a> timeout_ms,
2529
3404
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()">tp_cli_connection_callback_for_get_status</a> callback,
2530
3405
<a
2531
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3406
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2532
3407
>gpointer</a> user_data,
2533
3408
<a
2534
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
3409
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
2535
3410
>GDestroyNotify</a> destroy,
2536
3411
<a
2537
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3412
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2538
3413
>GObject</a> *weak_object);</pre>
2539
3414
<p>
2540
3415
Start a GetStatus method call.
2541
3416
</p>
2542
3417
<p>
2543
Get the current status as defined in the StatusChanged signal.</p>
3418
Get the current status as defined in the <tp:member-ref>StatusChanged</tp:member-ref> signal.</p>
2544
3419
<p>
2545
2546
3420
</p>
2547
3421
<div class="variablelist"><table border="0">
2548
3422
<col align="left" valign="top">
2562
3436
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2563
3437
<td> called when the method call succeeds or fails;
2564
3438
may be <a
2565
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3439
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2566
3440
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
2567
3441
reply tracking
2568
3442
</td>
2571
3445
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2572
3446
<td> user-supplied data passed to the callback;
2573
3447
must be <a
2574
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3448
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2575
3449
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2576
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3450
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2577
3451
><code class="literal">NULL</code></a>
2578
3452
</td>
2579
3453
</tr>
2582
3456
<td> called with the user_data as argument, after the
2583
3457
call has succeeded, failed or been cancelled;
2584
3458
must be <a
2585
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3459
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2586
3460
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2587
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3461
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2588
3462
><code class="literal">NULL</code></a>
2589
3463
</td>
2590
3464
</tr>
2591
3465
<tr>
2592
3466
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2593
3467
<td> If not <a
2594
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3468
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2595
3469
><code class="literal">NULL</code></a>, a <a
2596
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3470
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2597
3471
><span class="type">GObject</span></a> which will be
2598
3472
weakly referenced; if it is destroyed, this call
2599
3473
will automatically be cancelled. Must be <a
2600
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3474
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2601
3475
><code class="literal">NULL</code></a> if
2602
3476
<em class="parameter"><code>callback</code></em> is <a
2603
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3477
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2604
3478
><code class="literal">NULL</code></a>
2605
3479
</td>
2606
3480
</tr>
2619
3493
<div class="refsect2" lang="en">
2620
3494
<a name="tp-cli-connection-run-get-status"></a><h3>tp_cli_connection_run_get_status ()</h3>
2621
3495
<pre class="programlisting"><a
2622
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3496
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2623
3497
>gboolean</a> tp_cli_connection_run_get_status (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2624
3498
<a
2625
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3499
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2626
3500
>gint</a> timeout_ms,
2627
3501
<a
2628
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2629
>guint</a> *out0,
3502
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3503
>guint</a> *out_Status,
2630
3504
<a
2631
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3505
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2632
3506
>GError</a> **error,
2633
3507
<a
2634
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3508
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2635
3509
>GMainLoop</a> **loop);</pre>
2636
3510
<p>
2637
3511
Call the method GetStatus and run the main loop
2641
3515
state.
2642
3516
</p>
2643
3517
<p>
2644
Get the current status as defined in the StatusChanged signal.</p>
3518
Get the current status as defined in the <tp:member-ref>StatusChanged</tp:member-ref> signal.</p>
2645
3519
<p>
2646
2647
3520
</p>
2648
3521
<div class="variablelist"><table border="0">
2649
3522
<col align="left" valign="top">
2659
3532
</td>
2660
3533
</tr>
2661
3534
<tr>
2662
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3535
<td><p><span class="term"><em class="parameter"><code>out_Status</code></em> :</span></p></td>
2663
3536
<td> Used to return an 'out' argument if <a
2664
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
3537
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
2665
3538
><code class="literal">TRUE</code></a> is returned: An integer representing the current status
2666
3539
</td>
2667
3540
</tr>
2668
3541
<tr>
2669
3542
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2670
3543
<td> If not <a
2671
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3544
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2672
3545
><code class="literal">NULL</code></a>, used to return errors if <a
2673
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3546
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2674
3547
><code class="literal">FALSE</code></a>
2675
3548
is returned
2676
3549
</td>
2678
3551
<tr>
2679
3552
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2680
3553
<td> If not <a
2681
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3554
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2682
3555
><code class="literal">NULL</code></a>, set before re-entering
2683
3556
the main loop, to point to a <a
2684
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3557
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2685
3558
><span class="type">GMainLoop</span></a>
2686
3559
which can be used to cancel this call with
2687
3560
<a
2688
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3561
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2689
3562
><code class="function">g_main_loop_quit()</code></a>, causing a return of
2690
3563
<a
2691
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2692
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3564
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3565
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2693
3566
</td>
2694
3567
</tr>
2695
3568
<tr>
2706
3579
<pre class="programlisting">void (*tp_cli_connection_callback_for_hold_handles)
2707
3580
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2708
3581
const <a
2709
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3582
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2710
3583
>GError</a> *error,
2711
3584
<a
2712
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3585
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2713
3586
>gpointer</a> user_data,
2714
3587
<a
2715
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3588
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2716
3589
>GObject</a> *weak_object);</pre>
2717
3590
<p>
2718
3591
Signature of the callback called when a HoldHandles method call
2719
3592
succeeds or fails.</p>
2720
3593
<p>
2721
2722
3594
</p>
2723
3595
<div class="variablelist"><table border="0">
2724
3596
<col align="left" valign="top">
2731
3603
<tr>
2732
3604
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2733
3605
<td> <a
2734
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3606
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2735
3607
><code class="literal">NULL</code></a> on success, or an error on failure
2736
3608
</td>
2737
3609
</tr>
2751
3623
<hr>
2752
3624
<div class="refsect2" lang="en">
2753
3625
<a name="tp-cli-connection-call-hold-handles"></a><h3>tp_cli_connection_call_hold_handles ()</h3>
2754
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_hold_handles (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3626
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_hold_handles
3627
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2755
3628
<a
2756
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3629
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2757
3630
>gint</a> timeout_ms,
2758
3631
<a
2759
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2760
>guint</a> in_handle_type,
3632
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3633
>guint</a> in_Handle_Type,
2761
3634
const <a
2762
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
2763
>GArray</a> *in_handles,
3635
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
3636
>GArray</a> *in_Handles,
2764
3637
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()">tp_cli_connection_callback_for_hold_handles</a> callback,
2765
3638
<a
2766
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3639
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2767
3640
>gpointer</a> user_data,
2768
3641
<a
2769
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
3642
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
2770
3643
>GDestroyNotify</a> destroy,
2771
3644
<a
2772
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3645
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2773
3646
>GObject</a> *weak_object);</pre>
2774
3647
<p>
2775
3648
Start a HoldHandles method call.
2776
3649
</p>
2777
3650
<p>
2778
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Notify the connection manger that your client is holding a copy of handles which may not be in use in any existing channel or list, and were not obtained by using the RequestHandles method. For example, a handle observed in an emitted signal, or displayed somewhere in the UI that is not associated with a channel. The connection manager must not deallocate a handle where any clients have used this method to indicate it is in use until the ReleaseHandle method is called, or the clients disappear from the bus.</p> <p>Note that HoldHandles is idempotent - calling it multiple times is equivalent to calling it once. If a handle is &quot;referenced&quot; by several components which share a D-Bus unique name, the client should perform reference counting internally, and only call ReleaseHandles when none of the cooperating components need the handle any longer.</p></p>
3651
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Notify the connection manger that your client is holding a copy of handles which may not be in use in any existing channel or list, and were not obtained by using the <tp:member-ref>RequestHandles</tp:member-ref> method. For example, a handle observed in an emitted signal, or displayed somewhere in the UI that is not associated with a channel. The connection manager must not deallocate a handle where any clients have used this method to indicate it is in use until the <tp:member-ref>ReleaseHandles</tp:member-ref> method is called, or the clients disappear from the bus.</p> <p>Note that HoldHandles is idempotent - calling it multiple times is equivalent to calling it once. If a handle is &quot;referenced&quot; by several components which share a D-Bus unique name, the client should perform reference counting internally, and only call ReleaseHandles when none of the cooperating components need the handle any longer.</p></p>
2779
3652
<p>
2780
2781
3653
</p>
2782
3654
<div class="variablelist"><table border="0">
2783
3655
<col align="left" valign="top">
2794
3666
</td>
2795
3667
</tr>
2796
3668
<tr>
2797
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
3669
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2798
3670
<td> Used to pass an 'in' argument: The type of handle to be held
2799
3671
</td>
2800
3672
</tr>
2801
3673
<tr>
2802
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
3674
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2803
3675
<td> Used to pass an 'in' argument: A array of integer handles to hold
2804
3676
</td>
2805
3677
</tr>
2807
3679
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2808
3680
<td> called when the method call succeeds or fails;
2809
3681
may be <a
2810
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3682
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2811
3683
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
2812
3684
reply tracking
2813
3685
</td>
2816
3688
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2817
3689
<td> user-supplied data passed to the callback;
2818
3690
must be <a
2819
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3691
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2820
3692
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2821
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3693
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2822
3694
><code class="literal">NULL</code></a>
2823
3695
</td>
2824
3696
</tr>
2827
3699
<td> called with the user_data as argument, after the
2828
3700
call has succeeded, failed or been cancelled;
2829
3701
must be <a
2830
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3702
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2831
3703
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
2832
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3704
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2833
3705
><code class="literal">NULL</code></a>
2834
3706
</td>
2835
3707
</tr>
2836
3708
<tr>
2837
3709
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2838
3710
<td> If not <a
2839
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3711
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2840
3712
><code class="literal">NULL</code></a>, a <a
2841
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3713
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2842
3714
><span class="type">GObject</span></a> which will be
2843
3715
weakly referenced; if it is destroyed, this call
2844
3716
will automatically be cancelled. Must be <a
2845
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3717
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2846
3718
><code class="literal">NULL</code></a> if
2847
3719
<em class="parameter"><code>callback</code></em> is <a
2848
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3720
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2849
3721
><code class="literal">NULL</code></a>
2850
3722
</td>
2851
3723
</tr>
2864
3736
<div class="refsect2" lang="en">
2865
3737
<a name="tp-cli-connection-run-hold-handles"></a><h3>tp_cli_connection_run_hold_handles ()</h3>
2866
3738
<pre class="programlisting"><a
2867
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3739
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
2868
3740
>gboolean</a> tp_cli_connection_run_hold_handles (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2869
3741
<a
2870
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3742
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
2871
3743
>gint</a> timeout_ms,
2872
3744
<a
2873
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
2874
>guint</a> in_handle_type,
3745
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3746
>guint</a> in_Handle_Type,
2875
3747
const <a
2876
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
2877
>GArray</a> *in_handles,
3748
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
3749
>GArray</a> *in_Handles,
2878
3750
<a
2879
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3751
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2880
3752
>GError</a> **error,
2881
3753
<a
2882
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3754
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2883
3755
>GMainLoop</a> **loop);</pre>
2884
3756
<p>
2885
3757
Call the method HoldHandles and run the main loop
2889
3761
state.
2890
3762
</p>
2891
3763
<p>
2892
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Notify the connection manger that your client is holding a copy of handles which may not be in use in any existing channel or list, and were not obtained by using the RequestHandles method. For example, a handle observed in an emitted signal, or displayed somewhere in the UI that is not associated with a channel. The connection manager must not deallocate a handle where any clients have used this method to indicate it is in use until the ReleaseHandle method is called, or the clients disappear from the bus.</p> <p>Note that HoldHandles is idempotent - calling it multiple times is equivalent to calling it once. If a handle is &quot;referenced&quot; by several components which share a D-Bus unique name, the client should perform reference counting internally, and only call ReleaseHandles when none of the cooperating components need the handle any longer.</p></p>
3764
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Notify the connection manger that your client is holding a copy of handles which may not be in use in any existing channel or list, and were not obtained by using the <tp:member-ref>RequestHandles</tp:member-ref> method. For example, a handle observed in an emitted signal, or displayed somewhere in the UI that is not associated with a channel. The connection manager must not deallocate a handle where any clients have used this method to indicate it is in use until the <tp:member-ref>ReleaseHandles</tp:member-ref> method is called, or the clients disappear from the bus.</p> <p>Note that HoldHandles is idempotent - calling it multiple times is equivalent to calling it once. If a handle is &quot;referenced&quot; by several components which share a D-Bus unique name, the client should perform reference counting internally, and only call ReleaseHandles when none of the cooperating components need the handle any longer.</p></p>
2893
3765
<p>
2894
2895
3766
</p>
2896
3767
<div class="variablelist"><table border="0">
2897
3768
<col align="left" valign="top">
2907
3778
</td>
2908
3779
</tr>
2909
3780
<tr>
2910
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
3781
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2911
3782
<td> Used to pass an 'in' argument: The type of handle to be held
2912
3783
</td>
2913
3784
</tr>
2914
3785
<tr>
2915
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
3786
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2916
3787
<td> Used to pass an 'in' argument: A array of integer handles to hold
2917
3788
</td>
2918
3789
</tr>
2919
3790
<tr>
2920
3791
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2921
3792
<td> If not <a
2922
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3793
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2923
3794
><code class="literal">NULL</code></a>, used to return errors if <a
2924
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3795
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
2925
3796
><code class="literal">FALSE</code></a>
2926
3797
is returned
2927
3798
</td>
2929
3800
<tr>
2930
3801
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2931
3802
<td> If not <a
2932
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3803
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2933
3804
><code class="literal">NULL</code></a>, set before re-entering
2934
3805
the main loop, to point to a <a
2935
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
3806
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
2936
3807
><span class="type">GMainLoop</span></a>
2937
3808
which can be used to cancel this call with
2938
3809
<a
2939
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3810
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
2940
3811
><code class="function">g_main_loop_quit()</code></a>, causing a return of
2941
3812
<a
2942
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
2943
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3813
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3814
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2944
3815
</td>
2945
3816
</tr>
2946
3817
<tr>
2957
3828
<pre class="programlisting">void (*tp_cli_connection_callback_for_inspect_handles)
2958
3829
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
2959
3830
const <a
2960
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
2961
>gchar</a> **out0,
3831
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
3832
>gchar</a> **out_Identifiers,
2962
3833
const <a
2963
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
3834
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
2964
3835
>GError</a> *error,
2965
3836
<a
2966
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3837
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
2967
3838
>gpointer</a> user_data,
2968
3839
<a
2969
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3840
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
2970
3841
>GObject</a> *weak_object);</pre>
2971
3842
<p>
2972
3843
Signature of the callback called when a InspectHandles method call
2973
3844
succeeds or fails.</p>
2974
3845
<p>
2975
2976
3846
</p>
2977
3847
<div class="variablelist"><table border="0">
2978
3848
<col align="left" valign="top">
2983
3853
</td>
2984
3854
</tr>
2985
3855
<tr>
2986
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
3856
<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
2987
3857
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
2988
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3858
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2989
3859
><code class="literal">NULL</code></a>: An array of handle names in the same order as the given numbers
2990
3860
</td>
2991
3861
</tr>
2992
3862
<tr>
2993
3863
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2994
3864
<td> <a
2995
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3865
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2996
3866
><code class="literal">NULL</code></a> on success, or an error on failure
2997
3867
</td>
2998
3868
</tr>
3012
3882
<hr>
3013
3883
<div class="refsect2" lang="en">
3014
3884
<a name="tp-cli-connection-call-inspect-handles"></a><h3>tp_cli_connection_call_inspect_handles ()</h3>
3015
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_inspect_handles
3885
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_inspect_handles
3016
3886
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3017
3887
<a
3018
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
3888
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3019
3889
>gint</a> timeout_ms,
3020
3890
<a
3021
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3022
>guint</a> in_handle_type,
3891
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
3892
>guint</a> in_Handle_Type,
3023
3893
const <a
3024
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
3025
>GArray</a> *in_handles,
3894
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
3895
>GArray</a> *in_Handles,
3026
3896
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()">tp_cli_connection_callback_for_inspect_handles</a> callback,
3027
3897
<a
3028
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
3898
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3029
3899
>gpointer</a> user_data,
3030
3900
<a
3031
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
3901
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
3032
3902
>GDestroyNotify</a> destroy,
3033
3903
<a
3034
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3904
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3035
3905
>GObject</a> *weak_object);</pre>
3036
3906
<p>
3037
3907
Start a InspectHandles method call.
3039
3909
<p>
3040
3910
Return a string representation for a number of handles of a given type.</p>
3041
3911
<p>
3042
3043
3912
</p>
3044
3913
<div class="variablelist"><table border="0">
3045
3914
<col align="left" valign="top">
3056
3925
</td>
3057
3926
</tr>
3058
3927
<tr>
3059
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
3928
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3060
3929
<td> Used to pass an 'in' argument: The type of handle to be inspected
3061
3930
</td>
3062
3931
</tr>
3063
3932
<tr>
3064
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
3933
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3065
3934
<td> Used to pass an 'in' argument: An array of integer handles of this type
3066
3935
</td>
3067
3936
</tr>
3069
3938
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3070
3939
<td> called when the method call succeeds or fails;
3071
3940
may be <a
3072
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3941
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3073
3942
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3074
3943
reply tracking
3075
3944
</td>
3078
3947
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3079
3948
<td> user-supplied data passed to the callback;
3080
3949
must be <a
3081
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3950
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3082
3951
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3083
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3952
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3084
3953
><code class="literal">NULL</code></a>
3085
3954
</td>
3086
3955
</tr>
3089
3958
<td> called with the user_data as argument, after the
3090
3959
call has succeeded, failed or been cancelled;
3091
3960
must be <a
3092
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3961
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3093
3962
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3094
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3963
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3095
3964
><code class="literal">NULL</code></a>
3096
3965
</td>
3097
3966
</tr>
3098
3967
<tr>
3099
3968
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3100
3969
<td> If not <a
3101
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3970
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3102
3971
><code class="literal">NULL</code></a>, a <a
3103
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
3972
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3104
3973
><span class="type">GObject</span></a> which will be
3105
3974
weakly referenced; if it is destroyed, this call
3106
3975
will automatically be cancelled. Must be <a
3107
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3976
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3108
3977
><code class="literal">NULL</code></a> if
3109
3978
<em class="parameter"><code>callback</code></em> is <a
3110
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
3979
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3111
3980
><code class="literal">NULL</code></a>
3112
3981
</td>
3113
3982
</tr>
3126
3995
<div class="refsect2" lang="en">
3127
3996
<a name="tp-cli-connection-run-inspect-handles"></a><h3>tp_cli_connection_run_inspect_handles ()</h3>
3128
3997
<pre class="programlisting"><a
3129
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3998
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
3130
3999
>gboolean</a> tp_cli_connection_run_inspect_handles
3131
4000
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3132
4001
<a
3133
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4002
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3134
4003
>gint</a> timeout_ms,
3135
4004
<a
3136
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3137
>guint</a> in_handle_type,
4005
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4006
>guint</a> in_Handle_Type,
3138
4007
const <a
3139
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
3140
>GArray</a> *in_handles,
3141
<a
3142
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
3143
>gchar</a> ***out0,
3144
<a
3145
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4008
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
4009
>GArray</a> *in_Handles,
4010
<a
4011
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4012
>gchar</a> ***out_Identifiers,
4013
<a
4014
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3146
4015
>GError</a> **error,
3147
4016
<a
3148
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4017
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3149
4018
>GMainLoop</a> **loop);</pre>
3150
4019
<p>
3151
4020
Call the method InspectHandles and run the main loop
3157
4026
<p>
3158
4027
Return a string representation for a number of handles of a given type.</p>
3159
4028
<p>
3160
3161
4029
</p>
3162
4030
<div class="variablelist"><table border="0">
3163
4031
<col align="left" valign="top">
3173
4041
</td>
3174
4042
</tr>
3175
4043
<tr>
3176
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4044
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3177
4045
<td> Used to pass an 'in' argument: The type of handle to be inspected
3178
4046
</td>
3179
4047
</tr>
3180
4048
<tr>
3181
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
4049
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3182
4050
<td> Used to pass an 'in' argument: An array of integer handles of this type
3183
4051
</td>
3184
4052
</tr>
3185
4053
<tr>
3186
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4054
<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
3187
4055
<td> Used to return an 'out' argument if <a
3188
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
4056
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3189
4057
><code class="literal">TRUE</code></a> is returned: An array of handle names in the same order as the given numbers
3190
4058
</td>
3191
4059
</tr>
3192
4060
<tr>
3193
4061
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3194
4062
<td> If not <a
3195
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4063
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3196
4064
><code class="literal">NULL</code></a>, used to return errors if <a
3197
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4065
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3198
4066
><code class="literal">FALSE</code></a>
3199
4067
is returned
3200
4068
</td>
3202
4070
<tr>
3203
4071
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3204
4072
<td> If not <a
3205
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4073
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3206
4074
><code class="literal">NULL</code></a>, set before re-entering
3207
4075
the main loop, to point to a <a
3208
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4076
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3209
4077
><span class="type">GMainLoop</span></a>
3210
4078
which can be used to cancel this call with
3211
4079
<a
3212
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4080
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3213
4081
><code class="function">g_main_loop_quit()</code></a>, causing a return of
3214
4082
<a
3215
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3216
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4083
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4084
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3217
4085
</td>
3218
4086
</tr>
3219
4087
<tr>
3230
4098
<pre class="programlisting">void (*tp_cli_connection_callback_for_list_channels)
3231
4099
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3232
4100
const <a
3233
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
3234
>GPtrArray</a> *out0,
4101
href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
4102
>GPtrArray</a> *out_Channel_Info,
3235
4103
const <a
3236
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4104
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3237
4105
>GError</a> *error,
3238
4106
<a
3239
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4107
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3240
4108
>gpointer</a> user_data,
3241
4109
<a
3242
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4110
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3243
4111
>GObject</a> *weak_object);</pre>
3244
4112
<p>
3245
4113
Signature of the callback called when a ListChannels method call
3246
4114
succeeds or fails.</p>
3247
4115
<p>
3248
3249
4116
</p>
3250
4117
<div class="variablelist"><table border="0">
3251
4118
<col align="left" valign="top">
3256
4123
</td>
3257
4124
</tr>
3258
4125
<tr>
3259
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4126
<td><p><span class="term"><em class="parameter"><code>out_Channel_Info</code></em> :</span></p></td>
3260
4127
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
3261
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4128
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3262
4129
><code class="literal">NULL</code></a>: An array of structs representing channels.
3263
4130
</td>
3264
4131
</tr>
3265
4132
<tr>
3266
4133
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3267
4134
<td> <a
3268
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4135
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3269
4136
><code class="literal">NULL</code></a> on success, or an error on failure
3270
4137
</td>
3271
4138
</tr>
3285
4152
<hr>
3286
4153
<div class="refsect2" lang="en">
3287
4154
<a name="tp-cli-connection-call-list-channels"></a><h3>tp_cli_connection_call_list_channels ()</h3>
3288
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_list_channels
4155
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_list_channels
3289
4156
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3290
4157
<a
3291
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4158
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3292
4159
>gint</a> timeout_ms,
3293
4160
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()">tp_cli_connection_callback_for_list_channels</a> callback,
3294
4161
<a
3295
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4162
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3296
4163
>gpointer</a> user_data,
3297
4164
<a
3298
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
4165
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
3299
4166
>GDestroyNotify</a> destroy,
3300
4167
<a
3301
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4168
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3302
4169
>GObject</a> *weak_object);</pre>
3303
4170
<p>
3304
4171
Start a ListChannels method call.
3306
4173
<p>
3307
4174
List all the channels which currently exist on this connection.</p>
3308
4175
<p>
3309
3310
4176
</p>
3311
4177
<div class="variablelist"><table border="0">
3312
4178
<col align="left" valign="top">
3326
4192
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3327
4193
<td> called when the method call succeeds or fails;
3328
4194
may be <a
3329
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4195
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3330
4196
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3331
4197
reply tracking
3332
4198
</td>
3335
4201
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3336
4202
<td> user-supplied data passed to the callback;
3337
4203
must be <a
3338
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4204
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3339
4205
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3340
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4206
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3341
4207
><code class="literal">NULL</code></a>
3342
4208
</td>
3343
4209
</tr>
3346
4212
<td> called with the user_data as argument, after the
3347
4213
call has succeeded, failed or been cancelled;
3348
4214
must be <a
3349
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4215
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3350
4216
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3351
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4217
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3352
4218
><code class="literal">NULL</code></a>
3353
4219
</td>
3354
4220
</tr>
3355
4221
<tr>
3356
4222
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3357
4223
<td> If not <a
3358
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4224
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3359
4225
><code class="literal">NULL</code></a>, a <a
3360
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4226
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3361
4227
><span class="type">GObject</span></a> which will be
3362
4228
weakly referenced; if it is destroyed, this call
3363
4229
will automatically be cancelled. Must be <a
3364
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4230
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3365
4231
><code class="literal">NULL</code></a> if
3366
4232
<em class="parameter"><code>callback</code></em> is <a
3367
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4233
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3368
4234
><code class="literal">NULL</code></a>
3369
4235
</td>
3370
4236
</tr>
3383
4249
<div class="refsect2" lang="en">
3384
4250
<a name="tp-cli-connection-run-list-channels"></a><h3>tp_cli_connection_run_list_channels ()</h3>
3385
4251
<pre class="programlisting"><a
3386
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
4252
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
3387
4253
>gboolean</a> tp_cli_connection_run_list_channels (<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3388
4254
<a
3389
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4255
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3390
4256
>gint</a> timeout_ms,
3391
4257
<a
3392
href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"
3393
>GPtrArray</a> **out0,
4258
href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
4259
>GPtrArray</a> **out_Channel_Info,
3394
4260
<a
3395
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4261
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3396
4262
>GError</a> **error,
3397
4263
<a
3398
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4264
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3399
4265
>GMainLoop</a> **loop);</pre>
3400
4266
<p>
3401
4267
Call the method ListChannels and run the main loop
3407
4273
<p>
3408
4274
List all the channels which currently exist on this connection.</p>
3409
4275
<p>
3410
3411
4276
</p>
3412
4277
<div class="variablelist"><table border="0">
3413
4278
<col align="left" valign="top">
3423
4288
</td>
3424
4289
</tr>
3425
4290
<tr>
3426
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4291
<td><p><span class="term"><em class="parameter"><code>out_Channel_Info</code></em> :</span></p></td>
3427
4292
<td> Used to return an 'out' argument if <a
3428
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
4293
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3429
4294
><code class="literal">TRUE</code></a> is returned: An array of structs representing channels.
3430
4295
</td>
3431
4296
</tr>
3432
4297
<tr>
3433
4298
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3434
4299
<td> If not <a
3435
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4300
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3436
4301
><code class="literal">NULL</code></a>, used to return errors if <a
3437
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4302
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3438
4303
><code class="literal">FALSE</code></a>
3439
4304
is returned
3440
4305
</td>
3442
4307
<tr>
3443
4308
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3444
4309
<td> If not <a
3445
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4310
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3446
4311
><code class="literal">NULL</code></a>, set before re-entering
3447
4312
the main loop, to point to a <a
3448
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4313
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3449
4314
><span class="type">GMainLoop</span></a>
3450
4315
which can be used to cancel this call with
3451
4316
<a
3452
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4317
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3453
4318
><code class="function">g_main_loop_quit()</code></a>, causing a return of
3454
4319
<a
3455
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3456
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4320
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4321
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3457
4322
</td>
3458
4323
</tr>
3459
4324
<tr>
3470
4335
<pre class="programlisting">void (*tp_cli_connection_callback_for_release_handles)
3471
4336
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3472
4337
const <a
3473
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4338
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3474
4339
>GError</a> *error,
3475
4340
<a
3476
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4341
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3477
4342
>gpointer</a> user_data,
3478
4343
<a
3479
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4344
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3480
4345
>GObject</a> *weak_object);</pre>
3481
4346
<p>
3482
4347
Signature of the callback called when a ReleaseHandles method call
3483
4348
succeeds or fails.</p>
3484
4349
<p>
3485
3486
4350
</p>
3487
4351
<div class="variablelist"><table border="0">
3488
4352
<col align="left" valign="top">
3495
4359
<tr>
3496
4360
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3497
4361
<td> <a
3498
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4362
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3499
4363
><code class="literal">NULL</code></a> on success, or an error on failure
3500
4364
</td>
3501
4365
</tr>
3515
4379
<hr>
3516
4380
<div class="refsect2" lang="en">
3517
4381
<a name="tp-cli-connection-call-release-handles"></a><h3>tp_cli_connection_call_release_handles ()</h3>
3518
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_release_handles
4382
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_release_handles
3519
4383
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3520
4384
<a
3521
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4385
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3522
4386
>gint</a> timeout_ms,
3523
4387
<a
3524
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3525
>guint</a> in_handle_type,
4388
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4389
>guint</a> in_Handle_Type,
3526
4390
const <a
3527
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
3528
>GArray</a> *in_handles,
4391
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
4392
>GArray</a> *in_Handles,
3529
4393
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()">tp_cli_connection_callback_for_release_handles</a> callback,
3530
4394
<a
3531
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4395
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3532
4396
>gpointer</a> user_data,
3533
4397
<a
3534
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
4398
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
3535
4399
>GDestroyNotify</a> destroy,
3536
4400
<a
3537
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4401
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3538
4402
>GObject</a> *weak_object);</pre>
3539
4403
<p>
3540
4404
Start a ReleaseHandles method call.
3542
4406
<p>
3543
4407
Explicitly notify the connection manager that your client is no longer holding any references to the given handles, and that they may be deallocated if they are not held by any other clients or referenced by any existing channels. See HoldHandles for notes.</p>
3544
4408
<p>
3545
3546
4409
</p>
3547
4410
<div class="variablelist"><table border="0">
3548
4411
<col align="left" valign="top">
3559
4422
</td>
3560
4423
</tr>
3561
4424
<tr>
3562
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4425
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3563
4426
<td> Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
3564
4427
</td>
3565
4428
</tr>
3566
4429
<tr>
3567
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
4430
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3568
4431
<td> Used to pass an 'in' argument: An array of integer handles being held by the client
3569
4432
</td>
3570
4433
</tr>
3572
4435
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3573
4436
<td> called when the method call succeeds or fails;
3574
4437
may be <a
3575
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4438
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3576
4439
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3577
4440
reply tracking
3578
4441
</td>
3581
4444
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3582
4445
<td> user-supplied data passed to the callback;
3583
4446
must be <a
3584
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4447
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3585
4448
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3586
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4449
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3587
4450
><code class="literal">NULL</code></a>
3588
4451
</td>
3589
4452
</tr>
3592
4455
<td> called with the user_data as argument, after the
3593
4456
call has succeeded, failed or been cancelled;
3594
4457
must be <a
3595
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4458
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3596
4459
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3597
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4460
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3598
4461
><code class="literal">NULL</code></a>
3599
4462
</td>
3600
4463
</tr>
3601
4464
<tr>
3602
4465
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3603
4466
<td> If not <a
3604
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4467
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3605
4468
><code class="literal">NULL</code></a>, a <a
3606
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4469
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3607
4470
><span class="type">GObject</span></a> which will be
3608
4471
weakly referenced; if it is destroyed, this call
3609
4472
will automatically be cancelled. Must be <a
3610
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4473
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3611
4474
><code class="literal">NULL</code></a> if
3612
4475
<em class="parameter"><code>callback</code></em> is <a
3613
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4476
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3614
4477
><code class="literal">NULL</code></a>
3615
4478
</td>
3616
4479
</tr>
3629
4492
<div class="refsect2" lang="en">
3630
4493
<a name="tp-cli-connection-run-release-handles"></a><h3>tp_cli_connection_run_release_handles ()</h3>
3631
4494
<pre class="programlisting"><a
3632
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
4495
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
3633
4496
>gboolean</a> tp_cli_connection_run_release_handles
3634
4497
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3635
4498
<a
3636
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4499
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3637
4500
>gint</a> timeout_ms,
3638
4501
<a
3639
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3640
>guint</a> in_handle_type,
4502
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4503
>guint</a> in_Handle_Type,
3641
4504
const <a
3642
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
3643
>GArray</a> *in_handles,
4505
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
4506
>GArray</a> *in_Handles,
3644
4507
<a
3645
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4508
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3646
4509
>GError</a> **error,
3647
4510
<a
3648
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4511
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3649
4512
>GMainLoop</a> **loop);</pre>
3650
4513
<p>
3651
4514
Call the method ReleaseHandles and run the main loop
3657
4520
<p>
3658
4521
Explicitly notify the connection manager that your client is no longer holding any references to the given handles, and that they may be deallocated if they are not held by any other clients or referenced by any existing channels. See HoldHandles for notes.</p>
3659
4522
<p>
3660
3661
4523
</p>
3662
4524
<div class="variablelist"><table border="0">
3663
4525
<col align="left" valign="top">
3673
4535
</td>
3674
4536
</tr>
3675
4537
<tr>
3676
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4538
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3677
4539
<td> Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
3678
4540
</td>
3679
4541
</tr>
3680
4542
<tr>
3681
<td><p><span class="term"><em class="parameter"><code>in_handles</code></em> :</span></p></td>
4543
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3682
4544
<td> Used to pass an 'in' argument: An array of integer handles being held by the client
3683
4545
</td>
3684
4546
</tr>
3685
4547
<tr>
3686
4548
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3687
4549
<td> If not <a
3688
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4550
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3689
4551
><code class="literal">NULL</code></a>, used to return errors if <a
3690
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4552
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3691
4553
><code class="literal">FALSE</code></a>
3692
4554
is returned
3693
4555
</td>
3695
4557
<tr>
3696
4558
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3697
4559
<td> If not <a
3698
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4560
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3699
4561
><code class="literal">NULL</code></a>, set before re-entering
3700
4562
the main loop, to point to a <a
3701
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4563
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3702
4564
><span class="type">GMainLoop</span></a>
3703
4565
which can be used to cancel this call with
3704
4566
<a
3705
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4567
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
3706
4568
><code class="function">g_main_loop_quit()</code></a>, causing a return of
3707
4569
<a
3708
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
3709
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4570
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4571
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3710
4572
</td>
3711
4573
</tr>
3712
4574
<tr>
3723
4585
<pre class="programlisting">void (*tp_cli_connection_callback_for_request_channel)
3724
4586
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3725
4587
const <a
3726
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
3727
>gchar</a> *out0,
4588
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4589
>gchar</a> *out_Object_Path,
3728
4590
const <a
3729
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4591
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3730
4592
>GError</a> *error,
3731
4593
<a
3732
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4594
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3733
4595
>gpointer</a> user_data,
3734
4596
<a
3735
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4597
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3736
4598
>GObject</a> *weak_object);</pre>
3737
4599
<p>
3738
4600
Signature of the callback called when a RequestChannel method call
3739
4601
succeeds or fails.</p>
3740
4602
<p>
3741
3742
4603
</p>
3743
4604
<div class="variablelist"><table border="0">
3744
4605
<col align="left" valign="top">
3749
4610
</td>
3750
4611
</tr>
3751
4612
<tr>
3752
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4613
<td><p><span class="term"><em class="parameter"><code>out_Object_Path</code></em> :</span></p></td>
3753
4614
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
3754
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4615
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3755
4616
><code class="literal">NULL</code></a>: The D-Bus object path for the channel created or retrieved
3756
4617
</td>
3757
4618
</tr>
3758
4619
<tr>
3759
4620
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3760
4621
<td> <a
3761
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4622
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3762
4623
><code class="literal">NULL</code></a> on success, or an error on failure
3763
4624
</td>
3764
4625
</tr>
3778
4639
<hr>
3779
4640
<div class="refsect2" lang="en">
3780
4641
<a name="tp-cli-connection-call-request-channel"></a><h3>tp_cli_connection_call_request_channel ()</h3>
3781
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_request_channel
4642
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_request_channel
3782
4643
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3783
4644
<a
3784
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4645
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3785
4646
>gint</a> timeout_ms,
3786
4647
const <a
3787
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
3788
>gchar</a> *in_type,
3789
<a
3790
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3791
>guint</a> in_handle_type,
3792
<a
3793
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3794
>guint</a> in_handle,
3795
<a
3796
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3797
>gboolean</a> in_suppress_handler,
4648
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4649
>gchar</a> *in_Type,
4650
<a
4651
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4652
>guint</a> in_Handle_Type,
4653
<a
4654
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4655
>guint</a> in_Handle,
4656
<a
4657
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
4658
>gboolean</a> in_Suppress_Handler,
3798
4659
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()">tp_cli_connection_callback_for_request_channel</a> callback,
3799
4660
<a
3800
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4661
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
3801
4662
>gpointer</a> user_data,
3802
4663
<a
3803
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
4664
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
3804
4665
>GDestroyNotify</a> destroy,
3805
4666
<a
3806
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4667
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3807
4668
>GObject</a> *weak_object);</pre>
3808
4669
<p>
3809
4670
Start a RequestChannel method call.
3810
4671
</p>
3811
4672
<p>
3812
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Request a channel satisfying the specified type and communicating with the contact, room, list etc. indicated by the given handle_type and handle. The handle_type and handle may both be zero to request the creation of a new, empty channel, which may or may not be possible, depending on the protocol and channel type.</p> <p>On success, the returned channel will always be of the requested type (i.e. implement the requested channel-type interface).</p> <p>If a new, empty channel is requested, on success the returned channel will always be an &quot;anonymous&quot; channel for which the type and handle are both zero.</p> <p>If a channel to a contact, room etc. is requested, on success, the returned channel may either be a new or existing channel to the requested entity (i.e. its <code class="function">GetHandle()</code> returns the requested handle type and handle), or a newly created &quot;anonymous&quot; channel associated with the requested handle in some implementation-specific way.</p> <p>For example, for a contact handle, the returned channel might be &quot;anonymous&quot;, but implement the groups interface and have the requested contact already present among the members.</p> <p>If the request cannot be satisfied, an error is raised and no channel is created.</p></p>
4673
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Request a channel satisfying the specified type and communicating with the contact, room, list etc. indicated by the given handle_type and handle. The handle_type and handle may both be zero to request the creation of a new, empty channel, which may or may not be possible, depending on the protocol and channel type.</p> <p>On success, the returned channel will always be of the requested type (i.e. implement the requested channel-type interface).</p> <p>If a new, empty channel is requested, on success the returned channel will always be an &quot;anonymous&quot; channel for which the type and handle are both zero.</p> <p>If a channel to a contact, room etc. is requested, on success, the returned channel may either be a new or existing channel to the requested entity (i.e. its <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel">TargetHandleType</tp:dbus-ref> and <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel">TargetHandle</tp:dbus-ref> properties are the requested handle type and handle), or a newly created &quot;anonymous&quot; channel associated with the requested handle in some implementation-specific way.</p> <p>For example, for a contact handle, the returned channel might be &quot;anonymous&quot;, but implement the groups interface and have the requested contact already present among the members.</p> <p>If the request cannot be satisfied, an error is raised and no channel is created.</p></p>
3813
4674
<p>
3814
3815
4675
</p>
3816
4676
<div class="variablelist"><table border="0">
3817
4677
<col align="left" valign="top">
3828
4688
</td>
3829
4689
</tr>
3830
4690
<tr>
3831
<td><p><span class="term"><em class="parameter"><code>in_type</code></em> :</span></p></td>
4691
<td><p><span class="term"><em class="parameter"><code>in_Type</code></em> :</span></p></td>
3832
4692
<td> Used to pass an 'in' argument: A D-Bus interface name representing base channel type
3833
4693
</td>
3834
4694
</tr>
3835
4695
<tr>
3836
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4696
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3837
4697
<td> Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if no handle is specified
3838
4698
</td>
3839
4699
</tr>
3840
4700
<tr>
3841
<td><p><span class="term"><em class="parameter"><code>in_handle</code></em> :</span></p></td>
4701
<td><p><span class="term"><em class="parameter"><code>in_Handle</code></em> :</span></p></td>
3842
4702
<td> Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc. according to handle_type, or zero if the handle_type is Handle_Type_None
3843
4703
</td>
3844
4704
</tr>
3845
4705
<tr>
3846
<td><p><span class="term"><em class="parameter"><code>in_suppress_handler</code></em> :</span></p></td>
3847
<td> Used to pass an 'in' argument: If true, the requesting client intends to take responsibility for displaying the channel to the user, so no other handler needs to be launched
4706
<td><p><span class="term"><em class="parameter"><code>in_Suppress_Handler</code></em> :</span></p></td>
4707
<td> Used to pass an 'in' argument: <p>Clients SHOULD always set this to true.</p> <tp:rationale> <p>The historical meaning was that clients that did not intend to take responsibility for displaying the channel to the user could set this to FALSE, in which case the channel dispatcher would launch an appropriate channel handler.</p> <p>However, clients whose functionality relies on having a working channel dispatcher should obtain that functionality by calling methods on the channel dispatcher, so that they will get an appropriate error if the channel dispatcher is missing or not working.</p> <p>The channel dispatcher itself should set this to true too, so that it will ignore the <tp:member-ref>NewChannel</tp:member-ref> signal that results from the creation of the channel. It can then dispatch the channel returned from this method to an appropriate handler.</p> <p>So, there is no sensible use-case for setting this to false, and setting it to false can result in unhandled channels (in the case where clients assume that a channel dispatcher is present, but it isn't).</p> </tp:rationale>
3848
4708
</td>
3849
4709
</tr>
3850
4710
<tr>
3851
4711
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3852
4712
<td> called when the method call succeeds or fails;
3853
4713
may be <a
3854
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4714
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3855
4715
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3856
4716
reply tracking
3857
4717
</td>
3860
4720
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3861
4721
<td> user-supplied data passed to the callback;
3862
4722
must be <a
3863
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4723
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3864
4724
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3865
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4725
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3866
4726
><code class="literal">NULL</code></a>
3867
4727
</td>
3868
4728
</tr>
3871
4731
<td> called with the user_data as argument, after the
3872
4732
call has succeeded, failed or been cancelled;
3873
4733
must be <a
3874
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4734
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3875
4735
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
3876
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4736
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3877
4737
><code class="literal">NULL</code></a>
3878
4738
</td>
3879
4739
</tr>
3880
4740
<tr>
3881
4741
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3882
4742
<td> If not <a
3883
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4743
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3884
4744
><code class="literal">NULL</code></a>, a <a
3885
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4745
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
3886
4746
><span class="type">GObject</span></a> which will be
3887
4747
weakly referenced; if it is destroyed, this call
3888
4748
will automatically be cancelled. Must be <a
3889
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4749
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3890
4750
><code class="literal">NULL</code></a> if
3891
4751
<em class="parameter"><code>callback</code></em> is <a
3892
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4752
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3893
4753
><code class="literal">NULL</code></a>
3894
4754
</td>
3895
4755
</tr>
3908
4768
<div class="refsect2" lang="en">
3909
4769
<a name="tp-cli-connection-run-request-channel"></a><h3>tp_cli_connection_run_request_channel ()</h3>
3910
4770
<pre class="programlisting"><a
3911
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
4771
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
3912
4772
>gboolean</a> tp_cli_connection_run_request_channel
3913
4773
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
3914
4774
<a
3915
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4775
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
3916
4776
>gint</a> timeout_ms,
3917
4777
const <a
3918
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
3919
>gchar</a> *in_type,
3920
<a
3921
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3922
>guint</a> in_handle_type,
3923
<a
3924
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
3925
>guint</a> in_handle,
3926
<a
3927
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
3928
>gboolean</a> in_suppress_handler,
3929
<a
3930
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
3931
>gchar</a> **out0,
3932
<a
3933
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4778
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4779
>gchar</a> *in_Type,
4780
<a
4781
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4782
>guint</a> in_Handle_Type,
4783
<a
4784
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4785
>guint</a> in_Handle,
4786
<a
4787
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
4788
>gboolean</a> in_Suppress_Handler,
4789
<a
4790
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4791
>gchar</a> **out_Object_Path,
4792
<a
4793
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
3934
4794
>GError</a> **error,
3935
4795
<a
3936
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4796
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
3937
4797
>GMainLoop</a> **loop);</pre>
3938
4798
<p>
3939
4799
Call the method RequestChannel and run the main loop
3943
4803
state.
3944
4804
</p>
3945
4805
<p>
3946
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Request a channel satisfying the specified type and communicating with the contact, room, list etc. indicated by the given handle_type and handle. The handle_type and handle may both be zero to request the creation of a new, empty channel, which may or may not be possible, depending on the protocol and channel type.</p> <p>On success, the returned channel will always be of the requested type (i.e. implement the requested channel-type interface).</p> <p>If a new, empty channel is requested, on success the returned channel will always be an &quot;anonymous&quot; channel for which the type and handle are both zero.</p> <p>If a channel to a contact, room etc. is requested, on success, the returned channel may either be a new or existing channel to the requested entity (i.e. its <code class="function">GetHandle()</code> returns the requested handle type and handle), or a newly created &quot;anonymous&quot; channel associated with the requested handle in some implementation-specific way.</p> <p>For example, for a contact handle, the returned channel might be &quot;anonymous&quot;, but implement the groups interface and have the requested contact already present among the members.</p> <p>If the request cannot be satisfied, an error is raised and no channel is created.</p></p>
4806
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Request a channel satisfying the specified type and communicating with the contact, room, list etc. indicated by the given handle_type and handle. The handle_type and handle may both be zero to request the creation of a new, empty channel, which may or may not be possible, depending on the protocol and channel type.</p> <p>On success, the returned channel will always be of the requested type (i.e. implement the requested channel-type interface).</p> <p>If a new, empty channel is requested, on success the returned channel will always be an &quot;anonymous&quot; channel for which the type and handle are both zero.</p> <p>If a channel to a contact, room etc. is requested, on success, the returned channel may either be a new or existing channel to the requested entity (i.e. its <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel">TargetHandleType</tp:dbus-ref> and <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel">TargetHandle</tp:dbus-ref> properties are the requested handle type and handle), or a newly created &quot;anonymous&quot; channel associated with the requested handle in some implementation-specific way.</p> <p>For example, for a contact handle, the returned channel might be &quot;anonymous&quot;, but implement the groups interface and have the requested contact already present among the members.</p> <p>If the request cannot be satisfied, an error is raised and no channel is created.</p></p>
3947
4807
<p>
3948
3949
4808
</p>
3950
4809
<div class="variablelist"><table border="0">
3951
4810
<col align="left" valign="top">
3961
4820
</td>
3962
4821
</tr>
3963
4822
<tr>
3964
<td><p><span class="term"><em class="parameter"><code>in_type</code></em> :</span></p></td>
4823
<td><p><span class="term"><em class="parameter"><code>in_Type</code></em> :</span></p></td>
3965
4824
<td> Used to pass an 'in' argument: A D-Bus interface name representing base channel type
3966
4825
</td>
3967
4826
</tr>
3968
4827
<tr>
3969
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4828
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3970
4829
<td> Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if no handle is specified
3971
4830
</td>
3972
4831
</tr>
3973
4832
<tr>
3974
<td><p><span class="term"><em class="parameter"><code>in_handle</code></em> :</span></p></td>
4833
<td><p><span class="term"><em class="parameter"><code>in_Handle</code></em> :</span></p></td>
3975
4834
<td> Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc. according to handle_type, or zero if the handle_type is Handle_Type_None
3976
4835
</td>
3977
4836
</tr>
3978
4837
<tr>
3979
<td><p><span class="term"><em class="parameter"><code>in_suppress_handler</code></em> :</span></p></td>
3980
<td> Used to pass an 'in' argument: If true, the requesting client intends to take responsibility for displaying the channel to the user, so no other handler needs to be launched
4838
<td><p><span class="term"><em class="parameter"><code>in_Suppress_Handler</code></em> :</span></p></td>
4839
<td> Used to pass an 'in' argument: <p>Clients SHOULD always set this to true.</p> <tp:rationale> <p>The historical meaning was that clients that did not intend to take responsibility for displaying the channel to the user could set this to FALSE, in which case the channel dispatcher would launch an appropriate channel handler.</p> <p>However, clients whose functionality relies on having a working channel dispatcher should obtain that functionality by calling methods on the channel dispatcher, so that they will get an appropriate error if the channel dispatcher is missing or not working.</p> <p>The channel dispatcher itself should set this to true too, so that it will ignore the <tp:member-ref>NewChannel</tp:member-ref> signal that results from the creation of the channel. It can then dispatch the channel returned from this method to an appropriate handler.</p> <p>So, there is no sensible use-case for setting this to false, and setting it to false can result in unhandled channels (in the case where clients assume that a channel dispatcher is present, but it isn't).</p> </tp:rationale>
3981
4840
</td>
3982
4841
</tr>
3983
4842
<tr>
3984
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4843
<td><p><span class="term"><em class="parameter"><code>out_Object_Path</code></em> :</span></p></td>
3985
4844
<td> Used to return an 'out' argument if <a
3986
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
4845
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
3987
4846
><code class="literal">TRUE</code></a> is returned: The D-Bus object path for the channel created or retrieved
3988
4847
</td>
3989
4848
</tr>
3990
4849
<tr>
3991
4850
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3992
4851
<td> If not <a
3993
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4852
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
3994
4853
><code class="literal">NULL</code></a>, used to return errors if <a
3995
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4854
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
3996
4855
><code class="literal">FALSE</code></a>
3997
4856
is returned
3998
4857
</td>
4000
4859
<tr>
4001
4860
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
4002
4861
<td> If not <a
4003
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4862
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4004
4863
><code class="literal">NULL</code></a>, set before re-entering
4005
4864
the main loop, to point to a <a
4006
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
4865
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
4007
4866
><span class="type">GMainLoop</span></a>
4008
4867
which can be used to cancel this call with
4009
4868
<a
4010
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4869
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4011
4870
><code class="function">g_main_loop_quit()</code></a>, causing a return of
4012
4871
<a
4013
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4014
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4872
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4873
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4015
4874
</td>
4016
4875
</tr>
4017
4876
<tr>
4028
4887
<pre class="programlisting">void (*tp_cli_connection_callback_for_request_handles)
4029
4888
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4030
4889
const <a
4031
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
4032
>GArray</a> *out0,
4890
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
4891
>GArray</a> *out_Handles,
4033
4892
const <a
4034
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
4893
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
4035
4894
>GError</a> *error,
4036
4895
<a
4037
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4896
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4038
4897
>gpointer</a> user_data,
4039
4898
<a
4040
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4899
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4041
4900
>GObject</a> *weak_object);</pre>
4042
4901
<p>
4043
4902
Signature of the callback called when a RequestHandles method call
4044
4903
succeeds or fails.</p>
4045
4904
<p>
4046
4047
4905
</p>
4048
4906
<div class="variablelist"><table border="0">
4049
4907
<col align="left" valign="top">
4054
4912
</td>
4055
4913
</tr>
4056
4914
<tr>
4057
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
4915
<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
4058
4916
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
4059
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4917
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4060
4918
><code class="literal">NULL</code></a>: An array of integer handle numbers in the same order as the given strings
4061
4919
</td>
4062
4920
</tr>
4063
4921
<tr>
4064
4922
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4065
4923
<td> <a
4066
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4924
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4067
4925
><code class="literal">NULL</code></a> on success, or an error on failure
4068
4926
</td>
4069
4927
</tr>
4083
4941
<hr>
4084
4942
<div class="refsect2" lang="en">
4085
4943
<a name="tp-cli-connection-call-request-handles"></a><h3>tp_cli_connection_call_request_handles ()</h3>
4086
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a>* tp_cli_connection_call_request_handles
4944
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_connection_call_request_handles
4087
4945
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4088
4946
<a
4089
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
4947
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
4090
4948
>gint</a> timeout_ms,
4091
4949
<a
4092
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4093
>guint</a> in_handle_type,
4950
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4951
>guint</a> in_Handle_Type,
4094
4952
const <a
4095
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
4096
>gchar</a> **in_names,
4953
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
4954
>gchar</a> **in_Names,
4097
4955
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">tp_cli_connection_callback_for_request_handles</a> callback,
4098
4956
<a
4099
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
4957
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4100
4958
>gpointer</a> user_data,
4101
4959
<a
4102
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
4960
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
4103
4961
>GDestroyNotify</a> destroy,
4104
4962
<a
4105
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4963
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4106
4964
>GObject</a> *weak_object);</pre>
4107
4965
<p>
4108
4966
Start a RequestHandles method call.
4109
4967
</p>
4110
4968
<p>
4111
Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the ReleaseHandle method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
4969
Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
4112
4970
<p>
4113
4114
4971
</p>
4115
4972
<div class="variablelist"><table border="0">
4116
4973
<col align="left" valign="top">
4127
4984
</td>
4128
4985
</tr>
4129
4986
<tr>
4130
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
4987
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
4131
4988
<td> Used to pass an 'in' argument: The type of handle required
4132
4989
</td>
4133
4990
</tr>
4134
4991
<tr>
4135
<td><p><span class="term"><em class="parameter"><code>in_names</code></em> :</span></p></td>
4992
<td><p><span class="term"><em class="parameter"><code>in_Names</code></em> :</span></p></td>
4136
4993
<td> Used to pass an 'in' argument: An array of names of entities to request handles for
4137
4994
</td>
4138
4995
</tr>
4140
4997
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4141
4998
<td> called when the method call succeeds or fails;
4142
4999
may be <a
4143
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5000
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4144
5001
><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4145
5002
reply tracking
4146
5003
</td>
4149
5006
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4150
5007
<td> user-supplied data passed to the callback;
4151
5008
must be <a
4152
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5009
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4153
5010
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
4154
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5011
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4155
5012
><code class="literal">NULL</code></a>
4156
5013
</td>
4157
5014
</tr>
4160
5017
<td> called with the user_data as argument, after the
4161
5018
call has succeeded, failed or been cancelled;
4162
5019
must be <a
4163
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5020
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4164
5021
><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
4165
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5022
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4166
5023
><code class="literal">NULL</code></a>
4167
5024
</td>
4168
5025
</tr>
4169
5026
<tr>
4170
5027
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
4171
5028
<td> If not <a
4172
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5029
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4173
5030
><code class="literal">NULL</code></a>, a <a
4174
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
5031
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4175
5032
><span class="type">GObject</span></a> which will be
4176
5033
weakly referenced; if it is destroyed, this call
4177
5034
will automatically be cancelled. Must be <a
4178
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5035
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4179
5036
><code class="literal">NULL</code></a> if
4180
5037
<em class="parameter"><code>callback</code></em> is <a
4181
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5038
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4182
5039
><code class="literal">NULL</code></a>
4183
5040
</td>
4184
5041
</tr>
4197
5054
<div class="refsect2" lang="en">
4198
5055
<a name="tp-cli-connection-run-request-handles"></a><h3>tp_cli_connection_run_request_handles ()</h3>
4199
5056
<pre class="programlisting"><a
4200
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
5057
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
4201
5058
>gboolean</a> tp_cli_connection_run_request_handles
4202
5059
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4203
5060
<a
4204
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
5061
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
4205
5062
>gint</a> timeout_ms,
4206
5063
<a
4207
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4208
>guint</a> in_handle_type,
5064
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5065
>guint</a> in_Handle_Type,
4209
5066
const <a
4210
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
4211
>gchar</a> **in_names,
4212
<a
4213
href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"
4214
>GArray</a> **out0,
4215
<a
4216
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
5067
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
5068
>gchar</a> **in_Names,
5069
<a
5070
href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"
5071
>GArray</a> **out_Handles,
5072
<a
5073
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
4217
5074
>GError</a> **error,
4218
5075
<a
4219
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
5076
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
4220
5077
>GMainLoop</a> **loop);</pre>
4221
5078
<p>
4222
5079
Call the method RequestHandles and run the main loop
4226
5083
state.
4227
5084
</p>
4228
5085
<p>
4229
Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the ReleaseHandle method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
5086
Request several handles from the connection manager which represent a number of contacts, rooms or server-stored lists on the service. The connection manager should record that these handles are in use by the client who invokes this method, and must not deallocate the handles until the client disconnects from the bus or calls the <tp:member-ref>ReleaseHandles</tp:member-ref> method. Where the name refers to an entity that already has a handle in this connection manager, this handle should be returned instead. The handle number 0 must not be returned by the connection manager.</p>
4230
5087
<p>
4231
4232
5088
</p>
4233
5089
<div class="variablelist"><table border="0">
4234
5090
<col align="left" valign="top">
4244
5100
</td>
4245
5101
</tr>
4246
5102
<tr>
4247
<td><p><span class="term"><em class="parameter"><code>in_handle_type</code></em> :</span></p></td>
5103
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
4248
5104
<td> Used to pass an 'in' argument: The type of handle required
4249
5105
</td>
4250
5106
</tr>
4251
5107
<tr>
4252
<td><p><span class="term"><em class="parameter"><code>in_names</code></em> :</span></p></td>
5108
<td><p><span class="term"><em class="parameter"><code>in_Names</code></em> :</span></p></td>
4253
5109
<td> Used to pass an 'in' argument: An array of names of entities to request handles for
4254
5110
</td>
4255
5111
</tr>
4256
5112
<tr>
4257
<td><p><span class="term"><em class="parameter"><code>out0</code></em> :</span></p></td>
5113
<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
4258
5114
<td> Used to return an 'out' argument if <a
4259
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
5115
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
4260
5116
><code class="literal">TRUE</code></a> is returned: An array of integer handle numbers in the same order as the given strings
4261
5117
</td>
4262
5118
</tr>
4263
5119
<tr>
4264
5120
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4265
5121
<td> If not <a
4266
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5122
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4267
5123
><code class="literal">NULL</code></a>, used to return errors if <a
4268
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
5124
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4269
5125
><code class="literal">FALSE</code></a>
4270
5126
is returned
4271
5127
</td>
4273
5129
<tr>
4274
5130
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
4275
5131
<td> If not <a
4276
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5132
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4277
5133
><code class="literal">NULL</code></a>, set before re-entering
4278
5134
the main loop, to point to a <a
4279
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"
5135
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
4280
5136
><span class="type">GMainLoop</span></a>
4281
5137
which can be used to cancel this call with
4282
5138
<a
4283
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"
5139
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"
4284
5140
><code class="function">g_main_loop_quit()</code></a>, causing a return of
4285
5141
<a
4286
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
4287
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
5142
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
5143
><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED--CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
4288
5144
</td>
4289
5145
</tr>
4290
5146
<tr>
4301
5157
<pre class="programlisting">void (*tp_cli_connection_signal_callback_new_channel)
4302
5158
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4303
5159
const <a
4304
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
4305
>gchar</a> *arg_object_path,
5160
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
5161
>gchar</a> *arg_Object_Path,
4306
5162
const <a
4307
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
4308
>gchar</a> *arg_channel_type,
4309
<a
4310
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4311
>guint</a> arg_handle_type,
4312
<a
4313
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4314
>guint</a> arg_handle,
4315
<a
4316
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
4317
>gboolean</a> arg_suppress_handler,
4318
<a
4319
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
5163
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
5164
>gchar</a> *arg_Channel_Type,
5165
<a
5166
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5167
>guint</a> arg_Handle_Type,
5168
<a
5169
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5170
>guint</a> arg_Handle,
5171
<a
5172
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
5173
>gboolean</a> arg_Suppress_Handler,
5174
<a
5175
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4320
5176
>gpointer</a> user_data,
4321
5177
<a
4322
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
5178
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4323
5179
>GObject</a> *weak_object);</pre>
4324
5180
<p>
4325
5181
Represents the signature of a callback for the signal NewChannel.</p>
4326
5182
<p>
4327
4328
5183
</p>
4329
5184
<div class="variablelist"><table border="0">
4330
5185
<col align="left" valign="top">
4336
5191
</td>
4337
5192
</tr>
4338
5193
<tr>
4339
<td><p><span class="term"><em class="parameter"><code>arg_object_path</code></em> :</span></p></td>
5194
<td><p><span class="term"><em class="parameter"><code>arg_Object_Path</code></em> :</span></p></td>
4340
5195
<td> A D-Bus object path for the channel object on this service
4341
5196
</td>
4342
5197
</tr>
4343
5198
<tr>
4344
<td><p><span class="term"><em class="parameter"><code>arg_channel_type</code></em> :</span></p></td>
5199
<td><p><span class="term"><em class="parameter"><code>arg_Channel_Type</code></em> :</span></p></td>
4345
5200
<td> A D-Bus interface name representing the channel type
4346
5201
</td>
4347
5202
</tr>
4348
5203
<tr>
4349
<td><p><span class="term"><em class="parameter"><code>arg_handle_type</code></em> :</span></p></td>
5204
<td><p><span class="term"><em class="parameter"><code>arg_Handle_Type</code></em> :</span></p></td>
4350
5205
<td> An integer representing the type of handle this channel communicates with, or Handle_Type_None if no handle is specified
4351
5206
</td>
4352
5207
</tr>
4353
5208
<tr>
4354
<td><p><span class="term"><em class="parameter"><code>arg_handle</code></em> :</span></p></td>
5209
<td><p><span class="term"><em class="parameter"><code>arg_Handle</code></em> :</span></p></td>
4355
5210
<td> A handle indicating the specific contact, room or list this channel communicates with, or zero if no handle is specified
4356
5211
</td>
4357
5212
</tr>
4358
5213
<tr>
4359
<td><p><span class="term"><em class="parameter"><code>arg_suppress_handler</code></em> :</span></p></td>
4360
<td> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If true, the channel was requested by a client that intends to present it to the user itself (i.e. it passed suppress_handler=TRUE to the RequestChannel method), so no other handler should be launched.</p> <p>If false, either the channel was created due to incoming information from the service, or the channel was requested by a local client that does not intend to handle the channel itself (a typical use-case is an address-book viewer that does not itself implement chat or VoIP functionality, starting a channel that will be handled by the same user interface that would handle incoming channels).</p> <p>Clients MUST NOT assume that only incoming channels will have this flag set to false.</p>
5214
<td><p><span class="term"><em class="parameter"><code>arg_Suppress_Handler</code></em> :</span></p></td>
5215
<td> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If true, the channel was requested by a client that intends to present it to the user itself (i.e. it passed suppress_handler=TRUE to the <tp:member-ref>RequestChannel</tp:member-ref> method), so no other handler should be launched. Clients MAY assume that channels where this is true were created by a user request.</p> <p>If false, either the channel was created due to incoming information from the service, or the channel was requested by a local client that does not intend to handle the channel itself (this usage is deprecated).</p> <p>Clients MUST NOT assume that only incoming channels will have this flag set to false.</p>
4361
5216
</td>
4362
5217
</tr>
4363
5218
<tr>
4376
5231
<hr>
4377
5232
<div class="refsect2" lang="en">
4378
5233
<a name="tp-cli-connection-connect-to-new-channel"></a><h3>tp_cli_connection_connect_to_new_channel ()</h3>
4379
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a>* tp_cli_connection_connect_to_new_channel
5234
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_connect_to_new_channel
4380
5235
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4381
5236
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()">tp_cli_connection_signal_callback_new_channel</a> callback,
4382
5237
<a
4383
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
5238
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4384
5239
>gpointer</a> user_data,
4385
5240
<a
4386
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
5241
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
4387
5242
>GDestroyNotify</a> destroy,
4388
5243
<a
4389
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
5244
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4390
5245
>GObject</a> *weak_object,
4391
5246
<a
4392
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
5247
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
4393
5248
>GError</a> **error);</pre>
4394
5249
<p>
4395
5250
Connect a handler to the signal NewChannel.
4397
5252
<p>
4398
5253
Emitted when a new Channel object is created, either through user request or incoming information from the service.</p>
4399
5254
<p>
4400
4401
</p>
4402
<div class="variablelist"><table border="0">
4403
<col align="left" valign="top">
4404
<tbody>
4405
<tr>
4406
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
4407
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
4408
</td>
4409
</tr>
4410
<tr>
4411
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4412
<td> Callback to be called when the signal is
4413
received
4414
</td>
4415
</tr>
4416
<tr>
4417
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4418
<td> User-supplied data for the callback
4419
</td>
4420
</tr>
4421
<tr>
4422
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
4423
<td> Destructor for the user-supplied data, which
4424
will be called when this signal is disconnected, or
4425
before this function returns <a
4426
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4427
><code class="literal">NULL</code></a>
4428
</td>
4429
</tr>
4430
<tr>
4431
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
4432
<td> A <a
4433
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4434
><span class="type">GObject</span></a> which will be weakly referenced;
4435
if it is destroyed, this callback will automatically be
4436
disconnected
4437
</td>
4438
</tr>
4439
<tr>
4440
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4441
<td> If not <a
4442
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4443
><code class="literal">NULL</code></a>, used to raise an error if <a
4444
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4445
><code class="literal">NULL</code></a> is
4446
returned
4447
</td>
4448
</tr>
4449
<tr>
4450
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4451
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4452
above, which can be used to disconnect the signal; or
4453
<a
4454
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5255
</p>
5256
<div class="variablelist"><table border="0">
5257
<col align="left" valign="top">
5258
<tbody>
5259
<tr>
5260
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5261
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
5262
</td>
5263
</tr>
5264
<tr>
5265
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5266
<td> Callback to be called when the signal is
5267
received
5268
</td>
5269
</tr>
5270
<tr>
5271
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5272
<td> User-supplied data for the callback
5273
</td>
5274
</tr>
5275
<tr>
5276
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
5277
<td> Destructor for the user-supplied data, which
5278
will be called when this signal is disconnected, or
5279
before this function returns <a
5280
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5281
><code class="literal">NULL</code></a>
5282
</td>
5283
</tr>
5284
<tr>
5285
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5286
<td> A <a
5287
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5288
><span class="type">GObject</span></a> which will be weakly referenced;
5289
if it is destroyed, this callback will automatically be
5290
disconnected
5291
</td>
5292
</tr>
5293
<tr>
5294
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5295
<td> If not <a
5296
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5297
><code class="literal">NULL</code></a>, used to raise an error if <a
5298
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5299
><code class="literal">NULL</code></a> is
5300
returned
5301
</td>
5302
</tr>
5303
<tr>
5304
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5305
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
5306
above, which can be used to disconnect the signal; or
5307
<a
5308
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5309
><code class="literal">NULL</code></a> if the proxy does not have the desired interface
5310
or has become invalid.
5311
</td>
5312
</tr>
5313
</tbody>
5314
</table></div>
5315
</div>
5316
<hr>
5317
<div class="refsect2" lang="en">
5318
<a name="tp-cli-connection-signal-callback-self-handle-changed"></a><h3>tp_cli_connection_signal_callback_self_handle_changed ()</h3>
5319
<pre class="programlisting">void (*tp_cli_connection_signal_callback_self_handle_changed)
5320
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
5321
<a
5322
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5323
>guint</a> arg_Self_Handle,
5324
<a
5325
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
5326
>gpointer</a> user_data,
5327
<a
5328
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5329
>GObject</a> *weak_object);</pre>
5330
<p>
5331
Represents the signature of a callback for the signal SelfHandleChanged.</p>
5332
<p>
5333
</p>
5334
<div class="variablelist"><table border="0">
5335
<col align="left" valign="top">
5336
<tbody>
5337
<tr>
5338
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5339
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-self-handle-changed" title="tp_cli_connection_connect_to_self_handle_changed ()"><code class="function">tp_cli_connection_connect_to_self_handle_changed()</code></a>
5340
was called
5341
</td>
5342
</tr>
5343
<tr>
5344
<td><p><span class="term"><em class="parameter"><code>arg_Self_Handle</code></em> :</span></p></td>
5345
<td> The new value of the SelfHandle property.
5346
</td>
5347
</tr>
5348
<tr>
5349
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5350
<td> User-supplied data
5351
</td>
5352
</tr>
5353
<tr>
5354
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5355
<td> User-supplied weakly referenced object
5356
</td>
5357
</tr>
5358
</tbody>
5359
</table></div>
5360
</div>
5361
<hr>
5362
<div class="refsect2" lang="en">
5363
<a name="tp-cli-connection-connect-to-self-handle-changed"></a><h3>tp_cli_connection_connect_to_self_handle_changed ()</h3>
5364
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_connect_to_self_handle_changed
5365
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
5366
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()">tp_cli_connection_signal_callback_self_handle_changed</a> callback,
5367
<a
5368
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
5369
>gpointer</a> user_data,
5370
<a
5371
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
5372
>GDestroyNotify</a> destroy,
5373
<a
5374
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5375
>GObject</a> *weak_object,
5376
<a
5377
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
5378
>GError</a> **error);</pre>
5379
<p>
5380
Connect a handler to the signal SelfHandleChanged.
5381
</p>
5382
<p>
5383
Emitted whenever the <tp:member-ref>SelfHandle</tp:member-ref> property changes. If the connection is not yet in the CONNECTED state, this signal is not guaranteed to be emitted.</p>
5384
<p>
5385
</p>
5386
<div class="variablelist"><table border="0">
5387
<col align="left" valign="top">
5388
<tbody>
5389
<tr>
5390
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5391
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
5392
</td>
5393
</tr>
5394
<tr>
5395
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5396
<td> Callback to be called when the signal is
5397
received
5398
</td>
5399
</tr>
5400
<tr>
5401
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5402
<td> User-supplied data for the callback
5403
</td>
5404
</tr>
5405
<tr>
5406
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
5407
<td> Destructor for the user-supplied data, which
5408
will be called when this signal is disconnected, or
5409
before this function returns <a
5410
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5411
><code class="literal">NULL</code></a>
5412
</td>
5413
</tr>
5414
<tr>
5415
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5416
<td> A <a
5417
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5418
><span class="type">GObject</span></a> which will be weakly referenced;
5419
if it is destroyed, this callback will automatically be
5420
disconnected
5421
</td>
5422
</tr>
5423
<tr>
5424
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5425
<td> If not <a
5426
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5427
><code class="literal">NULL</code></a>, used to raise an error if <a
5428
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5429
><code class="literal">NULL</code></a> is
5430
returned
5431
</td>
5432
</tr>
5433
<tr>
5434
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5435
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
5436
above, which can be used to disconnect the signal; or
5437
<a
5438
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4455
5439
><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4456
5440
or has become invalid.
4457
5441
</td>
4465
5449
<pre class="programlisting">void (*tp_cli_connection_signal_callback_status_changed)
4466
5450
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4467
5451
<a
4468
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4469
>guint</a> arg_status,
4470
<a
4471
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
4472
>guint</a> arg_reason,
4473
<a
4474
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
5452
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5453
>guint</a> arg_Status,
5454
<a
5455
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5456
>guint</a> arg_Reason,
5457
<a
5458
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4475
5459
>gpointer</a> user_data,
4476
5460
<a
4477
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
5461
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4478
5462
>GObject</a> *weak_object);</pre>
4479
5463
<p>
4480
5464
Represents the signature of a callback for the signal StatusChanged.</p>
4481
5465
<p>
4482
4483
5466
</p>
4484
5467
<div class="variablelist"><table border="0">
4485
5468
<col align="left" valign="top">
4491
5474
</td>
4492
5475
</tr>
4493
5476
<tr>
4494
<td><p><span class="term"><em class="parameter"><code>arg_status</code></em> :</span></p></td>
5477
<td><p><span class="term"><em class="parameter"><code>arg_Status</code></em> :</span></p></td>
4495
5478
<td> An integer indicating the new status, as defined by ConnectionStatus
4496
5479
</td>
4497
5480
</tr>
4498
5481
<tr>
4499
<td><p><span class="term"><em class="parameter"><code>arg_reason</code></em> :</span></p></td>
5482
<td><p><span class="term"><em class="parameter"><code>arg_Reason</code></em> :</span></p></td>
4500
5483
<td> An integer indicating the reason for the status change, as defined by ConnectionStatusReason
4501
5484
</td>
4502
5485
</tr>
4516
5499
<hr>
4517
5500
<div class="refsect2" lang="en">
4518
5501
<a name="tp-cli-connection-connect-to-status-changed"></a><h3>tp_cli_connection_connect_to_status_changed ()</h3>
4519
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a>* tp_cli_connection_connect_to_status_changed
5502
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_connect_to_status_changed
4520
5503
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
4521
5504
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()">tp_cli_connection_signal_callback_status_changed</a> callback,
4522
5505
<a
4523
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
5506
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
4524
5507
>gpointer</a> user_data,
4525
5508
<a
4526
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
5509
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
4527
5510
>GDestroyNotify</a> destroy,
4528
5511
<a
4529
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
5512
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
4530
5513
>GObject</a> *weak_object,
4531
5514
<a
4532
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
5515
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
4533
5516
>GError</a> **error);</pre>
4534
5517
<p>
4535
5518
Connect a handler to the signal StatusChanged.
4537
5520
<p>
4538
5521
Emitted when the status of the connection changes. All states and reasons have numerical values, as defined in ConnectionStatus and ConnectionStatusReason.</p>
4539
5522
<p>
4540
4541
</p>
4542
<div class="variablelist"><table border="0">
4543
<col align="left" valign="top">
4544
<tbody>
4545
<tr>
4546
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
4547
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
4548
</td>
4549
</tr>
4550
<tr>
4551
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4552
<td> Callback to be called when the signal is
4553
received
4554
</td>
4555
</tr>
4556
<tr>
4557
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4558
<td> User-supplied data for the callback
4559
</td>
4560
</tr>
4561
<tr>
4562
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
4563
<td> Destructor for the user-supplied data, which
4564
will be called when this signal is disconnected, or
4565
before this function returns <a
4566
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4567
><code class="literal">NULL</code></a>
4568
</td>
4569
</tr>
4570
<tr>
4571
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
4572
<td> A <a
4573
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
4574
><span class="type">GObject</span></a> which will be weakly referenced;
4575
if it is destroyed, this callback will automatically be
4576
disconnected
4577
</td>
4578
</tr>
4579
<tr>
4580
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4581
<td> If not <a
4582
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4583
><code class="literal">NULL</code></a>, used to raise an error if <a
4584
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
4585
><code class="literal">NULL</code></a> is
4586
returned
4587
</td>
4588
</tr>
4589
<tr>
4590
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4591
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4592
above, which can be used to disconnect the signal; or
4593
<a
4594
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
5523
</p>
5524
<div class="variablelist"><table border="0">
5525
<col align="left" valign="top">
5526
<tbody>
5527
<tr>
5528
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5529
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
5530
</td>
5531
</tr>
5532
<tr>
5533
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5534
<td> Callback to be called when the signal is
5535
received
5536
</td>
5537
</tr>
5538
<tr>
5539
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5540
<td> User-supplied data for the callback
5541
</td>
5542
</tr>
5543
<tr>
5544
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
5545
<td> Destructor for the user-supplied data, which
5546
will be called when this signal is disconnected, or
5547
before this function returns <a
5548
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5549
><code class="literal">NULL</code></a>
5550
</td>
5551
</tr>
5552
<tr>
5553
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5554
<td> A <a
5555
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5556
><span class="type">GObject</span></a> which will be weakly referenced;
5557
if it is destroyed, this callback will automatically be
5558
disconnected
5559
</td>
5560
</tr>
5561
<tr>
5562
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5563
<td> If not <a
5564
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5565
><code class="literal">NULL</code></a>, used to raise an error if <a
5566
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5567
><code class="literal">NULL</code></a> is
5568
returned
5569
</td>
5570
</tr>
5571
<tr>
5572
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5573
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
5574
above, which can be used to disconnect the signal; or
5575
<a
5576
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5577
><code class="literal">NULL</code></a> if the proxy does not have the desired interface
5578
or has become invalid.
5579
</td>
5580
</tr>
5581
</tbody>
5582
</table></div>
5583
</div>
5584
<hr>
5585
<div class="refsect2" lang="en">
5586
<a name="tp-cli-connection-signal-callback-connection-error"></a><h3>tp_cli_connection_signal_callback_connection_error ()</h3>
5587
<pre class="programlisting">void (*tp_cli_connection_signal_callback_connection_error)
5588
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
5589
const <a
5590
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
5591
>gchar</a> *arg_Error,
5592
<a
5593
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
5594
>GHashTable</a> *arg_Details,
5595
<a
5596
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
5597
>gpointer</a> user_data,
5598
<a
5599
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5600
>GObject</a> *weak_object);</pre>
5601
<p>
5602
Represents the signature of a callback for the signal ConnectionError.</p>
5603
<p>
5604
</p>
5605
<div class="variablelist"><table border="0">
5606
<col align="left" valign="top">
5607
<tbody>
5608
<tr>
5609
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5610
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-connection-error" title="tp_cli_connection_connect_to_connection_error ()"><code class="function">tp_cli_connection_connect_to_connection_error()</code></a>
5611
was called
5612
</td>
5613
</tr>
5614
<tr>
5615
<td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
5616
<td> The name of a D-Bus error describing the error that occurred, which may correspond to a <tp:type>Connection_Status_Reason</tp:type> or be a protocol-specific or connection-manager-specific error in a suitable namespace. <tp:rationale> For instance, a SIP connection manager could signal &quot;402 Payment Required&quot; as an error in a connection-manager-specific namespace, or a link-local XMPP implementation that used Avahi could provide the error given to it by the avahi-daemon. </tp:rationale>
5617
</td>
5618
</tr>
5619
<tr>
5620
<td><p><span class="term"><em class="parameter"><code>arg_Details</code></em> :</span></p></td>
5621
<td> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Additional information about the error, which may include the following well-known keys:</p> <dl> <dt>debug-message (s)</dt> <dd>Debugging information on the change, corresponding to the message part of a D-Bus error message, which SHOULD NOT be displayed to users under normal circumstances</dd> </dl> <tp:rationale> <p>This argument allows for future extensions. For instance, if indicating DNS lookup failure, we could define a key that indicates the hostname that could not be found.</p> </tp:rationale>
5622
</td>
5623
</tr>
5624
<tr>
5625
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5626
<td> User-supplied data
5627
</td>
5628
</tr>
5629
<tr>
5630
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5631
<td> User-supplied weakly referenced object
5632
</td>
5633
</tr>
5634
</tbody>
5635
</table></div>
5636
</div>
5637
<hr>
5638
<div class="refsect2" lang="en">
5639
<a name="tp-cli-connection-connect-to-connection-error"></a><h3>tp_cli_connection_connect_to_connection_error ()</h3>
5640
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_connection_connect_to_connection_error
5641
(<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a> *proxy,
5642
<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()">tp_cli_connection_signal_callback_connection_error</a> callback,
5643
<a
5644
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
5645
>gpointer</a> user_data,
5646
<a
5647
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
5648
>GDestroyNotify</a> destroy,
5649
<a
5650
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5651
>GObject</a> *weak_object,
5652
<a
5653
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
5654
>GError</a> **error);</pre>
5655
<p>
5656
Connect a handler to the signal ConnectionError.
5657
</p>
5658
<p>
5659
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when an error occurs that renders this connection unusable. </p> <p>Whenever this signal is emitted, it MUST immediately be followed by a <tp:member-ref>StatusChanged</tp:member-ref> signal with status Connection_Status_Reason_Disconnected and an appropriate reason code.</p> <p>Connection managers SHOULD emit this signal on disconnection, but need not do so. Clients MUST support connection managers that emit StatusChanged(Disconnected, ...) without first emitting ConnectionError.</p> <tp:rationale> <p>This signal provides additional information about the reason for disconnection. The reason for connection is always straightforward - it was requested - so it does not need further explanation. However, on errors, it can be useful to provide additional information.</p> <p>The <tp:type>Connection_Status_Reason</tp:type> is not given here, since it will be signalled in <tp:member-ref>StatusChanged</tp:member-ref>. A reasonable client implementation would be to store the information given by this signal until StatusChanged is received, at which point the information given by this signal can be used to supplement the StatusChanged signal.</p> </tp:rationale></p>
5660
<p>
5661
</p>
5662
<div class="variablelist"><table border="0">
5663
<col align="left" valign="top">
5664
<tbody>
5665
<tr>
5666
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
5667
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
5668
</td>
5669
</tr>
5670
<tr>
5671
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
5672
<td> Callback to be called when the signal is
5673
received
5674
</td>
5675
</tr>
5676
<tr>
5677
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
5678
<td> User-supplied data for the callback
5679
</td>
5680
</tr>
5681
<tr>
5682
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
5683
<td> Destructor for the user-supplied data, which
5684
will be called when this signal is disconnected, or
5685
before this function returns <a
5686
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5687
><code class="literal">NULL</code></a>
5688
</td>
5689
</tr>
5690
<tr>
5691
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
5692
<td> A <a
5693
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
5694
><span class="type">GObject</span></a> which will be weakly referenced;
5695
if it is destroyed, this callback will automatically be
5696
disconnected
5697
</td>
5698
</tr>
5699
<tr>
5700
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
5701
<td> If not <a
5702
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5703
><code class="literal">NULL</code></a>, used to raise an error if <a
5704
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
5705
><code class="literal">NULL</code></a> is
5706
returned
5707
</td>
5708
</tr>
5709
<tr>
5710
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
5711
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
5712
above, which can be used to disconnect the signal; or
5713
<a
5714
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
4595
5715
><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4596
5716
or has become invalid.
4597
5717
</td>
4605
5725
<div class="refsect2" lang="en">
4606
5726
<a name="TpConnection--connection-ready"></a><h3>The <code class="literal">"connection-ready"</code> property</h3>
4607
5727
<pre class="programlisting"> "connection-ready" <a
4608
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
5728
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
4609
5729
>gboolean</a> : Read</pre>
4610
5730
<p>
4611
5731
Initially <a
4612
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
5732
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
4613
5733
><code class="literal">FALSE</code></a>; changes to <a
4614
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
5734
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
4615
5735
><code class="literal">TRUE</code></a> when the connection has gone to
4616
5736
CONNECTED status, introspection has finished and it's ready for use.
4617
5737
</p>
4618
5738
<p>
4619
5739
By the time this property becomes <a
4620
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
5740
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
4621
5741
><code class="literal">TRUE</code></a>, any extra interfaces will
4622
5742
have been set up and the <a class="link" href="telepathy-glib-proxy.html#TpProxy--interfaces" title='The "interfaces" property'><span class="type">"interfaces"</span></a> property will have been
4623
5743
populated.</p>
4624
5744
<p>
4625
4626
5745
</p>
4627
5746
<p>Default value: FALSE</p>
4628
5747
</div>
4629
5748
<hr>
4630
5749
<div class="refsect2" lang="en">
5750
<a name="TpConnection--self-handle"></a><h3>The <code class="literal">"self-handle"</code> property</h3>
5751
<pre class="programlisting"> "self-handle" <a
5752
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
5753
>guint</a> : Read</pre>
5754
<p>
5755
The <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-CONTACT--CAPS"><code class="literal">TP_HANDLE_TYPE_CONTACT</code></a> handle of the local user on this connection,
5756
or 0 if we don't know yet or if the connection has become invalid.</p>
5757
<p>
5758
</p>
5759
<p>Default value: 0</p>
5760
</div>
5761
<hr>
5762
<div class="refsect2" lang="en">
4631
5763
<a name="TpConnection--status"></a><h3>The <code class="literal">"status"</code> property</h3>
4632
5764
<pre class="programlisting"> "status" <a
4633
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
5765
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4634
5766
>guint</a> : Read</pre>
4635
5767
<p>
4636
5768
This connection's status, or TP_UNKNOWN_CONNECTION_STATUS if we don't
4637
5769
know yet.</p>
4638
5770
<p>
4639
4640
5771
</p>
4641
5772
<p>Default value: 4294967295</p>
4642
5773
</div>
4644
5775
<div class="refsect2" lang="en">
4645
5776
<a name="TpConnection--status-reason"></a><h3>The <code class="literal">"status-reason"</code> property</h3>
4646
5777
<pre class="programlisting"> "status-reason" <a
4647
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
5778
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
4648
5779
>guint</a> : Read</pre>
4649
5780
<p>
4650
5781
The reason why <a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'><span class="type">"status"</span></a> changed to its current value,
4651
5782
or TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED if unknown.
4652
5783
know yet.</p>
4653
5784
<p>
4654
4655
5785
</p>
4656
5786
<p>Default value: 0</p>
4657
5787
</div>
4658
5788
</div>
4659
5789
<div class="refsect1" lang="en">
4660
5790
<a name="telepathy-glib-connection.see-also"></a><h2>See Also</h2>
4661
<a class="link" href="telepathy-glib-connection-manager.html#TpConnectionManager"><span class="type">TpConnectionManager</span></a>, <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a>
5791
#TpConnectionManager, <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a>
4662
5792
</div>
4663
5793
</div>
4664
5794
<div class="footer">
4665
5795
<hr>
4666
Generated by GTK-Doc V1.10</div>
5796
Generated by GTK-Doc V1.11</div>
4667
5797
</body>
4668
5798
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1