Codebase list telepathy-glib / b8b61eb
Imported Upstream version 0.7.32 Simon McVittie 14 years ago
211 changed file(s) with 23389 addition(s) and 287 deletion(s). Raw diff Collapse all Expand all
0 commit 2469e1bf3af4546c95467feb19436555e9492a21
1 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2 Date: 2009-06-12 17:14:08 +0100
3
4 Prepare 0.7.32
5
6 NEWS | 9 ++-
7 configure.ac | 8 +-
8 telepathy-glib/Makefile.am | 3 +-
9 telepathy-glib/account-manager.c | 6 +-
10 telepathy-glib/account.c | 6 +-
11 telepathy-glib/channel-dispatch-operation.c | 4 +-
12 telepathy-glib/channel-dispatcher.c | 4 +-
13 telepathy-glib/channel-request.c | 4 +-
14 telepathy-glib/client.c | 6 +-
15 telepathy-glib/connection-manager.c | 2 +-
16 telepathy-glib/dbus.c | 2 +-
17 telepathy-glib/media-interfaces.c | 4 +-
18 telepathy-glib/versions/0.7.32.abi | 102 +++++++++++++++++++++++++++
19 13 files changed, 133 insertions(+), 27 deletions(-)
20
21 commit 30e212a22b35bd177360e5e34d9ffec3e1fdab54
22 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
23 Date: 2009-06-12 16:42:34 +0100
24
25 fd.o #22182: fix a potential use-after-free in the callable example CM
26
27 In some environments (I'm not sure why my laptop isn't among them),
28 closing the stream causes the channel to remove the last ref to the
29 stream, resulting in a use-after-free and a possible segfault.
30
31 This could be avoided by holding another ref for the duration of
32 example_callable_media_stream_close, but Sjoerd and I agreed that this
33 simpler fix (re-ordering to put the possible free last) was more
34 appropriate.
35
36 Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
37
38 examples/cm/callable/media-stream.c | 6 ++++--
39 1 files changed, 4 insertions(+), 2 deletions(-)
40
41 commit 0649d9ffd4bc9f0d03701623d7e85489f83eb3a2
42 Merge: 99c7389 5586a8f
43 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
44 Date: 2009-06-12 12:57:11 +0100
45
46 Merge branch 'more-types'
47
48 Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
49
50 commit 5586a8fbd53e77d7d65db4c259d034ab3e02debc
51 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
52 Date: 2009-06-12 12:10:35 +0100
53
54 Extend .manager regression test coverage to all the types with a serialization defined by telepathy-spec
55
56 tests/dbus/cm.c | 23 ++++++++++++++++++++
57 .../telepathy/managers/test_manager_file.manager | 7 ++++++
58 2 files changed, 30 insertions(+), 0 deletions(-)
59
60 commit f2c30c9909d62d5764c35c48dff0fe990cce6d74
61 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
62 Date: 2009-06-10 11:55:12 +0100
63
64 TpConnectionManager: improve validation of object paths from .manager files
65
66 telepathy-glib/connection-manager.c | 9 ++++++---
67 1 files changed, 6 insertions(+), 3 deletions(-)
68
69 commit fc9d74daa94da8d4a55bb78ebf0983fe0cddfe5a
70 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
71 Date: 2009-06-10 11:54:52 +0100
72
73 fd.o #22230: TpConnectionManager: add support for parsing 'y' in .manager files
74
75 telepathy-glib/connection-manager.c | 12 ++++++++++++
76 1 files changed, 12 insertions(+), 0 deletions(-)
77
78 commit 99c73891227f62cf23ecb40768ce52b3680fca00
79 Merge: 6eb255e 7115345
80 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
81 Date: 2009-06-10 17:58:00 +0100
82
83 Merge branch 'trivia'
84
85 Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
86
87 commit 71153454e19f4d3a9a6b7a42ce78851f46fa2efd
88 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
89 Date: 2009-06-10 17:51:32 +0100
90
91 Explain how to drive the new glib-client-gen.py
92
93 NEWS | 10 ++++++++++
94 1 files changed, 10 insertions(+), 0 deletions(-)
95
96 commit 65dfad6e9fbe02b880695dcdddf3b3b94a53176e
97 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
98 Date: 2009-06-10 17:38:04 +0100
99
100 NEWS so far
101
102 NEWS | 26 ++++++++++++++++++++++++++
103 1 files changed, 26 insertions(+), 0 deletions(-)
104
105 commit 6eb255e535dd0860606ba3ce1182f37d99e6215c
106 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
107 Date: 2009-06-10 17:37:44 +0100
108
109 Add missing svc-* headers to telepathy-glib/Makefile.am to fix distcheck
110
111 telepathy-glib/Makefile.am | 6 ++++++
112 1 files changed, 6 insertions(+), 0 deletions(-)
113
114 commit 97f2ba983a68ec2ccefe4c8b7f389c3e826fb9bc
115 Merge: a577ba2 79c483d
116 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
117 Date: 2009-06-10 16:41:47 +0100
118
119 Merge branches 'reentrant', 'undraft' and 'knowninterfaces'
120
121 Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
122
123 commit 79c483dbeef86c8b45cdb329db8d5ceb0842aae9
124 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
125 Date: 2009-06-10 16:23:49 +0100
126
127 Amend svc-client description in extra-gtkdoc.h as per Will's review
128
129 telepathy-glib/extra-gtkdoc.h | 7 +++++--
130 1 files changed, 5 insertions(+), 2 deletions(-)
131
132 commit a577ba260dc8949a971297e7328998434d944ded
133 Merge: c54861d 0cb63c2
134 Author: Will Thompson <will.thompson@collabora.co.uk>
135 Date: 2009-06-10 15:48:17 +0100
136
137 Merge branch 'idempotent-dispose'
138
139 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
140
141 commit ffc8dced420921fa79f40d580bb459485facbc06
142 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
143 Date: 2009-06-10 15:24:24 +0100
144
145 Include all init_known_interfaces functions in docs
146
147 docs/reference/telepathy-glib-sections.txt | 10 ++++++++++
148 1 files changed, 10 insertions(+), 0 deletions(-)
149
150 commit 30c621196a9a5ed32d9cfbd4697f52c27a398ade
151 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
152 Date: 2009-06-10 15:20:08 +0100
153
154 spec 0.17.26 classes: make safe to extend
155
156 telepathy-glib/account-manager.c | 37 ++++++++++++++++++++++---
157 telepathy-glib/account-manager.h | 2 +
158 telepathy-glib/account.c | 37 ++++++++++++++++++++++---
159 telepathy-glib/account.h | 2 +
160 telepathy-glib/channel-dispatch-operation.c | 38 +++++++++++++++++++++++---
161 telepathy-glib/channel-dispatch-operation.h | 2 +
162 telepathy-glib/channel-dispatcher.c | 37 ++++++++++++++++++++++---
163 telepathy-glib/channel-dispatcher.h | 2 +
164 telepathy-glib/channel-request.c | 37 ++++++++++++++++++++++---
165 telepathy-glib/channel-request.h | 2 +
166 telepathy-glib/client.c | 37 ++++++++++++++++++++++---
167 telepathy-glib/client.h | 2 +
168 12 files changed, 205 insertions(+), 30 deletions(-)
169
170 commit c85d9262108a830d0dee3b42ef73e9691e3ecdac
171 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
172 Date: 2009-06-10 15:19:47 +0100
173
174 TpConnectionManager, TpDBusDaemon, media interfaces: make safe to extend
175
176 As with TpChannel, a function like
177 tp_connection_manager_init_known_interfaces needs to be called before you
178 add signals, to ensure that extensions correctly override code in
179 telepathy-glib itself.
180
181 telepathy-glib/connection-manager.c | 38 +++++++++++++++--
182 telepathy-glib/connection-manager.h | 2 +
183 telepathy-glib/dbus.c | 31 ++++++++++++++-
184 telepathy-glib/dbus.h | 10 +++--
185 telepathy-glib/media-interfaces.c | 74 ++++++++++++++++++++++++++++++-----
186 telepathy-glib/media-interfaces.h | 3 +
187 6 files changed, 137 insertions(+), 21 deletions(-)
188
189 commit 103d0afb4369bee6123e15b4f4d4d1b95061d70e
190 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
191 Date: 2009-06-10 15:12:25 +0100
192
193 TpConnection: use tp_connection_init_known_interfaces() to add interfaces rather than reimplementing it
194
195 telepathy-glib/connection.c | 7 ++-----
196 1 files changed, 2 insertions(+), 5 deletions(-)
197
198 commit c966ea9734f741fbaa3d5cc9569270925460afc1
199 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
200 Date: 2009-06-10 14:53:38 +0100
201
202 Remove _run_ methods for the classes that are new in spec 0.17.26
203
204 These have never appeared in a release, and we're on the way to
205 deprecating them in general, so we might as well just not have them on
206 these classes.
207
208 docs/reference/telepathy-glib-sections.txt | 27 ---------------------------
209 telepathy-glib/Makefile.am | 6 ------
210 2 files changed, 0 insertions(+), 33 deletions(-)
211
212 commit 9085a25a06f39865b0d748464ed7be231bcaaae8
213 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
214 Date: 2009-06-10 13:40:03 +0100
215
216 Update to telepathy-spec 0.17.26
217
218 spec/Channel_Dispatch_Operation.xml | 5 +++--
219 spec/Channel_Dispatcher.xml | 1 +
220 ...Channel_Dispatcher_Interface_Operation_List.xml | 5 +++--
221 spec/Channel_Request.xml | 1 +
222 spec/Client.xml | 6 +++---
223 spec/Client_Approver.xml | 6 +++---
224 spec/Client_Handler.xml | 6 +++---
225 spec/Client_Interface_Requests.xml | 3 +--
226 spec/Client_Observer.xml | 8 ++++----
227 spec/all.xml | 8 ++++----
228 10 files changed, 26 insertions(+), 23 deletions(-)
229
230 commit 83a5de557c926f1de5d0ffc81f3994b063093673
231 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
232 Date: 2009-06-09 09:28:11 +0100
233
234 Add basic proxies for Client
235
236 docs/reference/telepathy-glib-docs.sgml | 2 +
237 docs/reference/telepathy-glib-sections.txt | 116 ++++++++++++++++++++++++++++
238 docs/reference/telepathy-glib.types | 8 ++
239 spec/Client.xml | 3 +-
240 spec/Client_Approver.xml | 3 +-
241 spec/Client_Handler.xml | 3 +-
242 spec/Client_Interface_Requests.xml | 3 +-
243 spec/Client_Observer.xml | 3 +-
244 telepathy-glib/Makefile.am | 12 +++
245 telepathy-glib/client.c | 114 +++++++++++++++++++++++++++
246 telepathy-glib/client.h | 70 +++++++++++++++++
247 telepathy-glib/client.xml | 13 +++
248 telepathy-glib/defs.h | 14 ++++
249 telepathy-glib/extra-gtkdoc.h | 10 +++
250 telepathy-glib/stable-interfaces.xml | 2 +
251 telepathy-glib/svc-client.h | 6 ++
252 tests/dbus/Makefile.am | 3 +
253 tests/dbus/client.c | 74 ++++++++++++++++++
254 18 files changed, 449 insertions(+), 10 deletions(-)
255
256 commit f0743304591969845663ebf3ab7ba57fadd5b85e
257 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
258 Date: 2009-06-09 09:27:57 +0100
259
260 Add basic proxies for ChannelDispatchOperation, ChannelRequest
261
262 docs/reference/telepathy-glib-docs.sgml | 4 +
263 docs/reference/telepathy-glib-sections.txt | 114 ++++++++++
264 docs/reference/telepathy-glib.types | 8 +
265 spec/Channel_Dispatch_Operation.xml | 3 +-
266 spec/Channel_Request.xml | 3 +-
267 telepathy-glib/Makefile.am | 25 ++
268 telepathy-glib/channel-dispatch-operation.c | 223 ++++++++++++++++++
269 telepathy-glib/channel-dispatch-operation.h | 78 +++++++
270 telepathy-glib/channel-dispatch-operation.xml | 9 +
271 telepathy-glib/channel-request.c | 250 ++++++++++++++++++++
272 telepathy-glib/channel-request.h | 74 ++++++
273 telepathy-glib/channel-request.xml | 9 +
274 telepathy-glib/extra-gtkdoc.h | 45 ++++
275 telepathy-glib/stable-interfaces.xml | 2 +
276 telepathy-glib/svc-channel-dispatch-operation.h | 6 +
277 telepathy-glib/svc-channel-request.h | 6 +
278 tests/dbus/Makefile.am | 6 +
279 tests/dbus/channel-dispatch-operation.c | 232 +++++++++++++++++++
280 tests/dbus/channel-request.c | 276 +++++++++++++++++++++++
281 19 files changed, 1369 insertions(+), 4 deletions(-)
282
283 commit 2e184d2d313e9b30a9f81f4cf9376dbe1e4811c3
284 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
285 Date: 2009-06-09 09:25:39 +0100
286
287 Add channel dispatcher generated code and a very basic proxy
288
289 docs/reference/telepathy-glib-docs.sgml | 2 +
290 docs/reference/telepathy-glib-sections.txt | 76 +++++++++++
291 docs/reference/telepathy-glib.types | 5 +
292 spec/Channel_Dispatcher.xml | 3 +-
293 ...Channel_Dispatcher_Interface_Operation_List.xml | 3 +-
294 telepathy-glib/Makefile.am | 11 ++
295 telepathy-glib/channel-dispatcher.c | 141 ++++++++++++++++++++
296 telepathy-glib/channel-dispatcher.h | 73 ++++++++++
297 telepathy-glib/channel-dispatcher.xml | 10 ++
298 telepathy-glib/debug-internal.h | 3 +-
299 telepathy-glib/debug.c | 1 +
300 telepathy-glib/defs.h | 14 ++
301 telepathy-glib/extra-gtkdoc.h | 17 +++
302 telepathy-glib/stable-interfaces.xml | 2 +
303 telepathy-glib/svc-channel-dispatcher.h | 6 +
304 tests/dbus/Makefile.am | 3 +
305 tests/dbus/channel-dispatcher.c | 70 ++++++++++
306 17 files changed, 435 insertions(+), 5 deletions(-)
307
308 commit 4e3e02159e6bfbf95408f30b524832feb292cb10
309 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
310 Date: 2009-06-09 15:55:12 +0100
311
312 tests/lib/util.h: add test_proxy_run_until_dbus_queue_processed
313
314 This spins the main loop until Introspect() returns.
315
316 tests/lib/util.c | 6 ++++++
317 tests/lib/util.h | 3 +++
318 2 files changed, 9 insertions(+), 0 deletions(-)
319
320 commit c91e52e37aae3005ce6652c873b12ce6d7a57292
321 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
322 Date: 2009-06-09 09:29:28 +0100
323
324 Add account, AM to docs
325
326 docs/reference/telepathy-glib-docs.sgml | 4 ++++
327 1 files changed, 4 insertions(+), 0 deletions(-)
328
329 commit a56972077bd9903c020e295a8b64a3776af52c65
330 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
331 Date: 2009-06-08 17:36:39 +0100
332
333 Add a trivial test for TpAccount, TpAccountManager
334
335 These just test that nothing actually crashes when we make a TpAccount
336 and a TpAccountManager.
337
338 tests/dbus/Makefile.am | 6 +++
339 tests/dbus/account-manager.c | 69 ++++++++++++++++++++++++++++++++++++
340 tests/dbus/account.c | 79 ++++++++++++++++++++++++++++++++++++++++++
341 3 files changed, 154 insertions(+), 0 deletions(-)
342
343 commit 576d73425fcb49ab5f4533a3d49a45badd4cb7b7
344 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
345 Date: 2009-06-08 17:36:01 +0100
346
347 Add generated code and skeletal proxies for Account, AccountManager
348
349 docs/reference/telepathy-glib-sections.txt | 133 +++++++++++++++++++
350 docs/reference/telepathy-glib.types | 9 ++
351 telepathy-glib/Makefile.am | 24 ++++
352 telepathy-glib/account-manager.c | 138 ++++++++++++++++++++
353 telepathy-glib/account-manager.h | 72 +++++++++++
354 telepathy-glib/account-manager.xml | 9 ++
355 telepathy-glib/account.c | 191 ++++++++++++++++++++++++++++
356 telepathy-glib/account.h | 73 +++++++++++
357 telepathy-glib/account.xml | 11 ++
358 telepathy-glib/debug-internal.h | 3 +-
359 telepathy-glib/debug.c | 3 +
360 telepathy-glib/defs.h | 25 ++++-
361 telepathy-glib/extra-gtkdoc.h | 28 ++++
362 telepathy-glib/stable-interfaces.xml | 3 +
363 telepathy-glib/svc-account-manager.h | 6 +
364 telepathy-glib/svc-account.h | 6 +
365 16 files changed, 731 insertions(+), 3 deletions(-)
366
367 commit 879d6e41f1b50661a887937fddc2d66d3800a816
368 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
369 Date: 2009-06-10 14:34:11 +0100
370
371 glib-client-gen.py: add support for deprecating or not generating _run_ methods
372
373 examples/extensions/Makefile.am | 3 ++-
374 telepathy-glib/Makefile.am | 10 ++++++++++
375 tools/glib-client-gen.py | 31 +++++++++++++++++++++++++------
376 3 files changed, 37 insertions(+), 7 deletions(-)
377
378 commit c54861d1425f8f3c2bc34d07f23269501344683c
379 Merge: db0637d a17fdf9
380 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
381 Date: 2009-06-08 17:56:41 +0100
382
383 Merge branch 'no-alias-flags'
384
385 Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
386
387 commit a17fdf987f41baf5a28260507c81cd6d1adb3ba5
388 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
389 Date: 2009-06-08 16:31:51 +0100
390
391 TpConnection: don't introspect alias flags, and remove some dead code
392
393 This was not, it turns out, a good idea. See TpContact or telepathy-qt4
394 for what we should have been doing.
395
396 telepathy-glib/connection-internal.h | 2 -
397 telepathy-glib/connection.c | 54 ----------------------------------
398 2 files changed, 0 insertions(+), 56 deletions(-)
399
400 commit 8fcba3acbcd23cd597bf3afba8b67c0c43816201
401 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
402 Date: 2009-06-08 16:25:43 +0100
403
404 Revert "Add "alias-flags" property and tp_connection_get_alias_flags method on TpConnection"
405
406 This reverts commit 21a6a922027d62ee29e93123fa16815a6ea811e3.
407
408 This is not the way to do miscellaneous non-core interfaces. Instead, we need
409 something like the "feature" concept in TpContact and telepathy-qt4.
410
411 docs/reference/telepathy-glib-sections.txt | 1 -
412 telepathy-glib/connection.c | 32 +---------------------------
413 telepathy-glib/connection.h | 2 -
414 3 files changed, 1 insertions(+), 34 deletions(-)
415
416 commit db0637d938ad53b80d38e8a44db9c17d4953241e
417 Merge: ea35ffa d8a0cbc
418 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
419 Date: 2009-06-08 16:16:37 +0100
420
421 Merge branch 'trivia'
422
423 Reviewed-by: Will Thompson <will.thompson@collabora.co.uk>
424
425 commit 0cb63c2aecbfb99e091fb4ebf07d85a56266110c
426 Author: Will Thompson <will.thompson@collabora.co.uk>
427 Date: 2009-06-06 13:18:35 +0100
428
429 Make tp_channel_dispose idempotent
430
431 telepathy-glib/channel.c | 4 ++++
432 1 files changed, 4 insertions(+), 0 deletions(-)
433
434 commit ea35ffac42f22a649952852a4870207abc481840
435 Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
436 Date: 2009-06-04 21:51:37 +0100
437
438 Add flymake.mk to EXTRA_DIST.
439
440 Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
441
442 tools/Makefile.am | 1 +
443 1 files changed, 1 insertions(+), 0 deletions(-)
444
445 commit 3b0bd2974c2df6525682b484773eedaafe86517c
446 Author: Jonny Lamb <jonny.lamb@collabora.co.uk>
447 Date: 2009-06-04 18:28:27 +0100
448
449 Add simple flymake support.
450
451 Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
452
453 telepathy-glib/Makefile.am | 1 +
454 tools/flymake.mk | 4 ++++
455 2 files changed, 5 insertions(+), 0 deletions(-)
456
457 commit 21a6a922027d62ee29e93123fa16815a6ea811e3
458 Author: Xavier Claessens <xclaesse@gmail.com>
459 Date: 2009-05-29 15:33:09 +0200
460
461 Add "alias-flags" property and tp_connection_get_alias_flags method on TpConnection
462
463 docs/reference/telepathy-glib-sections.txt | 1 +
464 telepathy-glib/connection.c | 32 +++++++++++++++++++++++++++-
465 telepathy-glib/connection.h | 2 +
466 3 files changed, 34 insertions(+), 1 deletions(-)
467
468 commit db5c49716c12c09b294a5531104fab538a438030
469 Author: Will Thompson <will.thompson@collabora.co.uk>
470 Date: 2009-05-28 11:46:50 +0100
471
472 Document client-side handle reference counting.
473
474 Fixes fd.o #19741
475
476 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
477
478 telepathy-glib/connection-handles.c | 15 +++++++++++++--
479 1 files changed, 13 insertions(+), 2 deletions(-)
480
481 commit e5916e318fed0715246df8261b259ca762c1d245
482 Author: Patryk Zawadzki <patrys@pld-linux.org>
483 Date: 2009-05-28 11:26:04 +0100
484
485 Don't list media-interfaces.h twice in Makefile.am
486
487 Fixes fd.o #21977
488
489 Signed-off-by: Will Thompson <will.thompson@collabora.co.uk>
490 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
491
492 telepathy-glib/Makefile.am | 1 -
493 1 files changed, 0 insertions(+), 1 deletions(-)
494
495 commit d8a0cbcd03efcbbde95bd6aaab12badd71a7ef4c
496 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
497 Date: 2009-05-27 18:51:24 +0100
498
499 Make sure _gen/error-str.h and .c end with a newline
500
501 Some compilers don't like it otherwise.
502
503 This appears to remove the need for the hack that wjt used, where a
504 pointless comment was the last thing in the header.
505
506 tools/glib-errors-str-gen.py | 9 ++++-----
507 1 files changed, 4 insertions(+), 5 deletions(-)
508
509 commit 61588053a440473581b872588cbd81f326f15f91
510 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
511 Date: 2009-05-27 18:02:28 +0100
512
513 Start developing 0.7.32
514
515 NEWS | 11 +++++++++++
516 configure.ac | 2 +-
517 2 files changed, 12 insertions(+), 1 deletions(-)
518
0519 commit d22c658670fe7cf80d5b900bf7c5063f01479337
1520 Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2521 Date: 2009-05-27 17:23:54 +0100
0 telepathy-glib 0.7.32 (2009-06-12)
1 ==================================
2
3 The "cake wars" release.
4
5 Enhancements:
6
7 * fd.o #22208: Updated to telepathy-spec 0.17.26 (smcv)
8
9 * Added generated service-side bindings for AccountManager, Account,
10 ChannelDispatcher, ChannelDispatchOperation, ChannelRequest and Client (smcv)
11
12 * Added minimal versions of TpAccountManager, TpAccount,
13 TpChannelDispatcher, TpChannelDispatchOperation, TpChannelRequest and
14 TpClient (smcv)
15
16 * fd.o #22205: Added support for deprecating or removing _run_ methods in code
17 generation (smcv)
18
19 * Added flymake support (jonnylamb)
20
21 * fd.o #22230: Added support for byte ('y') parameters to CMs (smcv)
22
23 Fixes:
24
25 * Made sure _gen/error-str.h and .c end with a newline, fixing compilation with
26 certain compilers (smcv)
27
28 * fd.o #19741: Documented client-side handle reference counting (wjt)
29
30 * fd.o #21977: Removed duplicate mention of media-interfaces.h in Makefile.am
31 (Patryk Zawadzki)
32
33 * fd.o #22121: made tp_channel_dispose properly idempotent (wjt)
34
35 * Removed dead code for introspecting alias flags (smcv)
36
37 * fd.o #22182: Fixed a potential use-after-free in the callable example CM
38 (smcv)
39
40 Release notes for projects using code generation:
41
42 * After updating to this version of glib-client-gen.py, _run_ methods will no
43 longer be generated by default. To get the behaviour of older versions, run
44 it with the new --generate-reentrant option; to get the methods present
45 but deprecated, use an option like
46 --deprecate-reentrant=FOO_DISABLE_DEPRECATED (which means the _run_ methods
47 are marked with G_GNUC_DEPRECATED, and will not be available at all if
48 FOO_DISABLE_DEPRECATED is defined).
49
050 telepathy-glib 0.7.31 (2009-05-27)
151 ==================================
252
00 #! /bin/sh
11 # Guess values for system-dependent variables and create Makefiles.
2 # Generated by GNU Autoconf 2.63 for Telepathy-GLib 0.7.31.
2 # Generated by GNU Autoconf 2.63 for Telepathy-GLib 0.7.32.
33 #
44 # Report bugs to <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy>.
55 #
744744 # Identity of this package.
745745 PACKAGE_NAME='Telepathy-GLib'
746746 PACKAGE_TARNAME='telepathy-glib'
747 PACKAGE_VERSION='0.7.31'
748 PACKAGE_STRING='Telepathy-GLib 0.7.31'
747 PACKAGE_VERSION='0.7.32'
748 PACKAGE_STRING='Telepathy-GLib 0.7.32'
749749 PACKAGE_BUGREPORT='https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy'
750750
751751 # Factoring default headers for most tests.
15271527 # Omit some internal or obsolete options to make the list less imposing.
15281528 # This message is too long to be a string in the A/UX 3.1 sh.
15291529 cat <<_ACEOF
1530 \`configure' configures Telepathy-GLib 0.7.31 to adapt to many kinds of systems.
1530 \`configure' configures Telepathy-GLib 0.7.32 to adapt to many kinds of systems.
15311531
15321532 Usage: $0 [OPTION]... [VAR=VALUE]...
15331533
15971597
15981598 if test -n "$ac_init_help"; then
15991599 case $ac_init_help in
1600 short | recursive ) echo "Configuration of Telepathy-GLib 0.7.31:";;
1600 short | recursive ) echo "Configuration of Telepathy-GLib 0.7.32:";;
16011601 esac
16021602 cat <<\_ACEOF
16031603
17241724 test -n "$ac_init_help" && exit $ac_status
17251725 if $ac_init_version; then
17261726 cat <<\_ACEOF
1727 Telepathy-GLib configure 0.7.31
1727 Telepathy-GLib configure 0.7.32
17281728 generated by GNU Autoconf 2.63
17291729
17301730 Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
17381738 This file contains any messages produced by compilers while
17391739 running configure, to aid debugging if configure makes a mistake.
17401740
1741 It was created by Telepathy-GLib $as_me 0.7.31, which was
1741 It was created by Telepathy-GLib $as_me 0.7.32, which was
17421742 generated by GNU Autoconf 2.63. Invocation command line was
17431743
17441744 $ $0 $@
24372437
24382438 # Define the identity of the package.
24392439 PACKAGE='telepathy-glib'
2440 VERSION='0.7.31'
2440 VERSION='0.7.32'
24412441
24422442
24432443 cat >>confdefs.h <<_ACEOF
1179611796
1179711797
1179811798
11799 LT_CURRENT=25
11799 LT_CURRENT=26
1180011800 LT_REVISION=0
11801 LT_AGE=25
11801 LT_AGE=26
1180211802
1180311803
1180411804
1405614056 # report actual input values of CONFIG_FILES etc. instead of their
1405714057 # values after options handling.
1405814058 ac_log="
14059 This file was extended by Telepathy-GLib $as_me 0.7.31, which was
14059 This file was extended by Telepathy-GLib $as_me 0.7.32, which was
1406014060 generated by GNU Autoconf 2.63. Invocation command line was
1406114061
1406214062 CONFIG_FILES = $CONFIG_FILES
1411914119 _ACEOF
1412014120 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
1412114121 ac_cs_version="\\
14122 Telepathy-GLib config.status 0.7.31
14122 Telepathy-GLib config.status 0.7.32
1412314123 configured by $0, generated by GNU Autoconf 2.63,
1412414124 with options \\"`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`\\"
1412514125
1010
1111 m4_define([tp_glib_major_version], [0])
1212 m4_define([tp_glib_minor_version], [7])
13 m4_define([tp_glib_micro_version], [31])
13 m4_define([tp_glib_micro_version], [32])
1414 m4_define([tp_glib_nano_version], [0])
1515
1616 # If library source has changed since last release, increment revision
2525 # (we don't guarantee that we won't add ABI then remove it again, if it was
2626 # never seen in a release).
2727
28 m4_define([tp_glib_lt_current], [25])
28 m4_define([tp_glib_lt_current], [26])
2929 m4_define([tp_glib_lt_revision], [0])
30 m4_define([tp_glib_lt_age], [25])
30 m4_define([tp_glib_lt_age], [26])
3131
3232 # Some magic
3333 m4_define([tp_glib_base_version],
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpBaseConnection</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="TpBaseConnectionManager.html" title="TpBaseConnectionManager">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpBaseConnectionManager</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-run.html" title="Connection manager life cycle">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpChannelFactoryIface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="TpBaseConnection.html" title="TpBaseConnection">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpChannelIface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-gtypes.html" title="GType factory functions">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpChannelManager</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="TpChannelFactoryIface.html" title="TpChannelFactoryIface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpDynamicHandleRepo</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-handles.html" title="Service-side handle repositories">
88 <link rel="prev" href="TpStaticHandleRepo.html" title="TpStaticHandleRepo">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpExportableChannel</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-dbus-properties-mixin.html" title="TpDBusPropertiesMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpStaticHandleRepo</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-handles.html" title="Service-side handle repositories">
88 <link rel="prev" href="telepathy-glib-handle-repo.html" title="TpHandleRepoIface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Client-side proxies</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
88 <link rel="prev" href="TpChannelIface.html" title="TpChannelIface">
8989 <dt>
9090 <span class="refentrytitle"><a href="telepathy-glib-media-interfaces.html">TpMediaSessionHandler, TpMediaStreamHandler</a></span><span class="refpurpose"> — proxy objects for Telepathy media streaming</span>
9191 </dt>
92 <dt>
93 <span class="refentrytitle"><a href="telepathy-glib-account-manager.html">TpAccountManager</a></span><span class="refpurpose"> — proxy object for the Telepathy account manager</span>
94 </dt>
95 <dt>
96 <span class="refentrytitle"><a href="telepathy-glib-account.html">TpAccount</a></span><span class="refpurpose"> — proxy object for an account in the Telepathy account
97 manager</span>
98 </dt>
99 <dt>
100 <span class="refentrytitle"><a href="telepathy-glib-channel-dispatcher.html">TpChannelDispatcher</a></span><span class="refpurpose"> — proxy object for the Telepathy channel dispatcher</span>
101 </dt>
102 <dt>
103 <span class="refentrytitle"><a href="telepathy-glib-channel-dispatch-operation.html">TpChannelDispatchOperation</a></span><span class="refpurpose"> — proxy object for a to the Telepathy channel
104 dispatcher</span>
105 </dt>
106 <dt>
107 <span class="refentrytitle"><a href="telepathy-glib-channel-request.html">TpChannelRequest</a></span><span class="refpurpose"> — proxy object for a request to the Telepathy channel
108 dispatcher</span>
109 </dt>
110 <dt>
111 <span class="refentrytitle"><a href="telepathy-glib-client.html">TpClient</a></span><span class="refpurpose"> — proxy object for a client of the ChannelDispatcher</span>
112 </dt>
92113 </dl></div>
93114 </div>
94115 <div class="footer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>General D-Bus support</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
88 <link rel="prev" href="index.html" title="telepathy-glib Reference Manual">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>The Telepathy protocol</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
88 <link rel="prev" href="telepathy-glib-proxy-subclass.html" title="TpProxy subclasses and mixins">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side implementation</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
8 <link rel="prev" href="telepathy-glib-svc-connection-manager.html" title="Service-side Connection Manager interface">
8 <link rel="prev" href="telepathy-glib-svc-client.html" title="Service-side Client interfaces">
99 <link rel="next" href="telepathy-glib-run.html" title="Connection manager life cycle">
1010 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
1111 <link rel="stylesheet" href="style.css" type="text/css">
1919 </head>
2020 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
2121 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
22 <td><a accesskey="p" href="telepathy-glib-svc-connection-manager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
22 <td><a accesskey="p" href="telepathy-glib-svc-client.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
2323 <td> </td>
2424 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
2525 <th width="100%" align="center">telepathy-glib Reference Manual</th>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side D-Bus interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
8 <link rel="prev" href="telepathy-glib-media-interfaces.html" title="TpMediaSessionHandler, TpMediaStreamHandler">
8 <link rel="prev" href="telepathy-glib-client.html" title="TpClient">
99 <link rel="next" href="telepathy-glib-svc.html" title="The TpSvc* interfaces">
1010 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
1111 <link rel="stylesheet" href="style.css" type="text/css">
1919 </head>
2020 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
2121 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
22 <td><a accesskey="p" href="telepathy-glib-media-interfaces.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
22 <td><a accesskey="p" href="telepathy-glib-client.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
2323 <td> </td>
2424 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
2525 <th width="100%" align="center">telepathy-glib Reference Manual</th>
7777 <dt>
7878 <span class="refentrytitle"><a href="telepathy-glib-svc-connection-manager.html">Service-side Connection Manager interface</a></span><span class="refpurpose"> — GInterface for Telepathy ConnectionManager objects</span>
7979 </dt>
80 <dt>
81 <span class="refentrytitle"><a href="telepathy-glib-svc-account-manager.html">Service-side Account Manager interface</a></span><span class="refpurpose"> — GInterface for Telepathy AccountManager objects</span>
82 </dt>
83 <dt>
84 <span class="refentrytitle"><a href="telepathy-glib-svc-account.html">Service-side Account interfaces</a></span><span class="refpurpose"> — GInterfaces for Telepathy Account objects</span>
85 </dt>
86 <dt>
87 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-dispatcher.html">Service-side Channel Dispatcher interface</a></span><span class="refpurpose"> — GInterfaces for Telepathy ChannelDispatcher object</span>
88 </dt>
89 <dt>
90 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-dispatch-operation.html">Service-side Channel Dispatch Operation interface</a></span><span class="refpurpose"> — GInterface for Telepathy ChannelDispatchOperation object</span>
91 </dt>
92 <dt>
93 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-request.html">Service-side Channel Request interface</a></span><span class="refpurpose"> — GInterface for Telepathy ChannelRequest object</span>
94 </dt>
95 <dt>
96 <span class="refentrytitle"><a href="telepathy-glib-svc-client.html">Service-side Client interfaces</a></span><span class="refpurpose"> — interfaces used to be an Observer, Approver and Handler</span>
97 </dt>
8098 </dl></div>
8199 </div>
82100 <div class="footer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side handle repositories</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
88 <link rel="prev" href="telepathy-glib-TpMessageMixin.html" title="TpMessageMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Utilities</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="index.html" title="telepathy-glib Reference Manual">
88 <link rel="prev" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>telepathy-glib Reference Manual</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="next" href="ch-dbus.html" title="General D-Bus support">
88 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
139139 <dt>
140140 <span class="refentrytitle"><a href="telepathy-glib-media-interfaces.html">TpMediaSessionHandler, TpMediaStreamHandler</a></span><span class="refpurpose"> — proxy objects for Telepathy media streaming</span>
141141 </dt>
142 <dt>
143 <span class="refentrytitle"><a href="telepathy-glib-account-manager.html">TpAccountManager</a></span><span class="refpurpose"> — proxy object for the Telepathy account manager</span>
144 </dt>
145 <dt>
146 <span class="refentrytitle"><a href="telepathy-glib-account.html">TpAccount</a></span><span class="refpurpose"> — proxy object for an account in the Telepathy account
147 manager</span>
148 </dt>
149 <dt>
150 <span class="refentrytitle"><a href="telepathy-glib-channel-dispatcher.html">TpChannelDispatcher</a></span><span class="refpurpose"> — proxy object for the Telepathy channel dispatcher</span>
151 </dt>
152 <dt>
153 <span class="refentrytitle"><a href="telepathy-glib-channel-dispatch-operation.html">TpChannelDispatchOperation</a></span><span class="refpurpose"> — proxy object for a to the Telepathy channel
154 dispatcher</span>
155 </dt>
156 <dt>
157 <span class="refentrytitle"><a href="telepathy-glib-channel-request.html">TpChannelRequest</a></span><span class="refpurpose"> — proxy object for a request to the Telepathy channel
158 dispatcher</span>
159 </dt>
160 <dt>
161 <span class="refentrytitle"><a href="telepathy-glib-client.html">TpClient</a></span><span class="refpurpose"> — proxy object for a client of the ChannelDispatcher</span>
162 </dt>
142163 </dl></dd>
143164 <dt><span class="chapter"><a href="ch-service-dbus.html">Service-side D-Bus interfaces</a></span></dt>
144165 <dd><dl>
189210 </dt>
190211 <dt>
191212 <span class="refentrytitle"><a href="telepathy-glib-svc-connection-manager.html">Service-side Connection Manager interface</a></span><span class="refpurpose"> — GInterface for Telepathy ConnectionManager objects</span>
213 </dt>
214 <dt>
215 <span class="refentrytitle"><a href="telepathy-glib-svc-account-manager.html">Service-side Account Manager interface</a></span><span class="refpurpose"> — GInterface for Telepathy AccountManager objects</span>
216 </dt>
217 <dt>
218 <span class="refentrytitle"><a href="telepathy-glib-svc-account.html">Service-side Account interfaces</a></span><span class="refpurpose"> — GInterfaces for Telepathy Account objects</span>
219 </dt>
220 <dt>
221 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-dispatcher.html">Service-side Channel Dispatcher interface</a></span><span class="refpurpose"> — GInterfaces for Telepathy ChannelDispatcher object</span>
222 </dt>
223 <dt>
224 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-dispatch-operation.html">Service-side Channel Dispatch Operation interface</a></span><span class="refpurpose"> — GInterface for Telepathy ChannelDispatchOperation object</span>
225 </dt>
226 <dt>
227 <span class="refentrytitle"><a href="telepathy-glib-svc-channel-request.html">Service-side Channel Request interface</a></span><span class="refpurpose"> — GInterface for Telepathy ChannelRequest object</span>
228 </dt>
229 <dt>
230 <span class="refentrytitle"><a href="telepathy-glib-svc-client.html">Service-side Client interfaces</a></span><span class="refpurpose"> — interfaces used to be an Observer, Approver and Handler</span>
192231 </dt>
193232 </dl></dd>
194233 <dt><span class="chapter"><a href="ch-service-base.html">Service-side implementation</a></span></dt>
100100 <ANCHOR id="tp-dbus-daemon-release-name" href="telepathy-glib/telepathy-glib-dbus.html#tp-dbus-daemon-release-name">
101101 <ANCHOR id="tp-dbus-daemon-request-name" href="telepathy-glib/telepathy-glib-dbus.html#tp-dbus-daemon-request-name">
102102 <ANCHOR id="tp-dbus-daemon-watch-name-owner" href="telepathy-glib/telepathy-glib-dbus.html#tp-dbus-daemon-watch-name-owner">
103 <ANCHOR id="tp-dbus-daemon-init-known-interfaces" href="telepathy-glib/telepathy-glib-dbus.html#tp-dbus-daemon-init-known-interfaces">
103104 <ANCHOR id="tp-cli-dbus-daemon-call-add-match" href="telepathy-glib/telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-add-match">
104105 <ANCHOR id="tp-cli-dbus-daemon-call-get-connection-se-linux-security-context" href="telepathy-glib/telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-se-linux-security-context">
105106 <ANCHOR id="tp-cli-dbus-daemon-call-get-connection-unix-process-id" href="telepathy-glib/telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-unix-process-id">
219220 <ANCHOR id="TP-CM-OBJECT-PATH-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CM-OBJECT-PATH-BASE--CAPS">
220221 <ANCHOR id="TP-CONN-BUS-NAME-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CONN-BUS-NAME-BASE--CAPS">
221222 <ANCHOR id="TP-CONN-OBJECT-PATH-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CONN-OBJECT-PATH-BASE--CAPS">
223 <ANCHOR id="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-BUS-NAME--CAPS">
224 <ANCHOR id="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS">
225 <ANCHOR id="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-ACCOUNT-OBJECT-PATH-BASE--CAPS">
226 <ANCHOR id="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS">
227 <ANCHOR id="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS">
228 <ANCHOR id="TP-CLIENT-BUS-NAME-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE--CAPS">
229 <ANCHOR id="TP-CLIENT-OBJECT-PATH-BASE--CAPS" href="telepathy-glib/telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE--CAPS">
222230 <ANCHOR id="telepathy-glib-handle" href="telepathy-glib/telepathy-glib-handle.html">
223231 <ANCHOR id="telepathy-glib-handle.synopsis" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.synopsis">
224232 <ANCHOR id="telepathy-glib-handle.description" href="telepathy-glib/telepathy-glib-handle.html#telepathy-glib-handle.description">
233241 <ANCHOR id="telepathy-glib-interfaces.synopsis" href="telepathy-glib/telepathy-glib-interfaces.html#telepathy-glib-interfaces.synopsis">
234242 <ANCHOR id="telepathy-glib-interfaces.description" href="telepathy-glib/telepathy-glib-interfaces.html#telepathy-glib-interfaces.description">
235243 <ANCHOR id="telepathy-glib-interfaces.details" href="telepathy-glib/telepathy-glib-interfaces.html#telepathy-glib-interfaces.details">
244 <ANCHOR id="TP-IFACE-ACCOUNT--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT--CAPS">
245 <ANCHOR id="TP-IFACE-QUARK-ACCOUNT--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT--CAPS">
246 <ANCHOR id="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS">
247 <ANCHOR id="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS">
248 <ANCHOR id="TP-IFACE-ACCOUNT-MANAGER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER--CAPS">
249 <ANCHOR id="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS">
236250 <ANCHOR id="TP-IFACE-DBUS-DAEMON--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON--CAPS">
237251 <ANCHOR id="TP-IFACE-QUARK-DBUS-DAEMON--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-DBUS-DAEMON--CAPS">
238252 <ANCHOR id="TP-IFACE-DBUS-INTROSPECTABLE--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-DBUS-INTROSPECTABLE--CAPS">
297311 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS">
298312 <ANCHOR id="TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS">
299313 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS">
314 <ANCHOR id="TP-IFACE-CHANNEL-DISPATCHER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER--CAPS">
315 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS">
316 <ANCHOR id="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">
317 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">
318 <ANCHOR id="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS">
319 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS">
320 <ANCHOR id="TP-IFACE-CHANNEL-REQUEST--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-REQUEST--CAPS">
321 <ANCHOR id="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS">
300322 <ANCHOR id="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-MEDIA-SESSION-HANDLER--CAPS">
301323 <ANCHOR id="TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS">
302324 <ANCHOR id="TP-IFACE-MEDIA-STREAM-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-MEDIA-STREAM-HANDLER--CAPS">
303325 <ANCHOR id="TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS">
304326 <ANCHOR id="TP-IFACE-PROPERTIES-INTERFACE--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-PROPERTIES-INTERFACE--CAPS">
305327 <ANCHOR id="TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS">
328 <ANCHOR id="TP-IFACE-CLIENT--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CLIENT--CAPS">
329 <ANCHOR id="TP-IFACE-QUARK-CLIENT--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT--CAPS">
330 <ANCHOR id="TP-IFACE-CLIENT-APPROVER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CLIENT-APPROVER--CAPS">
331 <ANCHOR id="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-APPROVER--CAPS">
332 <ANCHOR id="TP-IFACE-CLIENT-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CLIENT-HANDLER--CAPS">
333 <ANCHOR id="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-HANDLER--CAPS">
334 <ANCHOR id="TP-IFACE-CLIENT-OBSERVER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CLIENT-OBSERVER--CAPS">
335 <ANCHOR id="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS">
336 <ANCHOR id="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS">
337 <ANCHOR id="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS" href="telepathy-glib/telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS">
306338 <ANCHOR id="telepathy-glib-enums" href="telepathy-glib/telepathy-glib-enums.html">
307339 <ANCHOR id="telepathy-glib-enums.synopsis" href="telepathy-glib/telepathy-glib-enums.html#telepathy-glib-enums.synopsis">
308340 <ANCHOR id="telepathy-glib-enums.description" href="telepathy-glib/telepathy-glib-enums.html#telepathy-glib-enums.description">
501533 <ANCHOR id="TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS">
502534 <ANCHOR id="TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS">
503535 <ANCHOR id="TP-STRUCT-TYPE-ROOM-INFO--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ROOM-INFO--CAPS">
536 <ANCHOR id="TP-STRUCT-TYPE-AVATAR--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-AVATAR--CAPS">
537 <ANCHOR id="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS">
538 <ANCHOR id="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS" href="telepathy-glib/telepathy-glib-gtypes.html#TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS">
504539 <ANCHOR id="TpChannelIface" href="telepathy-glib/TpChannelIface.html">
505540 <ANCHOR id="TpChannelIface.synopsis" href="telepathy-glib/TpChannelIface.html#TpChannelIface.synopsis">
506541 <ANCHOR id="TpChannelIface.object-hierarchy" href="telepathy-glib/TpChannelIface.html#TpChannelIface.object-hierarchy">
556591 <ANCHOR id="tp-connection-manager-param-get-default" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-connection-manager-param-get-default">
557592 <ANCHOR id="tp-connection-manager-check-valid-name" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-name">
558593 <ANCHOR id="tp-connection-manager-check-valid-protocol-name" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-protocol-name">
594 <ANCHOR id="tp-connection-manager-init-known-interfaces" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-connection-manager-init-known-interfaces">
559595 <ANCHOR id="tp-cli-connection-manager-callback-for-get-parameters" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-cli-connection-manager-callback-for-get-parameters">
560596 <ANCHOR id="tp-cli-connection-manager-call-get-parameters" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-cli-connection-manager-call-get-parameters">
561597 <ANCHOR id="tp-cli-connection-manager-run-get-parameters" href="telepathy-glib/telepathy-glib-connection-manager.html#tp-cli-connection-manager-run-get-parameters">
11471183 <ANCHOR id="telepathy-glib-media-interfaces.description" href="telepathy-glib/telepathy-glib-media-interfaces.html#telepathy-glib-media-interfaces.description">
11481184 <ANCHOR id="telepathy-glib-media-interfaces.details" href="telepathy-glib/telepathy-glib-media-interfaces.html#telepathy-glib-media-interfaces.details">
11491185 <ANCHOR id="tp-media-session-handler-new" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-media-session-handler-new">
1186 <ANCHOR id="tp-media-session-handler-init-known-interfaces" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-media-session-handler-init-known-interfaces">
11501187 <ANCHOR id="TpMediaSessionHandler-struct" href="telepathy-glib/telepathy-glib-media-interfaces.html#TpMediaSessionHandler-struct">
11511188 <ANCHOR id="TpMediaSessionHandlerClass" href="telepathy-glib/telepathy-glib-media-interfaces.html#TpMediaSessionHandlerClass">
11521189 <ANCHOR id="tp-media-stream-handler-new" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-media-stream-handler-new">
1190 <ANCHOR id="tp-media-stream-handler-init-known-interfaces" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-media-stream-handler-init-known-interfaces">
11531191 <ANCHOR id="TpMediaStreamHandler-struct" href="telepathy-glib/telepathy-glib-media-interfaces.html#TpMediaStreamHandler-struct">
11541192 <ANCHOR id="TpMediaStreamHandlerClass" href="telepathy-glib/telepathy-glib-media-interfaces.html#TpMediaStreamHandlerClass">
11551193 <ANCHOR id="tp-cli-media-session-handler-callback-for-error" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-cli-media-session-handler-callback-for-error">
12191257 <ANCHOR id="tp-cli-media-stream-handler-callback-for-codecs-updated" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-callback-for-codecs-updated">
12201258 <ANCHOR id="tp-cli-media-stream-handler-run-codecs-updated" href="telepathy-glib/telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-run-codecs-updated">
12211259 <ANCHOR id="telepathy-glib-media-interfaces.see-also" href="telepathy-glib/telepathy-glib-media-interfaces.html#telepathy-glib-media-interfaces.see-also">
1260 <ANCHOR id="telepathy-glib-account-manager" href="telepathy-glib/telepathy-glib-account-manager.html">
1261 <ANCHOR id="telepathy-glib-account-manager.synopsis" href="telepathy-glib/telepathy-glib-account-manager.html#telepathy-glib-account-manager.synopsis">
1262 <ANCHOR id="TpAccountManager" href="telepathy-glib/telepathy-glib-account-manager.html#TpAccountManager">
1263 <ANCHOR id="telepathy-glib-account-manager.object-hierarchy" href="telepathy-glib/telepathy-glib-account-manager.html#telepathy-glib-account-manager.object-hierarchy">
1264 <ANCHOR id="telepathy-glib-account-manager.description" href="telepathy-glib/telepathy-glib-account-manager.html#telepathy-glib-account-manager.description">
1265 <ANCHOR id="telepathy-glib-account-manager.details" href="telepathy-glib/telepathy-glib-account-manager.html#telepathy-glib-account-manager.details">
1266 <ANCHOR id="TpAccountManager-struct" href="telepathy-glib/telepathy-glib-account-manager.html#TpAccountManager-struct">
1267 <ANCHOR id="TpAccountManagerClass" href="telepathy-glib/telepathy-glib-account-manager.html#TpAccountManagerClass">
1268 <ANCHOR id="tp-account-manager-new" href="telepathy-glib/telepathy-glib-account-manager.html#tp-account-manager-new">
1269 <ANCHOR id="tp-account-manager-init-known-interfaces" href="telepathy-glib/telepathy-glib-account-manager.html#tp-account-manager-init-known-interfaces">
1270 <ANCHOR id="tp-cli-account-manager-callback-for-create-account" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account">
1271 <ANCHOR id="tp-cli-account-manager-call-create-account" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-call-create-account">
1272 <ANCHOR id="tp-cli-account-manager-signal-callback-account-removed" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed">
1273 <ANCHOR id="tp-cli-account-manager-connect-to-account-removed" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-removed">
1274 <ANCHOR id="tp-cli-account-manager-signal-callback-account-validity-changed" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed">
1275 <ANCHOR id="tp-cli-account-manager-connect-to-account-validity-changed" href="telepathy-glib/telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-validity-changed">
1276 <ANCHOR id="telepathy-glib-account-manager.see-also" href="telepathy-glib/telepathy-glib-account-manager.html#telepathy-glib-account-manager.see-also">
1277 <ANCHOR id="telepathy-glib-account" href="telepathy-glib/telepathy-glib-account.html">
1278 <ANCHOR id="telepathy-glib-account.synopsis" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.synopsis">
1279 <ANCHOR id="TpAccount" href="telepathy-glib/telepathy-glib-account.html#TpAccount">
1280 <ANCHOR id="telepathy-glib-account.object-hierarchy" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.object-hierarchy">
1281 <ANCHOR id="telepathy-glib-account.description" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.description">
1282 <ANCHOR id="telepathy-glib-account.details" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.details">
1283 <ANCHOR id="TpAccount-struct" href="telepathy-glib/telepathy-glib-account.html#TpAccount-struct">
1284 <ANCHOR id="TpAccountClass" href="telepathy-glib/telepathy-glib-account.html#TpAccountClass">
1285 <ANCHOR id="tp-account-new" href="telepathy-glib/telepathy-glib-account.html#tp-account-new">
1286 <ANCHOR id="tp-account-init-known-interfaces" href="telepathy-glib/telepathy-glib-account.html#tp-account-init-known-interfaces">
1287 <ANCHOR id="tp-cli-account-callback-for-reconnect" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-callback-for-reconnect">
1288 <ANCHOR id="tp-cli-account-call-reconnect" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-call-reconnect">
1289 <ANCHOR id="tp-cli-account-callback-for-remove" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-callback-for-remove">
1290 <ANCHOR id="tp-cli-account-call-remove" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-call-remove">
1291 <ANCHOR id="tp-cli-account-callback-for-update-parameters" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters">
1292 <ANCHOR id="tp-cli-account-call-update-parameters" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-call-update-parameters">
1293 <ANCHOR id="tp-cli-account-signal-callback-account-property-changed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed">
1294 <ANCHOR id="tp-cli-account-connect-to-account-property-changed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-connect-to-account-property-changed">
1295 <ANCHOR id="tp-cli-account-signal-callback-removed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-signal-callback-removed">
1296 <ANCHOR id="tp-cli-account-connect-to-removed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-connect-to-removed">
1297 <ANCHOR id="tp-cli-account-interface-avatar-signal-callback-avatar-changed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed">
1298 <ANCHOR id="tp-cli-account-interface-avatar-connect-to-avatar-changed" href="telepathy-glib/telepathy-glib-account.html#tp-cli-account-interface-avatar-connect-to-avatar-changed">
1299 <ANCHOR id="telepathy-glib-account.see-also" href="telepathy-glib/telepathy-glib-account.html#telepathy-glib-account.see-also">
1300 <ANCHOR id="telepathy-glib-channel-dispatcher" href="telepathy-glib/telepathy-glib-channel-dispatcher.html">
1301 <ANCHOR id="telepathy-glib-channel-dispatcher.synopsis" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#telepathy-glib-channel-dispatcher.synopsis">
1302 <ANCHOR id="TpChannelDispatcher" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">
1303 <ANCHOR id="telepathy-glib-channel-dispatcher.object-hierarchy" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#telepathy-glib-channel-dispatcher.object-hierarchy">
1304 <ANCHOR id="telepathy-glib-channel-dispatcher.description" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#telepathy-glib-channel-dispatcher.description">
1305 <ANCHOR id="telepathy-glib-channel-dispatcher.details" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#telepathy-glib-channel-dispatcher.details">
1306 <ANCHOR id="TpChannelDispatcher-struct" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#TpChannelDispatcher-struct">
1307 <ANCHOR id="TpChannelDispatcherClass" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#TpChannelDispatcherClass">
1308 <ANCHOR id="tp-channel-dispatcher-new" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-new">
1309 <ANCHOR id="tp-channel-dispatcher-init-known-interfaces" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-init-known-interfaces">
1310 <ANCHOR id="tp-cli-channel-dispatcher-callback-for-create-channel" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel">
1311 <ANCHOR id="tp-cli-channel-dispatcher-call-create-channel" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-create-channel">
1312 <ANCHOR id="tp-cli-channel-dispatcher-callback-for-ensure-channel" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel">
1313 <ANCHOR id="tp-cli-channel-dispatcher-call-ensure-channel" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-ensure-channel">
1314 <ANCHOR id="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished">
1315 <ANCHOR id="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished">
1316 <ANCHOR id="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation">
1317 <ANCHOR id="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation">
1318 <ANCHOR id="telepathy-glib-channel-dispatcher.see-also" href="telepathy-glib/telepathy-glib-channel-dispatcher.html#telepathy-glib-channel-dispatcher.see-also">
1319 <ANCHOR id="telepathy-glib-channel-dispatch-operation" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html">
1320 <ANCHOR id="telepathy-glib-channel-dispatch-operation.synopsis" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#telepathy-glib-channel-dispatch-operation.synopsis">
1321 <ANCHOR id="TpChannelDispatchOperation" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">
1322 <ANCHOR id="telepathy-glib-channel-dispatch-operation.object-hierarchy" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#telepathy-glib-channel-dispatch-operation.object-hierarchy">
1323 <ANCHOR id="telepathy-glib-channel-dispatch-operation.description" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#telepathy-glib-channel-dispatch-operation.description">
1324 <ANCHOR id="telepathy-glib-channel-dispatch-operation.details" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#telepathy-glib-channel-dispatch-operation.details">
1325 <ANCHOR id="TpChannelDispatchOperation-struct" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-struct">
1326 <ANCHOR id="TpChannelDispatchOperationClass" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperationClass">
1327 <ANCHOR id="tp-channel-dispatch-operation-new" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-new">
1328 <ANCHOR id="tp-channel-dispatch-operation-init-known-interfaces" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-init-known-interfaces">
1329 <ANCHOR id="tp-cli-channel-dispatch-operation-callback-for-claim" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim">
1330 <ANCHOR id="tp-cli-channel-dispatch-operation-call-claim" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim">
1331 <ANCHOR id="tp-cli-channel-dispatch-operation-callback-for-handle-with" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with">
1332 <ANCHOR id="tp-cli-channel-dispatch-operation-call-handle-with" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with">
1333 <ANCHOR id="tp-cli-channel-dispatch-operation-signal-callback-channel-lost" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost">
1334 <ANCHOR id="tp-cli-channel-dispatch-operation-connect-to-channel-lost" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost">
1335 <ANCHOR id="tp-cli-channel-dispatch-operation-signal-callback-finished" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished">
1336 <ANCHOR id="tp-cli-channel-dispatch-operation-connect-to-finished" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished">
1337 <ANCHOR id="telepathy-glib-channel-dispatch-operation.see-also" href="telepathy-glib/telepathy-glib-channel-dispatch-operation.html#telepathy-glib-channel-dispatch-operation.see-also">
1338 <ANCHOR id="telepathy-glib-channel-request" href="telepathy-glib/telepathy-glib-channel-request.html">
1339 <ANCHOR id="telepathy-glib-channel-request.synopsis" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.synopsis">
1340 <ANCHOR id="TpChannelRequest" href="telepathy-glib/telepathy-glib-channel-request.html#TpChannelRequest">
1341 <ANCHOR id="telepathy-glib-channel-request.object-hierarchy" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.object-hierarchy">
1342 <ANCHOR id="telepathy-glib-channel-request.signals" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.signals">
1343 <ANCHOR id="telepathy-glib-channel-request.description" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.description">
1344 <ANCHOR id="telepathy-glib-channel-request.details" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.details">
1345 <ANCHOR id="TpChannelRequest-struct" href="telepathy-glib/telepathy-glib-channel-request.html#TpChannelRequest-struct">
1346 <ANCHOR id="TpChannelRequestClass" href="telepathy-glib/telepathy-glib-channel-request.html#TpChannelRequestClass">
1347 <ANCHOR id="tp-channel-request-new" href="telepathy-glib/telepathy-glib-channel-request.html#tp-channel-request-new">
1348 <ANCHOR id="tp-channel-request-init-known-interfaces" href="telepathy-glib/telepathy-glib-channel-request.html#tp-channel-request-init-known-interfaces">
1349 <ANCHOR id="tp-cli-channel-request-callback-for-cancel" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel">
1350 <ANCHOR id="tp-cli-channel-request-call-cancel" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-call-cancel">
1351 <ANCHOR id="tp-cli-channel-request-callback-for-proceed" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed">
1352 <ANCHOR id="tp-cli-channel-request-call-proceed" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-call-proceed">
1353 <ANCHOR id="tp-cli-channel-request-signal-callback-failed" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed">
1354 <ANCHOR id="tp-cli-channel-request-connect-to-failed" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-failed">
1355 <ANCHOR id="tp-cli-channel-request-signal-callback-succeeded" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded">
1356 <ANCHOR id="tp-cli-channel-request-connect-to-succeeded" href="telepathy-glib/telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-succeeded">
1357 <ANCHOR id="telepathy-glib-channel-request.signal-details" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.signal-details">
1358 <ANCHOR id="TpChannelRequest-succeeded" href="telepathy-glib/telepathy-glib-channel-request.html#TpChannelRequest-succeeded">
1359 <ANCHOR id="telepathy-glib-channel-request.see-also" href="telepathy-glib/telepathy-glib-channel-request.html#telepathy-glib-channel-request.see-also">
1360 <ANCHOR id="telepathy-glib-client" href="telepathy-glib/telepathy-glib-client.html">
1361 <ANCHOR id="telepathy-glib-client.synopsis" href="telepathy-glib/telepathy-glib-client.html#telepathy-glib-client.synopsis">
1362 <ANCHOR id="TpClient" href="telepathy-glib/telepathy-glib-client.html#TpClient">
1363 <ANCHOR id="telepathy-glib-client.object-hierarchy" href="telepathy-glib/telepathy-glib-client.html#telepathy-glib-client.object-hierarchy">
1364 <ANCHOR id="telepathy-glib-client.description" href="telepathy-glib/telepathy-glib-client.html#telepathy-glib-client.description">
1365 <ANCHOR id="telepathy-glib-client.details" href="telepathy-glib/telepathy-glib-client.html#telepathy-glib-client.details">
1366 <ANCHOR id="TpClient-struct" href="telepathy-glib/telepathy-glib-client.html#TpClient-struct">
1367 <ANCHOR id="TpClientClass" href="telepathy-glib/telepathy-glib-client.html#TpClientClass">
1368 <ANCHOR id="tp-client-init-known-interfaces" href="telepathy-glib/telepathy-glib-client.html#tp-client-init-known-interfaces">
1369 <ANCHOR id="tp-cli-client-observer-callback-for-observe-channels" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels">
1370 <ANCHOR id="tp-cli-client-observer-call-observe-channels" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-observer-call-observe-channels">
1371 <ANCHOR id="tp-cli-client-handler-callback-for-handle-channels" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels">
1372 <ANCHOR id="tp-cli-client-handler-call-handle-channels" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-handler-call-handle-channels">
1373 <ANCHOR id="tp-cli-client-interface-requests-callback-for-add-request" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-add-request">
1374 <ANCHOR id="tp-cli-client-interface-requests-call-add-request" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-interface-requests-call-add-request">
1375 <ANCHOR id="tp-cli-client-interface-requests-callback-for-remove-request" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request">
1376 <ANCHOR id="tp-cli-client-interface-requests-call-remove-request" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-interface-requests-call-remove-request">
1377 <ANCHOR id="tp-cli-client-approver-callback-for-add-dispatch-operation" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation">
1378 <ANCHOR id="tp-cli-client-approver-call-add-dispatch-operation" href="telepathy-glib/telepathy-glib-client.html#tp-cli-client-approver-call-add-dispatch-operation">
12221379 <ANCHOR id="telepathy-glib-svc" href="telepathy-glib/telepathy-glib-svc.html">
12231380 <ANCHOR id="telepathy-glib-svc-generic" href="telepathy-glib/telepathy-glib-svc-generic.html">
12241381 <ANCHOR id="telepathy-glib-svc-generic.synopsis" href="telepathy-glib/telepathy-glib-svc-generic.html#telepathy-glib-svc-generic.synopsis">
18772034 <ANCHOR id="telepathy-glib-svc-connection-manager.signal-details" href="telepathy-glib/telepathy-glib-svc-connection-manager.html#telepathy-glib-svc-connection-manager.signal-details">
18782035 <ANCHOR id="TpSvcConnectionManager-new-connection" href="telepathy-glib/telepathy-glib-svc-connection-manager.html#TpSvcConnectionManager-new-connection">
18792036 <ANCHOR id="telepathy-glib-svc-connection-manager.see-also" href="telepathy-glib/telepathy-glib-svc-connection-manager.html#telepathy-glib-svc-connection-manager.see-also">
2037 <ANCHOR id="telepathy-glib-svc-account-manager" href="telepathy-glib/telepathy-glib-svc-account-manager.html">
2038 <ANCHOR id="telepathy-glib-svc-account-manager.synopsis" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.synopsis">
2039 <ANCHOR id="TpSvcAccountManager" href="telepathy-glib/telepathy-glib-svc-account-manager.html#TpSvcAccountManager">
2040 <ANCHOR id="telepathy-glib-svc-account-manager.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.object-hierarchy">
2041 <ANCHOR id="telepathy-glib-svc-account-manager.signals" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.signals">
2042 <ANCHOR id="telepathy-glib-svc-account-manager.description" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.description">
2043 <ANCHOR id="telepathy-glib-svc-account-manager.details" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.details">
2044 <ANCHOR id="TpSvcAccountManager-struct" href="telepathy-glib/telepathy-glib-svc-account-manager.html#TpSvcAccountManager-struct">
2045 <ANCHOR id="TpSvcAccountManagerClass" href="telepathy-glib/telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass">
2046 <ANCHOR id="tp-svc-account-manager-emit-account-removed" href="telepathy-glib/telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-removed">
2047 <ANCHOR id="tp-svc-account-manager-emit-account-validity-changed" href="telepathy-glib/telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-validity-changed">
2048 <ANCHOR id="tp-svc-account-manager-create-account-impl" href="telepathy-glib/telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl">
2049 <ANCHOR id="tp-svc-account-manager-return-from-create-account" href="telepathy-glib/telepathy-glib-svc-account-manager.html#tp-svc-account-manager-return-from-create-account">
2050 <ANCHOR id="tp-svc-account-manager-implement-create-account" href="telepathy-glib/telepathy-glib-svc-account-manager.html#tp-svc-account-manager-implement-create-account">
2051 <ANCHOR id="telepathy-glib-svc-account-manager.signal-details" href="telepathy-glib/telepathy-glib-svc-account-manager.html#telepathy-glib-svc-account-manager.signal-details">
2052 <ANCHOR id="TpSvcAccountManager-account-removed" href="telepathy-glib/telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-removed">
2053 <ANCHOR id="TpSvcAccountManager-account-validity-changed" href="telepathy-glib/telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-validity-changed">
2054 <ANCHOR id="telepathy-glib-svc-account" href="telepathy-glib/telepathy-glib-svc-account.html">
2055 <ANCHOR id="telepathy-glib-svc-account.synopsis" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.synopsis">
2056 <ANCHOR id="TpSvcAccount" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount">
2057 <ANCHOR id="TpSvcAccountInterfaceAvatar" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar">
2058 <ANCHOR id="telepathy-glib-svc-account.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.object-hierarchy">
2059 <ANCHOR id="telepathy-glib-svc-account.signals" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.signals">
2060 <ANCHOR id="telepathy-glib-svc-account.description" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.description">
2061 <ANCHOR id="telepathy-glib-svc-account.details" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.details">
2062 <ANCHOR id="TpSvcAccount-struct" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount-struct">
2063 <ANCHOR id="TpSvcAccountClass" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountClass">
2064 <ANCHOR id="tp-svc-account-emit-account-property-changed" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-emit-account-property-changed">
2065 <ANCHOR id="tp-svc-account-emit-removed" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-emit-removed">
2066 <ANCHOR id="tp-svc-account-reconnect-impl" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl">
2067 <ANCHOR id="tp-svc-account-return-from-reconnect" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-return-from-reconnect">
2068 <ANCHOR id="tp-svc-account-implement-reconnect" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-implement-reconnect">
2069 <ANCHOR id="tp-svc-account-remove-impl" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-remove-impl">
2070 <ANCHOR id="tp-svc-account-return-from-remove" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-return-from-remove">
2071 <ANCHOR id="tp-svc-account-implement-remove" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-implement-remove">
2072 <ANCHOR id="tp-svc-account-update-parameters-impl" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl">
2073 <ANCHOR id="tp-svc-account-return-from-update-parameters" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-return-from-update-parameters">
2074 <ANCHOR id="tp-svc-account-implement-update-parameters" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-implement-update-parameters">
2075 <ANCHOR id="TpSvcAccountInterfaceAvatar-struct" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct">
2076 <ANCHOR id="TpSvcAccountInterfaceAvatarClass" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass">
2077 <ANCHOR id="tp-svc-account-interface-avatar-emit-avatar-changed" href="telepathy-glib/telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed">
2078 <ANCHOR id="telepathy-glib-svc-account.signal-details" href="telepathy-glib/telepathy-glib-svc-account.html#telepathy-glib-svc-account.signal-details">
2079 <ANCHOR id="TpSvcAccount-account-property-changed" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed">
2080 <ANCHOR id="TpSvcAccount-removed" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccount-removed">
2081 <ANCHOR id="TpSvcAccountInterfaceAvatar-avatar-changed" href="telepathy-glib/telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed">
2082 <ANCHOR id="telepathy-glib-svc-channel-dispatcher" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html">
2083 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.synopsis" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.synopsis">
2084 <ANCHOR id="TpSvcChannelDispatcher" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher">
2085 <ANCHOR id="TpSvcChannelDispatcherInterfaceOperationList" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList">
2086 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.object-hierarchy">
2087 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.signals" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.signals">
2088 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.description" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.description">
2089 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.details" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.details">
2090 <ANCHOR id="TpSvcChannelDispatcher-struct" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher-struct">
2091 <ANCHOR id="TpSvcChannelDispatcherClass" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass">
2092 <ANCHOR id="tp-svc-channel-dispatcher-return-from-create-channel" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-create-channel">
2093 <ANCHOR id="tp-svc-channel-dispatcher-create-channel-impl" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl">
2094 <ANCHOR id="tp-svc-channel-dispatcher-implement-create-channel" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-create-channel">
2095 <ANCHOR id="tp-svc-channel-dispatcher-return-from-ensure-channel" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-ensure-channel">
2096 <ANCHOR id="tp-svc-channel-dispatcher-ensure-channel-impl" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl">
2097 <ANCHOR id="tp-svc-channel-dispatcher-implement-ensure-channel" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-ensure-channel">
2098 <ANCHOR id="TpSvcChannelDispatcherInterfaceOperationList-struct" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-struct">
2099 <ANCHOR id="TpSvcChannelDispatcherInterfaceOperationListClass" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationListClass">
2100 <ANCHOR id="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation">
2101 <ANCHOR id="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished">
2102 <ANCHOR id="telepathy-glib-svc-channel-dispatcher.signal-details" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#telepathy-glib-svc-channel-dispatcher.signal-details">
2103 <ANCHOR id="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished">
2104 <ANCHOR id="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation" href="telepathy-glib/telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation">
2105 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html">
2106 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.synopsis" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.synopsis">
2107 <ANCHOR id="TpSvcChannelDispatchOperation" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">
2108 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.object-hierarchy">
2109 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.signals" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.signals">
2110 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.description" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.description">
2111 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.details" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.details">
2112 <ANCHOR id="TpSvcChannelDispatchOperation-struct" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-struct">
2113 <ANCHOR id="TpSvcChannelDispatchOperationClass" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass">
2114 <ANCHOR id="tp-svc-channel-dispatch-operation-return-from-claim" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-claim">
2115 <ANCHOR id="tp-svc-channel-dispatch-operation-claim-impl" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl">
2116 <ANCHOR id="tp-svc-channel-dispatch-operation-implement-claim" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-claim">
2117 <ANCHOR id="tp-svc-channel-dispatch-operation-return-from-handle-with" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-handle-with">
2118 <ANCHOR id="tp-svc-channel-dispatch-operation-handle-with-impl" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl">
2119 <ANCHOR id="tp-svc-channel-dispatch-operation-implement-handle-with" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-handle-with">
2120 <ANCHOR id="tp-svc-channel-dispatch-operation-emit-channel-lost" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-channel-lost">
2121 <ANCHOR id="tp-svc-channel-dispatch-operation-emit-finished" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-finished">
2122 <ANCHOR id="telepathy-glib-svc-channel-dispatch-operation.signal-details" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#telepathy-glib-svc-channel-dispatch-operation.signal-details">
2123 <ANCHOR id="TpSvcChannelDispatchOperation-channel-lost" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-channel-lost">
2124 <ANCHOR id="TpSvcChannelDispatchOperation-finished" href="telepathy-glib/telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-finished">
2125 <ANCHOR id="telepathy-glib-svc-channel-request" href="telepathy-glib/telepathy-glib-svc-channel-request.html">
2126 <ANCHOR id="telepathy-glib-svc-channel-request.synopsis" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.synopsis">
2127 <ANCHOR id="TpSvcChannelRequest" href="telepathy-glib/telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">
2128 <ANCHOR id="telepathy-glib-svc-channel-request.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.object-hierarchy">
2129 <ANCHOR id="telepathy-glib-svc-channel-request.signals" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.signals">
2130 <ANCHOR id="telepathy-glib-svc-channel-request.description" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.description">
2131 <ANCHOR id="telepathy-glib-svc-channel-request.details" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.details">
2132 <ANCHOR id="TpSvcChannelRequest-struct" href="telepathy-glib/telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-struct">
2133 <ANCHOR id="TpSvcChannelRequestClass" href="telepathy-glib/telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass">
2134 <ANCHOR id="tp-svc-channel-request-return-from-proceed" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-proceed">
2135 <ANCHOR id="tp-svc-channel-request-proceed-impl" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl">
2136 <ANCHOR id="tp-svc-channel-request-implement-proceed" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-proceed">
2137 <ANCHOR id="tp-svc-channel-request-return-from-cancel" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-cancel">
2138 <ANCHOR id="tp-svc-channel-request-cancel-impl" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl">
2139 <ANCHOR id="tp-svc-channel-request-implement-cancel" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-cancel">
2140 <ANCHOR id="tp-svc-channel-request-emit-failed" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-failed">
2141 <ANCHOR id="tp-svc-channel-request-emit-succeeded" href="telepathy-glib/telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-succeeded">
2142 <ANCHOR id="telepathy-glib-svc-channel-request.signal-details" href="telepathy-glib/telepathy-glib-svc-channel-request.html#telepathy-glib-svc-channel-request.signal-details">
2143 <ANCHOR id="TpSvcChannelRequest-failed" href="telepathy-glib/telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-failed">
2144 <ANCHOR id="TpSvcChannelRequest-succeeded" href="telepathy-glib/telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-succeeded">
2145 <ANCHOR id="telepathy-glib-svc-client" href="telepathy-glib/telepathy-glib-svc-client.html">
2146 <ANCHOR id="telepathy-glib-svc-client.synopsis" href="telepathy-glib/telepathy-glib-svc-client.html#telepathy-glib-svc-client.synopsis">
2147 <ANCHOR id="TpSvcClient" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClient">
2148 <ANCHOR id="TpSvcClientApprover" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientApprover">
2149 <ANCHOR id="TpSvcClientHandler" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientHandler">
2150 <ANCHOR id="TpSvcClientInterfaceRequests" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests">
2151 <ANCHOR id="TpSvcClientObserver" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientObserver">
2152 <ANCHOR id="telepathy-glib-svc-client.object-hierarchy" href="telepathy-glib/telepathy-glib-svc-client.html#telepathy-glib-svc-client.object-hierarchy">
2153 <ANCHOR id="telepathy-glib-svc-client.description" href="telepathy-glib/telepathy-glib-svc-client.html#telepathy-glib-svc-client.description">
2154 <ANCHOR id="telepathy-glib-svc-client.details" href="telepathy-glib/telepathy-glib-svc-client.html#telepathy-glib-svc-client.details">
2155 <ANCHOR id="TpSvcClient-struct" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClient-struct">
2156 <ANCHOR id="TpSvcClientClass" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientClass">
2157 <ANCHOR id="TpSvcClientApprover-struct" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientApprover-struct">
2158 <ANCHOR id="TpSvcClientApproverClass" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientApproverClass">
2159 <ANCHOR id="tp-svc-client-approver-return-from-add-dispatch-operation" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-approver-return-from-add-dispatch-operation">
2160 <ANCHOR id="tp-svc-client-approver-add-dispatch-operation-impl" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl">
2161 <ANCHOR id="tp-svc-client-approver-implement-add-dispatch-operation" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-approver-implement-add-dispatch-operation">
2162 <ANCHOR id="TpSvcClientHandler-struct" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientHandler-struct">
2163 <ANCHOR id="TpSvcClientHandlerClass" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientHandlerClass">
2164 <ANCHOR id="tp-svc-client-handler-return-from-handle-channels" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-handler-return-from-handle-channels">
2165 <ANCHOR id="tp-svc-client-handler-handle-channels-impl" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl">
2166 <ANCHOR id="tp-svc-client-handler-implement-handle-channels" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-handler-implement-handle-channels">
2167 <ANCHOR id="TpSvcClientInterfaceRequests-struct" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests-struct">
2168 <ANCHOR id="TpSvcClientInterfaceRequestsClass" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass">
2169 <ANCHOR id="tp-svc-client-interface-requests-return-from-add-request" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-add-request">
2170 <ANCHOR id="tp-svc-client-interface-requests-add-request-impl" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl">
2171 <ANCHOR id="tp-svc-client-interface-requests-implement-add-request" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-add-request">
2172 <ANCHOR id="tp-svc-client-interface-requests-return-from-remove-request" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-remove-request">
2173 <ANCHOR id="tp-svc-client-interface-requests-remove-request-impl" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl">
2174 <ANCHOR id="tp-svc-client-interface-requests-implement-remove-request" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-remove-request">
2175 <ANCHOR id="TpSvcClientObserver-struct" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientObserver-struct">
2176 <ANCHOR id="TpSvcClientObserverClass" href="telepathy-glib/telepathy-glib-svc-client.html#TpSvcClientObserverClass">
2177 <ANCHOR id="tp-svc-client-observer-return-from-observe-channels" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-observer-return-from-observe-channels">
2178 <ANCHOR id="tp-svc-client-observer-observe-channels-impl" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl">
2179 <ANCHOR id="tp-svc-client-observer-implement-observe-channels" href="telepathy-glib/telepathy-glib-svc-client.html#tp-svc-client-observer-implement-observe-channels">
18802180 <ANCHOR id="telepathy-glib-run" href="telepathy-glib/telepathy-glib-run.html">
18812181 <ANCHOR id="telepathy-glib-run.synopsis" href="telepathy-glib/telepathy-glib-run.html#telepathy-glib-run.synopsis">
18822182 <ANCHOR id="telepathy-glib-run.description" href="telepathy-glib/telepathy-glib-run.html#telepathy-glib-run.description">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpContactsMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="TpChannelManager.html" title="TpChannelManager">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpGroupMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-TpPropertiesMixin.html" title="TpPropertiesMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpHeap</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-utilities.html" title="Utilities">
88 <link rel="prev" href="telepathy-glib-TpIntSet.html" title="TpIntSet">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpIntSet</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-utilities.html" title="Utilities">
88 <link rel="prev" href="telepathy-glib-debug.html" title="Common debug support">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpMessageMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-TpTextMixin.html" title="TpTextMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpPresenceMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="TpExportableChannel.html" title="TpExportableChannel">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpPropertiesMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-TpPresenceMixin.html" title="TpPresenceMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpTextMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-TpGroupMixin.html" title="TpGroupMixin">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpAccountManager</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-media-interfaces.html" title="TpMediaSessionHandler, TpMediaStreamHandler">
9 <link rel="next" href="telepathy-glib-account.html" title="TpAccount">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-media-interfaces.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-account.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-account-manager.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-account-manager.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-account-manager.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="TpAccountManager">
38 <a name="telepathy-glib-account-manager"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-account-manager.top_of_page"></a>TpAccountManager</span></h2>
42 <p>TpAccountManager — proxy object for the Telepathy account manager</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv" title="Synopsis">
47 <a name="telepathy-glib-account-manager.synopsis"></a><h2>Synopsis</h2>
48 <a name="TpAccountManager"></a><pre class="synopsis">
49
50 #include &lt;telepathy-glib/account-manager.h&gt;
51
52 <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-struct" title="TpAccountManager">TpAccountManager</a>;
53 <a class="link" href="telepathy-glib-account-manager.html#TpAccountManagerClass" title="TpAccountManagerClass">TpAccountManagerClass</a>;
54 <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-new" title="tp_account_manager_new ()">tp_account_manager_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon);
55 void <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-init-known-interfaces" title="tp_account_manager_init_known_interfaces ()">tp_account_manager_init_known_interfaces</a>
56 (void);
57
58 void (<a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account" title="tp_cli_account_manager_callback_for_create_account ()">*tp_cli_account_manager_callback_for_create_account</a>)
59 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
60 const <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
62 >gchar</a> *out_Account,
63 const <a
64 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
65 >GError</a> *error,
66 <a
67 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
68 >gpointer</a> user_data,
69 <a
70 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
71 >GObject</a> *weak_object);
72 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-call-create-account" title="tp_cli_account_manager_call_create_account ()">tp_cli_account_manager_call_create_account</a>
73 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
74 <a
75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
76 >gint</a> timeout_ms,
77 const <a
78 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
79 >gchar</a> *in_Connection_Manager,
80 const <a
81 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
82 >gchar</a> *in_Protocol,
83 const <a
84 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
85 >gchar</a> *in_Display_Name,
86 <a
87 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
88 >GHashTable</a> *in_Parameters,
89 <a
90 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
91 >GHashTable</a> *in_Properties,
92 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account" title="tp_cli_account_manager_callback_for_create_account ()">tp_cli_account_manager_callback_for_create_account</a> callback,
93 <a
94 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
95 >gpointer</a> user_data,
96 <a
97 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
98 >GDestroyNotify</a> destroy,
99 <a
100 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
101 >GObject</a> *weak_object);
102 void (<a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed" title="tp_cli_account_manager_signal_callback_account_removed ()">*tp_cli_account_manager_signal_callback_account_removed</a>)
103 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
104 const <a
105 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
106 >gchar</a> *arg_Account,
107 <a
108 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
109 >gpointer</a> user_data,
110 <a
111 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
112 >GObject</a> *weak_object);
113 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-removed" title="tp_cli_account_manager_connect_to_account_removed ()">tp_cli_account_manager_connect_to_account_removed</a>
114 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
115 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed" title="tp_cli_account_manager_signal_callback_account_removed ()">tp_cli_account_manager_signal_callback_account_removed</a> callback,
116 <a
117 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
118 >gpointer</a> user_data,
119 <a
120 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
121 >GDestroyNotify</a> destroy,
122 <a
123 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
124 >GObject</a> *weak_object,
125 <a
126 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
127 >GError</a> **error);
128 void (<a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed" title="tp_cli_account_manager_signal_callback_account_validity_changed ()">*tp_cli_account_manager_signal_callback_account_validity_changed</a>)
129 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
130 const <a
131 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
132 >gchar</a> *arg_Account,
133 <a
134 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
135 >gboolean</a> arg_Valid,
136 <a
137 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
138 >gpointer</a> user_data,
139 <a
140 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
141 >GObject</a> *weak_object);
142 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-validity-changed" title="tp_cli_account_manager_connect_to_account_validity_changed ()">tp_cli_account_manager_connect_to_account_validity_changed</a>
143 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
144 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed" title="tp_cli_account_manager_signal_callback_account_validity_changed ()">tp_cli_account_manager_signal_callback_account_validity_changed</a> callback,
145 <a
146 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
147 >gpointer</a> user_data,
148 <a
149 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
150 >GDestroyNotify</a> destroy,
151 <a
152 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
153 >GObject</a> *weak_object,
154 <a
155 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
156 >GError</a> **error);
157 </pre>
158 </div>
159 <div class="refsect1" title="Object Hierarchy">
160 <a name="telepathy-glib-account-manager.object-hierarchy"></a><h2>Object Hierarchy</h2>
161 <pre class="synopsis">
162 <a
163 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
164 >GObject</a>
165 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
166 +----TpAccountManager
167 </pre>
168 </div>
169 <div class="refsect1" title="Description">
170 <a name="telepathy-glib-account-manager.description"></a><h2>Description</h2>
171 <p>
172 The <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> object is used to communicate with the Telepathy
173 AccountManager service.</p>
174 <p>
175 </p>
176 </div>
177 <div class="refsect1" title="Details">
178 <a name="telepathy-glib-account-manager.details"></a><h2>Details</h2>
179 <div class="refsect2" title="TpAccountManager">
180 <a name="TpAccountManager-struct"></a><h3>TpAccountManager</h3>
181 <pre class="programlisting">typedef struct _TpAccountManager TpAccountManager;</pre>
182 <p>
183 The Telepathy Account Manager stores real-time communication accounts and
184 their configuration, places accounts online on request, and manipulates
185 accounts' presence, nicknames and avatars.
186 </p>
187 <p>
188 This proxy is usable but incomplete: GObject signals and accessors for the
189 D-Bus properties will be added in a later version of telepathy-glib, along
190 with a mechanism similar 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>.
191 </p>
192 <p>
193 Until suitable convenience methods are implemented, the generic
194 <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-get-all" title="tp_cli_dbus_properties_call_get_all ()"><code class="function">tp_cli_dbus_properties_call_get_all()</code></a> method can be used to get the D-Bus
195 properties.</p>
196 <p>
197 </p>
198 <p class="since">Since 0.7.UNRELEASED</p>
199 </div>
200 <hr>
201 <div class="refsect2" title="TpAccountManagerClass">
202 <a name="TpAccountManagerClass"></a><h3>TpAccountManagerClass</h3>
203 <pre class="programlisting">typedef struct {
204 } TpAccountManagerClass;
205 </pre>
206 <p>
207 The class of a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
208 <p>
209 </p>
210 </div>
211 <hr>
212 <div class="refsect2" title="tp_account_manager_new ()">
213 <a name="tp-account-manager-new"></a><h3>tp_account_manager_new ()</h3>
214 <pre class="programlisting"><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> * tp_account_manager_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon);</pre>
215 <p>
216 Convenience function to create a new account manager proxy.</p>
217 <p>
218 </p>
219 <div class="variablelist"><table border="0">
220 <col align="left" valign="top">
221 <tbody>
222 <tr>
223 <td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
224 <td> Proxy for the D-Bus daemon
225 </td>
226 </tr>
227 <tr>
228 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
229 <td> a new reference to an account manager proxy
230 </td>
231 </tr>
232 </tbody>
233 </table></div>
234 </div>
235 <hr>
236 <div class="refsect2" title="tp_account_manager_init_known_interfaces ()">
237 <a name="tp-account-manager-init-known-interfaces"></a><h3>tp_account_manager_init_known_interfaces ()</h3>
238 <pre class="programlisting">void tp_account_manager_init_known_interfaces
239 (void);</pre>
240 <p>
241 Ensure that the known interfaces for TpAccountManager have been set up.
242 This is done automatically when necessary, but for correct
243 overriding of library interfaces by local extensions, you should
244 call this function before calling
245 <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
246 <code class="literal">TP_TYPE_ACCOUNT_MANAGER</code>.</p>
247 <p>
248 </p>
249 <p class="since">Since 0.7.UNRELEASED</p>
250 </div>
251 <hr>
252 <div class="refsect2" title="tp_cli_account_manager_callback_for_create_account ()">
253 <a name="tp-cli-account-manager-callback-for-create-account"></a><h3>tp_cli_account_manager_callback_for_create_account ()</h3>
254 <pre class="programlisting">void (*tp_cli_account_manager_callback_for_create_account)
255 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
256 const <a
257 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
258 >gchar</a> *out_Account,
259 const <a
260 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
261 >GError</a> *error,
262 <a
263 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
264 >gpointer</a> user_data,
265 <a
266 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
267 >GObject</a> *weak_object);</pre>
268 <p>
269 Signature of the callback called when a CreateAccount method call
270 succeeds or fails.</p>
271 <p>
272 </p>
273 <div class="variablelist"><table border="0">
274 <col align="left" valign="top">
275 <tbody>
276 <tr>
277 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
278 <td> the proxy on which the call was made
279 </td>
280 </tr>
281 <tr>
282 <td><p><span class="term"><em class="parameter"><code>out_Account</code></em> :</span></p></td>
283 <td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
284 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
285 ><code class="literal">NULL</code></a>: The new &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt;.
286 </td>
287 </tr>
288 <tr>
289 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
290 <td> <a
291 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
292 ><code class="literal">NULL</code></a> on success, or an error on failure
293 </td>
294 </tr>
295 <tr>
296 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
297 <td> user-supplied data
298 </td>
299 </tr>
300 <tr>
301 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
302 <td> user-supplied object
303 </td>
304 </tr>
305 </tbody>
306 </table></div>
307 </div>
308 <hr>
309 <div class="refsect2" title="tp_cli_account_manager_call_create_account ()">
310 <a name="tp-cli-account-manager-call-create-account"></a><h3>tp_cli_account_manager_call_create_account ()</h3>
311 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_account_manager_call_create_account
312 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
313 <a
314 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
315 >gint</a> timeout_ms,
316 const <a
317 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
318 >gchar</a> *in_Connection_Manager,
319 const <a
320 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
321 >gchar</a> *in_Protocol,
322 const <a
323 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
324 >gchar</a> *in_Display_Name,
325 <a
326 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
327 >GHashTable</a> *in_Parameters,
328 <a
329 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
330 >GHashTable</a> *in_Properties,
331 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account" title="tp_cli_account_manager_callback_for_create_account ()">tp_cli_account_manager_callback_for_create_account</a> callback,
332 <a
333 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
334 >gpointer</a> user_data,
335 <a
336 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
337 >GDestroyNotify</a> destroy,
338 <a
339 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
340 >GObject</a> *weak_object);</pre>
341 <p>
342 Start a CreateAccount method call.
343 </p>
344 <p>
345 Request the creation of a new &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt;. The account manager SHOULD NOT allow invalid accounts to be created.</p>
346 <p>
347 </p>
348 <div class="variablelist"><table border="0">
349 <col align="left" valign="top">
350 <tbody>
351 <tr>
352 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
353 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
354 </td>
355 </tr>
356 <tr>
357 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
358 <td> the timeout in milliseconds, or -1 to use the
359 default
360 </td>
361 </tr>
362 <tr>
363 <td><p><span class="term"><em class="parameter"><code>in_Connection_Manager</code></em> :</span></p></td>
364 <td> Used to pass an 'in' argument: The name of the connection manager, e.g. &amp;quot;salut&amp;quot;.
365 </td>
366 </tr>
367 <tr>
368 <td><p><span class="term"><em class="parameter"><code>in_Protocol</code></em> :</span></p></td>
369 <td> Used to pass an 'in' argument: The protocol, e.g. &amp;quot;local-xmpp&amp;quot;.
370 </td>
371 </tr>
372 <tr>
373 <td><p><span class="term"><em class="parameter"><code>in_Display_Name</code></em> :</span></p></td>
374 <td> Used to pass an 'in' argument: The initial value of the new account's &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Account"&gt;DisplayName&lt;/tp:dbus-ref&gt; property. The account manager SHOULD modify this to make it unique if an Account already exists with the same display name, for instance by appending a number or the 'account' parameter. Account manager implementations SHOULD accept an empty string, but account editing user interfaces should avoid passing an empty string for this parameter. &lt;tp:rationale&gt; &lt;p&gt;The account creation UI may ask the user for a name for the new account. If the author of the UI chooses not to do this, the account creation UI is better able to suggest a default display name because it has protocol-specific knowledge which the account manager does not.&lt;/p&gt; &lt;p&gt;The account manager always knows the complete list of accounts so it can easily tell whether it should append something to the display name to avoid presenting two identically-named accounts to the user.&lt;/p&gt; &lt;/tp:rationale&gt;
375 </td>
376 </tr>
377 <tr>
378 <td><p><span class="term"><em class="parameter"><code>in_Parameters</code></em> :</span></p></td>
379 <td> Used to pass an 'in' argument: Initial parameter values, as would be passed to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ConnectionManager"&gt;RequestConnection&lt;/tp:dbus-ref&gt;.
380 </td>
381 </tr>
382 <tr>
383 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
384 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The values of any other properties to be set immediately on the new Account.&lt;/p&gt; &lt;p&gt;Only the properties mentioned in &lt;tp:member-ref&gt;SupportedAccountProperties&lt;/tp:member-ref&gt; are acceptable here. In particular, the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Account"&gt;DisplayName&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Account"&gt;Parameters&lt;/tp:dbus-ref&gt; properties are never allowed here, since they are set using the other arguments to this method.&lt;/p&gt; &lt;p&gt;Account manager implementations SHOULD support creating accounts with an empty value for this argument.&lt;/p&gt;
385 </td>
386 </tr>
387 <tr>
388 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
389 <td> called when the method call succeeds or fails;
390 may be <a
391 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
392 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
393 reply tracking
394 </td>
395 </tr>
396 <tr>
397 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
398 <td> user-supplied data passed to the callback;
399 must be <a
400 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
401 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
402 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
403 ><code class="literal">NULL</code></a>
404 </td>
405 </tr>
406 <tr>
407 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
408 <td> called with the user_data as argument, after the
409 call has succeeded, failed or been cancelled;
410 must be <a
411 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
412 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
413 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
414 ><code class="literal">NULL</code></a>
415 </td>
416 </tr>
417 <tr>
418 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
419 <td> If not <a
420 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
421 ><code class="literal">NULL</code></a>, a <a
422 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
423 ><span class="type">GObject</span></a> which will be
424 weakly referenced; if it is destroyed, this call
425 will automatically be cancelled. Must be <a
426 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
427 ><code class="literal">NULL</code></a> if
428 <em class="parameter"><code>callback</code></em> is <a
429 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
430 ><code class="literal">NULL</code></a>
431 </td>
432 </tr>
433 <tr>
434 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
435 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
436 progress. It is borrowed from the object, and will become
437 invalid when the callback is called, the call is
438 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
439 </td>
440 </tr>
441 </tbody>
442 </table></div>
443 </div>
444 <hr>
445 <div class="refsect2" title="tp_cli_account_manager_signal_callback_account_removed ()">
446 <a name="tp-cli-account-manager-signal-callback-account-removed"></a><h3>tp_cli_account_manager_signal_callback_account_removed ()</h3>
447 <pre class="programlisting">void (*tp_cli_account_manager_signal_callback_account_removed)
448 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
449 const <a
450 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
451 >gchar</a> *arg_Account,
452 <a
453 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
454 >gpointer</a> user_data,
455 <a
456 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
457 >GObject</a> *weak_object);</pre>
458 <p>
459 Represents the signature of a callback for the signal AccountRemoved.</p>
460 <p>
461 </p>
462 <div class="variablelist"><table border="0">
463 <col align="left" valign="top">
464 <tbody>
465 <tr>
466 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
467 <td> The proxy on which <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-removed" title="tp_cli_account_manager_connect_to_account_removed ()"><code class="function">tp_cli_account_manager_connect_to_account_removed()</code></a>
468 was called
469 </td>
470 </tr>
471 <tr>
472 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
473 <td> An Account, which must not be used any more.
474 </td>
475 </tr>
476 <tr>
477 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
478 <td> User-supplied data
479 </td>
480 </tr>
481 <tr>
482 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
483 <td> User-supplied weakly referenced object
484 </td>
485 </tr>
486 </tbody>
487 </table></div>
488 </div>
489 <hr>
490 <div class="refsect2" title="tp_cli_account_manager_connect_to_account_removed ()">
491 <a name="tp-cli-account-manager-connect-to-account-removed"></a><h3>tp_cli_account_manager_connect_to_account_removed ()</h3>
492 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_account_manager_connect_to_account_removed
493 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
494 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed" title="tp_cli_account_manager_signal_callback_account_removed ()">tp_cli_account_manager_signal_callback_account_removed</a> callback,
495 <a
496 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
497 >gpointer</a> user_data,
498 <a
499 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
500 >GDestroyNotify</a> destroy,
501 <a
502 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
503 >GObject</a> *weak_object,
504 <a
505 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
506 >GError</a> **error);</pre>
507 <p>
508 Connect a handler to the signal AccountRemoved.
509 </p>
510 <p>
511 The given account has been removed. &lt;tp:rationale&gt; This is effectively change notification for the valid and invalid accounts lists. On emission of this signal, the Account indicated will no longer be present in either of the lists. &lt;/tp:rationale&gt;</p>
512 <p>
513 </p>
514 <div class="variablelist"><table border="0">
515 <col align="left" valign="top">
516 <tbody>
517 <tr>
518 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
519 <td> A <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> or subclass
520 </td>
521 </tr>
522 <tr>
523 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
524 <td> Callback to be called when the signal is
525 received
526 </td>
527 </tr>
528 <tr>
529 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
530 <td> User-supplied data for the callback
531 </td>
532 </tr>
533 <tr>
534 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
535 <td> Destructor for the user-supplied data, which
536 will be called when this signal is disconnected, or
537 before this function returns <a
538 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
539 ><code class="literal">NULL</code></a>
540 </td>
541 </tr>
542 <tr>
543 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
544 <td> A <a
545 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
546 ><span class="type">GObject</span></a> which will be weakly referenced;
547 if it is destroyed, this callback will automatically be
548 disconnected
549 </td>
550 </tr>
551 <tr>
552 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
553 <td> If not <a
554 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
555 ><code class="literal">NULL</code></a>, used to raise an error if <a
556 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
557 ><code class="literal">NULL</code></a> is
558 returned
559 </td>
560 </tr>
561 <tr>
562 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
563 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
564 above, which can be used to disconnect the signal; or
565 <a
566 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
567 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
568 or has become invalid.
569 </td>
570 </tr>
571 </tbody>
572 </table></div>
573 </div>
574 <hr>
575 <div class="refsect2" title="tp_cli_account_manager_signal_callback_account_validity_changed ()">
576 <a name="tp-cli-account-manager-signal-callback-account-validity-changed"></a><h3>tp_cli_account_manager_signal_callback_account_validity_changed ()</h3>
577 <pre class="programlisting">void (*tp_cli_account_manager_signal_callback_account_validity_changed)
578 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
579 const <a
580 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
581 >gchar</a> *arg_Account,
582 <a
583 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
584 >gboolean</a> arg_Valid,
585 <a
586 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
587 >gpointer</a> user_data,
588 <a
589 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
590 >GObject</a> *weak_object);</pre>
591 <p>
592 Represents the signature of a callback for the signal AccountValidityChanged.</p>
593 <p>
594 </p>
595 <div class="variablelist"><table border="0">
596 <col align="left" valign="top">
597 <tbody>
598 <tr>
599 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
600 <td> The proxy on which <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-validity-changed" title="tp_cli_account_manager_connect_to_account_validity_changed ()"><code class="function">tp_cli_account_manager_connect_to_account_validity_changed()</code></a>
601 was called
602 </td>
603 </tr>
604 <tr>
605 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
606 <td> An Account.
607 </td>
608 </tr>
609 <tr>
610 <td><p><span class="term"><em class="parameter"><code>arg_Valid</code></em> :</span></p></td>
611 <td> True if the account is now valid.
612 </td>
613 </tr>
614 <tr>
615 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
616 <td> User-supplied data
617 </td>
618 </tr>
619 <tr>
620 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
621 <td> User-supplied weakly referenced object
622 </td>
623 </tr>
624 </tbody>
625 </table></div>
626 </div>
627 <hr>
628 <div class="refsect2" title="tp_cli_account_manager_connect_to_account_validity_changed ()">
629 <a name="tp-cli-account-manager-connect-to-account-validity-changed"></a><h3>tp_cli_account_manager_connect_to_account_validity_changed ()</h3>
630 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_account_manager_connect_to_account_validity_changed
631 (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
632 <a class="link" href="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed" title="tp_cli_account_manager_signal_callback_account_validity_changed ()">tp_cli_account_manager_signal_callback_account_validity_changed</a> callback,
633 <a
634 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
635 >gpointer</a> user_data,
636 <a
637 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
638 >GDestroyNotify</a> destroy,
639 <a
640 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
641 >GObject</a> *weak_object,
642 <a
643 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
644 >GError</a> **error);</pre>
645 <p>
646 Connect a handler to the signal AccountValidityChanged.
647 </p>
648 <p>
649 The validity of the given account has changed. New accounts are also indicated by this signal, as an account validity change (usually to True) on an account that did not previously exist. &lt;tp:rationale&gt; This is effectively change notification for the valid and invalid accounts lists. &lt;/tp:rationale&gt;</p>
650 <p>
651 </p>
652 <div class="variablelist"><table border="0">
653 <col align="left" valign="top">
654 <tbody>
655 <tr>
656 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
657 <td> A <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> or subclass
658 </td>
659 </tr>
660 <tr>
661 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
662 <td> Callback to be called when the signal is
663 received
664 </td>
665 </tr>
666 <tr>
667 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
668 <td> User-supplied data for the callback
669 </td>
670 </tr>
671 <tr>
672 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
673 <td> Destructor for the user-supplied data, which
674 will be called when this signal is disconnected, or
675 before this function returns <a
676 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
677 ><code class="literal">NULL</code></a>
678 </td>
679 </tr>
680 <tr>
681 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
682 <td> A <a
683 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
684 ><span class="type">GObject</span></a> which will be weakly referenced;
685 if it is destroyed, this callback will automatically be
686 disconnected
687 </td>
688 </tr>
689 <tr>
690 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
691 <td> If not <a
692 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
693 ><code class="literal">NULL</code></a>, used to raise an error if <a
694 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
695 ><code class="literal">NULL</code></a> is
696 returned
697 </td>
698 </tr>
699 <tr>
700 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
701 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
702 above, which can be used to disconnect the signal; or
703 <a
704 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
705 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
706 or has become invalid.
707 </td>
708 </tr>
709 </tbody>
710 </table></div>
711 </div>
712 </div>
713 <div class="refsect1" title="See Also">
714 <a name="telepathy-glib-account-manager.see-also"></a><h2>See Also</h2>
715 #TpAccount
716 </div>
717 </div>
718 <div class="footer">
719 <hr>
720 Generated by GTK-Doc V1.11</div>
721 </body>
722 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpAccount</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-account-manager.html" title="TpAccountManager">
9 <link rel="next" href="telepathy-glib-channel-dispatcher.html" title="TpChannelDispatcher">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-account-manager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-channel-dispatcher.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-account.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-account.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-account.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="TpAccount">
38 <a name="telepathy-glib-account"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-account.top_of_page"></a>TpAccount</span></h2>
42 <p>TpAccount — proxy object for an account in the Telepathy account
43 manager</p>
44 </td>
45 <td valign="top" align="right"></td>
46 </tr></table></div>
47 <div class="refsynopsisdiv" title="Synopsis">
48 <a name="telepathy-glib-account.synopsis"></a><h2>Synopsis</h2>
49 <a name="TpAccount"></a><pre class="synopsis">
50
51 #include &lt;telepathy-glib/account.h&gt;
52
53 <a class="link" href="telepathy-glib-account.html#TpAccount-struct" title="TpAccount">TpAccount</a>;
54 <a class="link" href="telepathy-glib-account.html#TpAccountClass" title="TpAccountClass">TpAccountClass</a>;
55 <a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * <a class="link" href="telepathy-glib-account.html#tp-account-new" title="tp_account_new ()">tp_account_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
56 const <a
57 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
58 >gchar</a> *object_path,
59 <a
60 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
61 >GError</a> **error);
62 void <a class="link" href="telepathy-glib-account.html#tp-account-init-known-interfaces" title="tp_account_init_known_interfaces ()">tp_account_init_known_interfaces</a> (void);
63
64 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()">*tp_cli_account_callback_for_reconnect</a>)
65 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
66 const <a
67 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
68 >GError</a> *error,
69 <a
70 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
71 >gpointer</a> user_data,
72 <a
73 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
74 >GObject</a> *weak_object);
75 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-reconnect" title="tp_cli_account_call_reconnect ()">tp_cli_account_call_reconnect</a> (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
76 <a
77 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
78 >gint</a> timeout_ms,
79 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()">tp_cli_account_callback_for_reconnect</a> callback,
80 <a
81 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
82 >gpointer</a> user_data,
83 <a
84 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
85 >GDestroyNotify</a> destroy,
86 <a
87 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
88 >GObject</a> *weak_object);
89 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()">*tp_cli_account_callback_for_remove</a>)
90 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
91 const <a
92 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
93 >GError</a> *error,
94 <a
95 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
96 >gpointer</a> user_data,
97 <a
98 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
99 >GObject</a> *weak_object);
100 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-remove" title="tp_cli_account_call_remove ()">tp_cli_account_call_remove</a> (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
101 <a
102 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
103 >gint</a> timeout_ms,
104 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()">tp_cli_account_callback_for_remove</a> callback,
105 <a
106 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
107 >gpointer</a> user_data,
108 <a
109 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
110 >GDestroyNotify</a> destroy,
111 <a
112 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
113 >GObject</a> *weak_object);
114 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()">*tp_cli_account_callback_for_update_parameters</a>)
115 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
116 const <a
117 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
118 >gchar</a> **out_Reconnect_Required,
119 const <a
120 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
121 >GError</a> *error,
122 <a
123 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
124 >gpointer</a> user_data,
125 <a
126 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
127 >GObject</a> *weak_object);
128 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-update-parameters" title="tp_cli_account_call_update_parameters ()">tp_cli_account_call_update_parameters</a>
129 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
130 <a
131 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
132 >gint</a> timeout_ms,
133 <a
134 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
135 >GHashTable</a> *in_Set,
136 const <a
137 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
138 >gchar</a> **in_Unset,
139 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()">tp_cli_account_callback_for_update_parameters</a> callback,
140 <a
141 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
142 >gpointer</a> user_data,
143 <a
144 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
145 >GDestroyNotify</a> destroy,
146 <a
147 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
148 >GObject</a> *weak_object);
149 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed" title="tp_cli_account_signal_callback_account_property_changed ()">*tp_cli_account_signal_callback_account_property_changed</a>)
150 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
151 <a
152 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
153 >GHashTable</a> *arg_Properties,
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/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
159 >GObject</a> *weak_object);
160 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-connect-to-account-property-changed" title="tp_cli_account_connect_to_account_property_changed ()">tp_cli_account_connect_to_account_property_changed</a>
161 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
162 <a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed" title="tp_cli_account_signal_callback_account_property_changed ()">tp_cli_account_signal_callback_account_property_changed</a> callback,
163 <a
164 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
165 >gpointer</a> user_data,
166 <a
167 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
168 >GDestroyNotify</a> destroy,
169 <a
170 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
171 >GObject</a> *weak_object,
172 <a
173 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
174 >GError</a> **error);
175 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()">*tp_cli_account_signal_callback_removed</a>)
176 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
177 <a
178 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
179 >gpointer</a> user_data,
180 <a
181 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
182 >GObject</a> *weak_object);
183 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-connect-to-removed" title="tp_cli_account_connect_to_removed ()">tp_cli_account_connect_to_removed</a>
184 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
185 <a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()">tp_cli_account_signal_callback_removed</a> callback,
186 <a
187 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
188 >gpointer</a> user_data,
189 <a
190 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
191 >GDestroyNotify</a> destroy,
192 <a
193 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
194 >GObject</a> *weak_object,
195 <a
196 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
197 >GError</a> **error);
198
199 void (<a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed" title="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()">*tp_cli_account_interface_avatar_signal_callback_avatar_changed</a>)
200 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
201 <a
202 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
203 >gpointer</a> user_data,
204 <a
205 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
206 >GObject</a> *weak_object);
207 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-avatar-connect-to-avatar-changed" title="tp_cli_account_interface_avatar_connect_to_avatar_changed ()">tp_cli_account_interface_avatar_connect_to_avatar_changed</a>
208 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
209 <a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed" title="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()">tp_cli_account_interface_avatar_signal_callback_avatar_changed</a> callback,
210 <a
211 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
212 >gpointer</a> user_data,
213 <a
214 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
215 >GDestroyNotify</a> destroy,
216 <a
217 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
218 >GObject</a> *weak_object,
219 <a
220 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
221 >GError</a> **error);
222 </pre>
223 </div>
224 <div class="refsect1" title="Object Hierarchy">
225 <a name="telepathy-glib-account.object-hierarchy"></a><h2>Object Hierarchy</h2>
226 <pre class="synopsis">
227 <a
228 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
229 >GObject</a>
230 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
231 +----TpAccount
232 </pre>
233 </div>
234 <div class="refsect1" title="Description">
235 <a name="telepathy-glib-account.description"></a><h2>Description</h2>
236 <p>
237 The Telepathy Account Manager stores the user's configured real-time
238 communication accounts. The <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> object represents a stored account.</p>
239 <p>
240 </p>
241 </div>
242 <div class="refsect1" title="Details">
243 <a name="telepathy-glib-account.details"></a><h2>Details</h2>
244 <div class="refsect2" title="TpAccount">
245 <a name="TpAccount-struct"></a><h3>TpAccount</h3>
246 <pre class="programlisting">typedef struct _TpAccount TpAccount;</pre>
247 <p>
248 The Telepathy Account Manager stores the user's configured real-time
249 communication accounts. This object represents a stored account.
250 </p>
251 <p>
252 If this account is deleted from the account manager, the
253 <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal will be emitted
254 with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
255 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a>.
256 </p>
257 <p>
258 This proxy is usable but very incomplete: accessors for the
259 Account's D-Bus properties will be added in a later version of
260 telepathy-glib, along with a mechanism similar to
261 <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>.
262 </p>
263 <p>
264 Most operations performed on an Account are done via D-Bus properties.
265 Until convenience methods for this are implemented, use of the generic
266 <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-get-all" title="tp_cli_dbus_properties_call_get_all ()"><code class="function">tp_cli_dbus_properties_call_get_all()</code></a> and <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-set" title="tp_cli_dbus_properties_call_set ()"><code class="function">tp_cli_dbus_properties_call_set()</code></a>
267 methods is recommended.
268 </p>
269 <p>
270 Other useful auto-generated method wrappers on an Account include
271 <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-remove" title="tp_cli_account_call_remove ()"><code class="function">tp_cli_account_call_remove()</code></a>, <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-update-parameters" title="tp_cli_account_call_update_parameters ()"><code class="function">tp_cli_account_call_update_parameters()</code></a> and
272 <a class="link" href="telepathy-glib-account.html#tp-cli-account-call-reconnect" title="tp_cli_account_call_reconnect ()"><code class="function">tp_cli_account_call_reconnect()</code></a>.</p>
273 <p>
274 </p>
275 <p class="since">Since 0.7.UNRELEASED</p>
276 </div>
277 <hr>
278 <div class="refsect2" title="TpAccountClass">
279 <a name="TpAccountClass"></a><h3>TpAccountClass</h3>
280 <pre class="programlisting">typedef struct {
281 } TpAccountClass;
282 </pre>
283 <p>
284 The class of a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
285 <p>
286 </p>
287 </div>
288 <hr>
289 <div class="refsect2" title="tp_account_new ()">
290 <a name="tp-account-new"></a><h3>tp_account_new ()</h3>
291 <pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * tp_account_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
292 const <a
293 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
294 >gchar</a> *object_path,
295 <a
296 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
297 >GError</a> **error);</pre>
298 <p>
299 Convenience function to create a new account proxy.</p>
300 <p>
301 </p>
302 <div class="variablelist"><table border="0">
303 <col align="left" valign="top">
304 <tbody>
305 <tr>
306 <td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
307 <td> Proxy for the D-Bus daemon
308 </td>
309 </tr>
310 <tr>
311 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
312 <td> The non-NULL object path of this account
313 </td>
314 </tr>
315 <tr>
316 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
317 <td> Used to raise an error if <em class="parameter"><code>object_path</code></em> is not valid
318 </td>
319 </tr>
320 <tr>
321 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
322 <td> a new reference to an account proxy, or <a
323 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
324 ><code class="literal">NULL</code></a> if <em class="parameter"><code>object_path</code></em> is
325 not valid
326 </td>
327 </tr>
328 </tbody>
329 </table></div>
330 </div>
331 <hr>
332 <div class="refsect2" title="tp_account_init_known_interfaces ()">
333 <a name="tp-account-init-known-interfaces"></a><h3>tp_account_init_known_interfaces ()</h3>
334 <pre class="programlisting">void tp_account_init_known_interfaces (void);</pre>
335 <p>
336 Ensure that the known interfaces for TpAccount have been set up.
337 This is done automatically when necessary, but for correct
338 overriding of library interfaces by local extensions, you should
339 call this function before calling
340 <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
341 <code class="literal">TP_TYPE_ACCOUNT</code>.</p>
342 <p>
343 </p>
344 <p class="since">Since 0.7.UNRELEASED</p>
345 </div>
346 <hr>
347 <div class="refsect2" title="tp_cli_account_callback_for_reconnect ()">
348 <a name="tp-cli-account-callback-for-reconnect"></a><h3>tp_cli_account_callback_for_reconnect ()</h3>
349 <pre class="programlisting">void (*tp_cli_account_callback_for_reconnect)
350 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
351 const <a
352 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
353 >GError</a> *error,
354 <a
355 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
356 >gpointer</a> user_data,
357 <a
358 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
359 >GObject</a> *weak_object);</pre>
360 <p>
361 Signature of the callback called when a Reconnect method call
362 succeeds or fails.</p>
363 <p>
364 </p>
365 <div class="variablelist"><table border="0">
366 <col align="left" valign="top">
367 <tbody>
368 <tr>
369 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
370 <td> the proxy on which the call was made
371 </td>
372 </tr>
373 <tr>
374 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
375 <td> <a
376 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
377 ><code class="literal">NULL</code></a> on success, or an error on failure
378 </td>
379 </tr>
380 <tr>
381 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
382 <td> user-supplied data
383 </td>
384 </tr>
385 <tr>
386 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
387 <td> user-supplied object
388 </td>
389 </tr>
390 </tbody>
391 </table></div>
392 </div>
393 <hr>
394 <div class="refsect2" title="tp_cli_account_call_reconnect ()">
395 <a name="tp-cli-account-call-reconnect"></a><h3>tp_cli_account_call_reconnect ()</h3>
396 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_account_call_reconnect (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
397 <a
398 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
399 >gint</a> timeout_ms,
400 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()">tp_cli_account_callback_for_reconnect</a> callback,
401 <a
402 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
403 >gpointer</a> user_data,
404 <a
405 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
406 >GDestroyNotify</a> destroy,
407 <a
408 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
409 >GObject</a> *weak_object);</pre>
410 <p>
411 Start a Reconnect method call.
412 </p>
413 <p>
414 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Re-connect this account. If the account is currently disconnected and the requested presence is offline, or if the account is not &lt;tp:member-ref&gt;Enabled&lt;/tp:member-ref&gt; or not &lt;tp:member-ref&gt;Valid&lt;/tp:member-ref&gt;, this does nothing.&lt;/p&gt; &lt;p&gt;If the account is disconnected and the requested presence is not offline, this forces an attempt to connect with the requested presence immediately.&lt;/p&gt; &lt;p&gt;If the account is connecting or connected, this is equivalent to remembering the current value of &lt;tp:member-ref&gt;RequestedPresence&lt;/tp:member-ref&gt;, setting its value to (OFFLINE, &amp;quot;offline&amp;quot;, &amp;quot;&amp;quot;), waiting for the change to take effect, then setting its value to the value that was previously remembered.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Clients desiring &amp;quot;instant apply&amp;quot; semantics for CM parameters MAY call this method to achieve that.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;In particular, if the account's &lt;tp:member-ref&gt;Connection&lt;/tp:member-ref&gt; is in the Connecting state, calling this method causes the attempt to connect to be aborted and re-tried.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This is necessary to ensure that the new parameters are picked up.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
415 <p>
416 </p>
417 <div class="variablelist"><table border="0">
418 <col align="left" valign="top">
419 <tbody>
420 <tr>
421 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
422 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
423 </td>
424 </tr>
425 <tr>
426 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
427 <td> the timeout in milliseconds, or -1 to use the
428 default
429 </td>
430 </tr>
431 <tr>
432 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
433 <td> called when the method call succeeds or fails;
434 may be <a
435 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
436 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
437 reply tracking
438 </td>
439 </tr>
440 <tr>
441 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
442 <td> user-supplied data passed to the callback;
443 must be <a
444 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
445 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
446 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
447 ><code class="literal">NULL</code></a>
448 </td>
449 </tr>
450 <tr>
451 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
452 <td> called with the user_data as argument, after the
453 call has succeeded, failed or been cancelled;
454 must be <a
455 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
456 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
457 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
458 ><code class="literal">NULL</code></a>
459 </td>
460 </tr>
461 <tr>
462 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
463 <td> If not <a
464 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
465 ><code class="literal">NULL</code></a>, a <a
466 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
467 ><span class="type">GObject</span></a> which will be
468 weakly referenced; if it is destroyed, this call
469 will automatically be cancelled. Must be <a
470 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
471 ><code class="literal">NULL</code></a> if
472 <em class="parameter"><code>callback</code></em> is <a
473 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
474 ><code class="literal">NULL</code></a>
475 </td>
476 </tr>
477 <tr>
478 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
479 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
480 progress. It is borrowed from the object, and will become
481 invalid when the callback is called, the call is
482 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
483 </td>
484 </tr>
485 </tbody>
486 </table></div>
487 </div>
488 <hr>
489 <div class="refsect2" title="tp_cli_account_callback_for_remove ()">
490 <a name="tp-cli-account-callback-for-remove"></a><h3>tp_cli_account_callback_for_remove ()</h3>
491 <pre class="programlisting">void (*tp_cli_account_callback_for_remove)
492 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
493 const <a
494 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
495 >GError</a> *error,
496 <a
497 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
498 >gpointer</a> user_data,
499 <a
500 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
501 >GObject</a> *weak_object);</pre>
502 <p>
503 Signature of the callback called when a Remove method call
504 succeeds or fails.</p>
505 <p>
506 </p>
507 <div class="variablelist"><table border="0">
508 <col align="left" valign="top">
509 <tbody>
510 <tr>
511 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
512 <td> the proxy on which the call was made
513 </td>
514 </tr>
515 <tr>
516 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
517 <td> <a
518 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
519 ><code class="literal">NULL</code></a> on success, or an error on failure
520 </td>
521 </tr>
522 <tr>
523 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
524 <td> user-supplied data
525 </td>
526 </tr>
527 <tr>
528 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
529 <td> user-supplied object
530 </td>
531 </tr>
532 </tbody>
533 </table></div>
534 </div>
535 <hr>
536 <div class="refsect2" title="tp_cli_account_call_remove ()">
537 <a name="tp-cli-account-call-remove"></a><h3>tp_cli_account_call_remove ()</h3>
538 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_account_call_remove (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
539 <a
540 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
541 >gint</a> timeout_ms,
542 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()">tp_cli_account_callback_for_remove</a> callback,
543 <a
544 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
545 >gpointer</a> user_data,
546 <a
547 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
548 >GDestroyNotify</a> destroy,
549 <a
550 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
551 >GObject</a> *weak_object);</pre>
552 <p>
553 Start a Remove method call.
554 </p>
555 <p>
556 Delete the account.</p>
557 <p>
558 </p>
559 <div class="variablelist"><table border="0">
560 <col align="left" valign="top">
561 <tbody>
562 <tr>
563 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
564 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
565 </td>
566 </tr>
567 <tr>
568 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
569 <td> the timeout in milliseconds, or -1 to use the
570 default
571 </td>
572 </tr>
573 <tr>
574 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
575 <td> called when the method call succeeds or fails;
576 may be <a
577 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
578 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
579 reply tracking
580 </td>
581 </tr>
582 <tr>
583 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
584 <td> user-supplied data passed to the callback;
585 must be <a
586 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
587 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
588 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
589 ><code class="literal">NULL</code></a>
590 </td>
591 </tr>
592 <tr>
593 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
594 <td> called with the user_data as argument, after the
595 call has succeeded, failed or been cancelled;
596 must be <a
597 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
598 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
599 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
600 ><code class="literal">NULL</code></a>
601 </td>
602 </tr>
603 <tr>
604 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
605 <td> If not <a
606 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
607 ><code class="literal">NULL</code></a>, a <a
608 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
609 ><span class="type">GObject</span></a> which will be
610 weakly referenced; if it is destroyed, this call
611 will automatically be cancelled. Must be <a
612 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
613 ><code class="literal">NULL</code></a> if
614 <em class="parameter"><code>callback</code></em> is <a
615 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
616 ><code class="literal">NULL</code></a>
617 </td>
618 </tr>
619 <tr>
620 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
621 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
622 progress. It is borrowed from the object, and will become
623 invalid when the callback is called, the call is
624 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
625 </td>
626 </tr>
627 </tbody>
628 </table></div>
629 </div>
630 <hr>
631 <div class="refsect2" title="tp_cli_account_callback_for_update_parameters ()">
632 <a name="tp-cli-account-callback-for-update-parameters"></a><h3>tp_cli_account_callback_for_update_parameters ()</h3>
633 <pre class="programlisting">void (*tp_cli_account_callback_for_update_parameters)
634 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
635 const <a
636 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
637 >gchar</a> **out_Reconnect_Required,
638 const <a
639 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
640 >GError</a> *error,
641 <a
642 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
643 >gpointer</a> user_data,
644 <a
645 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
646 >GObject</a> *weak_object);</pre>
647 <p>
648 Signature of the callback called when a UpdateParameters method call
649 succeeds or fails.</p>
650 <p>
651 </p>
652 <div class="variablelist"><table border="0">
653 <col align="left" valign="top">
654 <tbody>
655 <tr>
656 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
657 <td> the proxy on which the call was made
658 </td>
659 </tr>
660 <tr>
661 <td><p><span class="term"><em class="parameter"><code>out_Reconnect_Required</code></em> :</span></p></td>
662 <td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
663 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
664 ><code class="literal">NULL</code></a>: A list of the names of parameters with changes that will not take effect until the account is reconnected (this may be empty, e.g. if all the parameters are D-Bus properties or parameters for which the account manager has specific support). User interfaces that require &amp;quot;instant apply&amp;quot; semantics MAY call &lt;tp:member-ref&gt;Reconnect&lt;/tp:member-ref&gt; in response to receiving a non-empty list.
665 </td>
666 </tr>
667 <tr>
668 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
669 <td> <a
670 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
671 ><code class="literal">NULL</code></a> on success, or an error on failure
672 </td>
673 </tr>
674 <tr>
675 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
676 <td> user-supplied data
677 </td>
678 </tr>
679 <tr>
680 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
681 <td> user-supplied object
682 </td>
683 </tr>
684 </tbody>
685 </table></div>
686 </div>
687 <hr>
688 <div class="refsect2" title="tp_cli_account_call_update_parameters ()">
689 <a name="tp-cli-account-call-update-parameters"></a><h3>tp_cli_account_call_update_parameters ()</h3>
690 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_account_call_update_parameters
691 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
692 <a
693 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
694 >gint</a> timeout_ms,
695 <a
696 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
697 >GHashTable</a> *in_Set,
698 const <a
699 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
700 >gchar</a> **in_Unset,
701 <a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()">tp_cli_account_callback_for_update_parameters</a> callback,
702 <a
703 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
704 >gpointer</a> user_data,
705 <a
706 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
707 >GDestroyNotify</a> destroy,
708 <a
709 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
710 >GObject</a> *weak_object);</pre>
711 <p>
712 Start a UpdateParameters method call.
713 </p>
714 <p>
715 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Change the value of the &lt;tp:member-ref&gt;Parameters&lt;/tp:member-ref&gt; property.&lt;/p&gt; &lt;p&gt;If any of the changed parameters' &lt;tp:type&gt;Conn_Mgr_Param_Flags&lt;/tp:type&gt; include &lt;code&gt;DBus_Property&lt;/code&gt;, the change will be applied to the corresponding D-Bus Property on the active &lt;tp:member-ref&gt;Connection&lt;/tp:member-ref&gt;, if there is one. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;In general, reconnecting is a destructive operation that shouldn't happen as a side-effect. In particular, migration tools that twiddle the settings of all accounts shouldn't cause an automatic disconnect and reconnect.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
716 <p>
717 </p>
718 <div class="variablelist"><table border="0">
719 <col align="left" valign="top">
720 <tbody>
721 <tr>
722 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
723 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
724 </td>
725 </tr>
726 <tr>
727 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
728 <td> the timeout in milliseconds, or -1 to use the
729 default
730 </td>
731 </tr>
732 <tr>
733 <td><p><span class="term"><em class="parameter"><code>in_Set</code></em> :</span></p></td>
734 <td> Used to pass an 'in' argument: A mapping from parameter names to their values. These parameters should be stored for future use.
735 </td>
736 </tr>
737 <tr>
738 <td><p><span class="term"><em class="parameter"><code>in_Unset</code></em> :</span></p></td>
739 <td> Used to pass an 'in' argument: A list of the names of parameters to be removed from the set of stored values, allowing the default values to be used. If the given parameters were not, in fact, stored, or even if they do not exist at all, the account manager MUST accept this without error.
740 </td>
741 </tr>
742 <tr>
743 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
744 <td> called when the method call succeeds or fails;
745 may be <a
746 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
747 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
748 reply tracking
749 </td>
750 </tr>
751 <tr>
752 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
753 <td> user-supplied data passed to the callback;
754 must be <a
755 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
756 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
757 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
758 ><code class="literal">NULL</code></a>
759 </td>
760 </tr>
761 <tr>
762 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
763 <td> called with the user_data as argument, after the
764 call has succeeded, failed or been cancelled;
765 must be <a
766 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
767 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
768 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
769 ><code class="literal">NULL</code></a>
770 </td>
771 </tr>
772 <tr>
773 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
774 <td> If not <a
775 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
776 ><code class="literal">NULL</code></a>, a <a
777 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
778 ><span class="type">GObject</span></a> which will be
779 weakly referenced; if it is destroyed, this call
780 will automatically be cancelled. Must be <a
781 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
782 ><code class="literal">NULL</code></a> if
783 <em class="parameter"><code>callback</code></em> is <a
784 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
785 ><code class="literal">NULL</code></a>
786 </td>
787 </tr>
788 <tr>
789 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
790 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
791 progress. It is borrowed from the object, and will become
792 invalid when the callback is called, the call is
793 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
794 </td>
795 </tr>
796 </tbody>
797 </table></div>
798 </div>
799 <hr>
800 <div class="refsect2" title="tp_cli_account_signal_callback_account_property_changed ()">
801 <a name="tp-cli-account-signal-callback-account-property-changed"></a><h3>tp_cli_account_signal_callback_account_property_changed ()</h3>
802 <pre class="programlisting">void (*tp_cli_account_signal_callback_account_property_changed)
803 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
804 <a
805 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
806 >GHashTable</a> *arg_Properties,
807 <a
808 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
809 >gpointer</a> user_data,
810 <a
811 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
812 >GObject</a> *weak_object);</pre>
813 <p>
814 Represents the signature of a callback for the signal AccountPropertyChanged.</p>
815 <p>
816 </p>
817 <div class="variablelist"><table border="0">
818 <col align="left" valign="top">
819 <tbody>
820 <tr>
821 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
822 <td> The proxy on which <a class="link" href="telepathy-glib-account.html#tp-cli-account-connect-to-account-property-changed" title="tp_cli_account_connect_to_account_property_changed ()"><code class="function">tp_cli_account_connect_to_account_property_changed()</code></a>
823 was called
824 </td>
825 </tr>
826 <tr>
827 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
828 <td> A map from property names in this namespace (e.g. &lt;tp:member-ref&gt;Nickname&lt;/tp:member-ref&gt;) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done.
829 </td>
830 </tr>
831 <tr>
832 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
833 <td> User-supplied data
834 </td>
835 </tr>
836 <tr>
837 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
838 <td> User-supplied weakly referenced object
839 </td>
840 </tr>
841 </tbody>
842 </table></div>
843 </div>
844 <hr>
845 <div class="refsect2" title="tp_cli_account_connect_to_account_property_changed ()">
846 <a name="tp-cli-account-connect-to-account-property-changed"></a><h3>tp_cli_account_connect_to_account_property_changed ()</h3>
847 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_account_connect_to_account_property_changed
848 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
849 <a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed" title="tp_cli_account_signal_callback_account_property_changed ()">tp_cli_account_signal_callback_account_property_changed</a> callback,
850 <a
851 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
852 >gpointer</a> user_data,
853 <a
854 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
855 >GDestroyNotify</a> destroy,
856 <a
857 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
858 >GObject</a> *weak_object,
859 <a
860 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
861 >GError</a> **error);</pre>
862 <p>
863 Connect a handler to the signal AccountPropertyChanged.
864 </p>
865 <p>
866 The values of one or more properties on this interface (that do not specify that this signal does not apply to them) may have changed. This does not cover properties of other interfaces, which must provide their own change notification if appropriate.</p>
867 <p>
868 </p>
869 <div class="variablelist"><table border="0">
870 <col align="left" valign="top">
871 <tbody>
872 <tr>
873 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
874 <td> A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass
875 </td>
876 </tr>
877 <tr>
878 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
879 <td> Callback to be called when the signal is
880 received
881 </td>
882 </tr>
883 <tr>
884 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
885 <td> User-supplied data for the callback
886 </td>
887 </tr>
888 <tr>
889 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
890 <td> Destructor for the user-supplied data, which
891 will be called when this signal is disconnected, or
892 before this function returns <a
893 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
894 ><code class="literal">NULL</code></a>
895 </td>
896 </tr>
897 <tr>
898 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
899 <td> A <a
900 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
901 ><span class="type">GObject</span></a> which will be weakly referenced;
902 if it is destroyed, this callback will automatically be
903 disconnected
904 </td>
905 </tr>
906 <tr>
907 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
908 <td> If not <a
909 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
910 ><code class="literal">NULL</code></a>, used to raise an error if <a
911 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
912 ><code class="literal">NULL</code></a> is
913 returned
914 </td>
915 </tr>
916 <tr>
917 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
918 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
919 above, which can be used to disconnect the signal; or
920 <a
921 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
922 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
923 or has become invalid.
924 </td>
925 </tr>
926 </tbody>
927 </table></div>
928 </div>
929 <hr>
930 <div class="refsect2" title="tp_cli_account_signal_callback_removed ()">
931 <a name="tp-cli-account-signal-callback-removed"></a><h3>tp_cli_account_signal_callback_removed ()</h3>
932 <pre class="programlisting">void (*tp_cli_account_signal_callback_removed)
933 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
934 <a
935 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
936 >gpointer</a> user_data,
937 <a
938 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
939 >GObject</a> *weak_object);</pre>
940 <p>
941 Represents the signature of a callback for the signal Removed.</p>
942 <p>
943 </p>
944 <div class="variablelist"><table border="0">
945 <col align="left" valign="top">
946 <tbody>
947 <tr>
948 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
949 <td> The proxy on which <a class="link" href="telepathy-glib-account.html#tp-cli-account-connect-to-removed" title="tp_cli_account_connect_to_removed ()"><code class="function">tp_cli_account_connect_to_removed()</code></a>
950 was called
951 </td>
952 </tr>
953 <tr>
954 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
955 <td> User-supplied data
956 </td>
957 </tr>
958 <tr>
959 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
960 <td> User-supplied weakly referenced object
961 </td>
962 </tr>
963 </tbody>
964 </table></div>
965 </div>
966 <hr>
967 <div class="refsect2" title="tp_cli_account_connect_to_removed ()">
968 <a name="tp-cli-account-connect-to-removed"></a><h3>tp_cli_account_connect_to_removed ()</h3>
969 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_account_connect_to_removed
970 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
971 <a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()">tp_cli_account_signal_callback_removed</a> callback,
972 <a
973 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
974 >gpointer</a> user_data,
975 <a
976 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
977 >GDestroyNotify</a> destroy,
978 <a
979 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
980 >GObject</a> *weak_object,
981 <a
982 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
983 >GError</a> **error);</pre>
984 <p>
985 Connect a handler to the signal Removed.
986 </p>
987 <p>
988 This account has been removed. &lt;tp:rationale&gt; This is redundant with &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager"&gt;AccountRemoved&lt;/tp:dbus-ref&gt;, but it's still worth having, to avoid having to bind to AccountManager.AccountRemoved to tell you whether your Account is valid — ideally, an account-editing UI should only care about a single Account. &lt;/tp:rationale&gt;</p>
989 <p>
990 </p>
991 <div class="variablelist"><table border="0">
992 <col align="left" valign="top">
993 <tbody>
994 <tr>
995 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
996 <td> A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass
997 </td>
998 </tr>
999 <tr>
1000 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1001 <td> Callback to be called when the signal is
1002 received
1003 </td>
1004 </tr>
1005 <tr>
1006 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1007 <td> User-supplied data for the callback
1008 </td>
1009 </tr>
1010 <tr>
1011 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1012 <td> Destructor for the user-supplied data, which
1013 will be called when this signal is disconnected, or
1014 before this function returns <a
1015 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1016 ><code class="literal">NULL</code></a>
1017 </td>
1018 </tr>
1019 <tr>
1020 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1021 <td> A <a
1022 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1023 ><span class="type">GObject</span></a> which will be weakly referenced;
1024 if it is destroyed, this callback will automatically be
1025 disconnected
1026 </td>
1027 </tr>
1028 <tr>
1029 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1030 <td> If not <a
1031 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1032 ><code class="literal">NULL</code></a>, used to raise an error if <a
1033 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1034 ><code class="literal">NULL</code></a> is
1035 returned
1036 </td>
1037 </tr>
1038 <tr>
1039 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1040 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
1041 above, which can be used to disconnect the signal; or
1042 <a
1043 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1044 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
1045 or has become invalid.
1046 </td>
1047 </tr>
1048 </tbody>
1049 </table></div>
1050 </div>
1051 <hr>
1052 <div class="refsect2" title="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()">
1053 <a name="tp-cli-account-interface-avatar-signal-callback-avatar-changed"></a><h3>tp_cli_account_interface_avatar_signal_callback_avatar_changed ()</h3>
1054 <pre class="programlisting">void (*tp_cli_account_interface_avatar_signal_callback_avatar_changed)
1055 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
1056 <a
1057 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1058 >gpointer</a> user_data,
1059 <a
1060 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1061 >GObject</a> *weak_object);</pre>
1062 <p>
1063 Represents the signature of a callback for the signal AvatarChanged.</p>
1064 <p>
1065 </p>
1066 <div class="variablelist"><table border="0">
1067 <col align="left" valign="top">
1068 <tbody>
1069 <tr>
1070 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1071 <td> The proxy on which <a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-avatar-connect-to-avatar-changed" title="tp_cli_account_interface_avatar_connect_to_avatar_changed ()"><code class="function">tp_cli_account_interface_avatar_connect_to_avatar_changed()</code></a>
1072 was called
1073 </td>
1074 </tr>
1075 <tr>
1076 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1077 <td> User-supplied data
1078 </td>
1079 </tr>
1080 <tr>
1081 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1082 <td> User-supplied weakly referenced object
1083 </td>
1084 </tr>
1085 </tbody>
1086 </table></div>
1087 </div>
1088 <hr>
1089 <div class="refsect2" title="tp_cli_account_interface_avatar_connect_to_avatar_changed ()">
1090 <a name="tp-cli-account-interface-avatar-connect-to-avatar-changed"></a><h3>tp_cli_account_interface_avatar_connect_to_avatar_changed ()</h3>
1091 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_account_interface_avatar_connect_to_avatar_changed
1092 (<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *proxy,
1093 <a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed" title="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()">tp_cli_account_interface_avatar_signal_callback_avatar_changed</a> callback,
1094 <a
1095 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1096 >gpointer</a> user_data,
1097 <a
1098 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1099 >GDestroyNotify</a> destroy,
1100 <a
1101 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1102 >GObject</a> *weak_object,
1103 <a
1104 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1105 >GError</a> **error);</pre>
1106 <p>
1107 Connect a handler to the signal AvatarChanged.
1108 </p>
1109 <p>
1110 Emitted when the Avatar property changes. &lt;tp:rationale&gt;The avatar itself is deliberately not included in this signal, to reduce bus traffic in the (likely common) case where no running application cares about the user's own avatar.&lt;/tp:rationale&gt;</p>
1111 <p>
1112 </p>
1113 <div class="variablelist"><table border="0">
1114 <col align="left" valign="top">
1115 <tbody>
1116 <tr>
1117 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1118 <td> A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass
1119 </td>
1120 </tr>
1121 <tr>
1122 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1123 <td> Callback to be called when the signal is
1124 received
1125 </td>
1126 </tr>
1127 <tr>
1128 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1129 <td> User-supplied data for the callback
1130 </td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1134 <td> Destructor for the user-supplied data, which
1135 will be called when this signal is disconnected, or
1136 before this function returns <a
1137 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1138 ><code class="literal">NULL</code></a>
1139 </td>
1140 </tr>
1141 <tr>
1142 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1143 <td> A <a
1144 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1145 ><span class="type">GObject</span></a> which will be weakly referenced;
1146 if it is destroyed, this callback will automatically be
1147 disconnected
1148 </td>
1149 </tr>
1150 <tr>
1151 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1152 <td> If not <a
1153 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1154 ><code class="literal">NULL</code></a>, used to raise an error if <a
1155 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1156 ><code class="literal">NULL</code></a> is
1157 returned
1158 </td>
1159 </tr>
1160 <tr>
1161 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1162 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
1163 above, which can be used to disconnect the signal; or
1164 <a
1165 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1166 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
1167 or has become invalid.
1168 </td>
1169 </tr>
1170 </tbody>
1171 </table></div>
1172 </div>
1173 </div>
1174 <div class="refsect1" title="See Also">
1175 <a name="telepathy-glib-account.see-also"></a><h2>See Also</h2>
1176 #TpAccountManager
1177 </div>
1178 </div>
1179 <div class="footer">
1180 <hr>
1181 Generated by GTK-Doc V1.11</div>
1182 </body>
1183 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Manipulating a{sv} mappings</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="telepathy-glib-dbus.html" title="D-Bus utilities">
456456 <p>
457457 </p>
458458 <div class="example">
459 <a name="id3037604"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
459 <a name="id2932441"></a><p class="title"><b>Example 1. Using <a class="link" href="telepathy-glib-asv.html#tp-asv-new" title="tp_asv_new ()"><code class="function">tp_asv_new()</code></a></b></p>
460460 <div class="example-contents"><pre class="programlisting">
461461 GHashTable *parameters = tp_asv_new (
462462 "answer", G_TYPE_INT, 42,
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpChannelDispatchOperation</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-channel-dispatcher.html" title="TpChannelDispatcher">
9 <link rel="next" href="telepathy-glib-channel-request.html" title="TpChannelRequest">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-channel-dispatcher.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-channel-request.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-channel-dispatch-operation.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-channel-dispatch-operation.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-channel-dispatch-operation.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="TpChannelDispatchOperation">
38 <a name="telepathy-glib-channel-dispatch-operation"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-channel-dispatch-operation.top_of_page"></a>TpChannelDispatchOperation</span></h2>
42 <p>TpChannelDispatchOperation — proxy object for a to the Telepathy channel
43 dispatcher</p>
44 </td>
45 <td valign="top" align="right"></td>
46 </tr></table></div>
47 <div class="refsynopsisdiv" title="Synopsis">
48 <a name="telepathy-glib-channel-dispatch-operation.synopsis"></a><h2>Synopsis</h2>
49 <a name="TpChannelDispatchOperation"></a><pre class="synopsis">
50
51 #include &lt;telepathy-glib/channel-dispatch-operation.h&gt;
52
53 struct <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-struct" title="struct TpChannelDispatchOperation">TpChannelDispatchOperation</a>;
54 struct <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperationClass" title="struct TpChannelDispatchOperationClass">TpChannelDispatchOperationClass</a>;
55 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> * <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-new" title="tp_channel_dispatch_operation_new ()">tp_channel_dispatch_operation_new</a>
56 (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
57 const <a
58 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
59 >gchar</a> *object_path,
60 <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
62 >GHashTable</a> *immutable_properties,
63 <a
64 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
65 >GError</a> **error);
66 void <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-init-known-interfaces" title="tp_channel_dispatch_operation_init_known_interfaces ()">tp_channel_dispatch_operation_init_known_interfaces</a>
67 (void);
68
69 void (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim" title="tp_cli_channel_dispatch_operation_callback_for_claim ()">*tp_cli_channel_dispatch_operation_callback_for_claim</a>)
70 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
71 const <a
72 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
73 >GError</a> *error,
74 <a
75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
76 >gpointer</a> user_data,
77 <a
78 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
79 >GObject</a> *weak_object);
80 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim" title="tp_cli_channel_dispatch_operation_call_claim ()">tp_cli_channel_dispatch_operation_call_claim</a>
81 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
82 <a
83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
84 >gint</a> timeout_ms,
85 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim" title="tp_cli_channel_dispatch_operation_callback_for_claim ()">tp_cli_channel_dispatch_operation_callback_for_claim</a> callback,
86 <a
87 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
88 >gpointer</a> user_data,
89 <a
90 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
91 >GDestroyNotify</a> destroy,
92 <a
93 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
94 >GObject</a> *weak_object);
95 void (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()">*tp_cli_channel_dispatch_operation_callback_for_handle_with</a>)
96 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
97 const <a
98 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
99 >GError</a> *error,
100 <a
101 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
102 >gpointer</a> user_data,
103 <a
104 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
105 >GObject</a> *weak_object);
106 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with" title="tp_cli_channel_dispatch_operation_call_handle_with ()">tp_cli_channel_dispatch_operation_call_handle_with</a>
107 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
108 <a
109 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
110 >gint</a> timeout_ms,
111 const <a
112 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
113 >gchar</a> *in_Handler,
114 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()">tp_cli_channel_dispatch_operation_callback_for_handle_with</a> callback,
115 <a
116 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
117 >gpointer</a> user_data,
118 <a
119 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
120 >GDestroyNotify</a> destroy,
121 <a
122 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
123 >GObject</a> *weak_object);
124 void (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()">*tp_cli_channel_dispatch_operation_signal_callback_channel_lost</a>)
125 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
126 const <a
127 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
128 >gchar</a> *arg_Channel,
129 const <a
130 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
131 >gchar</a> *arg_Error,
132 const <a
133 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
134 >gchar</a> *arg_Message,
135 <a
136 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
137 >gpointer</a> user_data,
138 <a
139 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
140 >GObject</a> *weak_object);
141 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()">tp_cli_channel_dispatch_operation_connect_to_channel_lost</a>
142 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
143 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</a> callback,
144 <a
145 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
146 >gpointer</a> user_data,
147 <a
148 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
149 >GDestroyNotify</a> destroy,
150 <a
151 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
152 >GObject</a> *weak_object,
153 <a
154 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
155 >GError</a> **error);
156 void (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()">*tp_cli_channel_dispatch_operation_signal_callback_finished</a>)
157 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
158 <a
159 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
160 >gpointer</a> user_data,
161 <a
162 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
163 >GObject</a> *weak_object);
164 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished" title="tp_cli_channel_dispatch_operation_connect_to_finished ()">tp_cli_channel_dispatch_operation_connect_to_finished</a>
165 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
166 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()">tp_cli_channel_dispatch_operation_signal_callback_finished</a> callback,
167 <a
168 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
169 >gpointer</a> user_data,
170 <a
171 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
172 >GDestroyNotify</a> destroy,
173 <a
174 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
175 >GObject</a> *weak_object,
176 <a
177 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
178 >GError</a> **error);
179 </pre>
180 </div>
181 <div class="refsect1" title="Object Hierarchy">
182 <a name="telepathy-glib-channel-dispatch-operation.object-hierarchy"></a><h2>Object Hierarchy</h2>
183 <pre class="synopsis">
184 <a
185 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
186 >GObject</a>
187 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
188 +----TpChannelDispatchOperation
189 </pre>
190 </div>
191 <div class="refsect1" title="Description">
192 <a name="telepathy-glib-channel-dispatch-operation.description"></a><h2>Description</h2>
193 <p>
194 One of the channel dispatcher's functions is to offer incoming channels to
195 Approver clients for approval. Approvers respond to the channel dispatcher
196 via a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> object.</p>
197 <p>
198 </p>
199 </div>
200 <div class="refsect1" title="Details">
201 <a name="telepathy-glib-channel-dispatch-operation.details"></a><h2>Details</h2>
202 <div class="refsect2" title="struct TpChannelDispatchOperation">
203 <a name="TpChannelDispatchOperation-struct"></a><h3>struct TpChannelDispatchOperation</h3>
204 <pre class="programlisting">struct TpChannelDispatchOperation;</pre>
205 <p>
206 One of the channel dispatcher's functions is to offer incoming channels to
207 Approver clients for approval. An approver should generally ask the user
208 whether they want to participate in the requested communication channels
209 (join the chat or chatroom, answer the call, accept the file transfer, or
210 whatever is appropriate). A collection of channels offered in this way
211 is represented by a ChannelDispatchOperation object.
212 </p>
213 <p>
214 If the user wishes to accept the communication channels, the approver
215 should call <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with" title="tp_cli_channel_dispatch_operation_call_handle_with ()"><code class="function">tp_cli_channel_dispatch_operation_call_handle_with()</code></a> to
216 indicate the user's or approver's preferred handler for the channels (the
217 empty string indicates no particular preference, and will cause any
218 suitable handler to be used).
219 </p>
220 <p>
221 If the user wishes to reject the communication channels, or if the user
222 accepts the channels and the approver will handle them itself, the approver
223 should call <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim" title="tp_cli_channel_dispatch_operation_call_claim ()"><code class="function">tp_cli_channel_dispatch_operation_call_claim()</code></a>. If this method
224 succeeds, the approver immediately has control over the channels as their
225 primary handler, and may do anything with them (in particular, it may close
226 them in whatever way seems most appropriate).
227 </p>
228 <p>
229 There are various situations in which the channel dispatch operation will
230 be closed, causing the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal to be emitted. If this
231 happens, the approver should stop prompting the user.
232 </p>
233 <p>
234 Because all approvers are launched simultaneously, the user might respond
235 to another approver; if this happens, the invalidated signal will be
236 emitted with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
237 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a>.
238 </p>
239 <p>
240 If a channel closes, the D-Bus signal ChannelLost is emitted; this class
241 doesn't (yet) have a GObject binding for this signal, but you can use
242 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()"><code class="function">tp_cli_channel_dispatch_operation_connect_to_channel_lost()</code></a>. If all channels
243 close, there is nothing more to dispatch, so the invalidated signal will be
244 emitted with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
245 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a>.
246 </p>
247 <p>
248 If the channel dispatcher crashes or exits, the invalidated
249 signal will be emitted with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
250 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-NAME-OWNER-LOST--CAPS"><code class="literal">TP_DBUS_ERROR_NAME_OWNER_LOST</code></a>. In a high-quality implementation, the
251 dispatcher should be restarted, at which point it will create new
252 channel dispatch operations for any undispatched channels, and the approver
253 will be notified again.
254 </p>
255 <p>
256 This proxy is usable but incomplete: accessors for the D-Bus properties will
257 be added in a later version of telepathy-glib, along with a mechanism
258 similar 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>.</p>
259 <p>
260 </p>
261 <p class="since">Since 0.7.UNRELEASED</p>
262 </div>
263 <hr>
264 <div class="refsect2" title="struct TpChannelDispatchOperationClass">
265 <a name="TpChannelDispatchOperationClass"></a><h3>struct TpChannelDispatchOperationClass</h3>
266 <pre class="programlisting">struct TpChannelDispatchOperationClass {
267 };
268 </pre>
269 <p>
270 The class of a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a>.</p>
271 <p>
272 </p>
273 </div>
274 <hr>
275 <div class="refsect2" title="tp_channel_dispatch_operation_new ()">
276 <a name="tp-channel-dispatch-operation-new"></a><h3>tp_channel_dispatch_operation_new ()</h3>
277 <pre class="programlisting"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> * tp_channel_dispatch_operation_new
278 (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
279 const <a
280 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
281 >gchar</a> *object_path,
282 <a
283 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
284 >GHashTable</a> *immutable_properties,
285 <a
286 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
287 >GError</a> **error);</pre>
288 <p>
289 Convenience function to create a new channel dispatch operation proxy.
290 </p>
291 <p>
292 The <em class="parameter"><code>immutable_properties</code></em> argument is not yet used.</p>
293 <p>
294 </p>
295 <div class="variablelist"><table border="0">
296 <col align="left" valign="top">
297 <tbody>
298 <tr>
299 <td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
300 <td> Proxy for the D-Bus daemon
301 </td>
302 </tr>
303 <tr>
304 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
305 <td> The non-NULL object path of this channel dispatch operation
306 </td>
307 </tr>
308 <tr>
309 <td><p><span class="term"><em class="parameter"><code>immutable_properties</code></em> :</span></p></td>
310 <td> As many as are known of the immutable D-Bus
311 properties of this channel dispatch operation, or <a
312 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
313 ><code class="literal">NULL</code></a> if none are known
314 </td>
315 </tr>
316 <tr>
317 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
318 <td> Used to raise an error if <a
319 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
320 ><code class="literal">NULL</code></a> is returned
321 </td>
322 </tr>
323 <tr>
324 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
325 <td> a new reference to an channel dispatch operation proxy, or <a
326 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
327 ><code class="literal">NULL</code></a> if
328 <em class="parameter"><code>object_path</code></em> is not syntactically valid or the channel dispatcher is not
329 running
330 </td>
331 </tr>
332 </tbody>
333 </table></div>
334 </div>
335 <hr>
336 <div class="refsect2" title="tp_channel_dispatch_operation_init_known_interfaces ()">
337 <a name="tp-channel-dispatch-operation-init-known-interfaces"></a><h3>tp_channel_dispatch_operation_init_known_interfaces ()</h3>
338 <pre class="programlisting">void tp_channel_dispatch_operation_init_known_interfaces
339 (void);</pre>
340 <p>
341 Ensure that the known interfaces for TpChannelDispatchOperation have been
342 set up. This is done automatically when necessary, but for correct
343 overriding of library interfaces by local extensions, you should
344 call this function before calling
345 <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
346 <code class="literal">TP_TYPE_CHANNEL_DISPATCH_OPERATION</code>.</p>
347 <p>
348 </p>
349 <p class="since">Since 0.7.UNRELEASED</p>
350 </div>
351 <hr>
352 <div class="refsect2" title="tp_cli_channel_dispatch_operation_callback_for_claim ()">
353 <a name="tp-cli-channel-dispatch-operation-callback-for-claim"></a><h3>tp_cli_channel_dispatch_operation_callback_for_claim ()</h3>
354 <pre class="programlisting">void (*tp_cli_channel_dispatch_operation_callback_for_claim)
355 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
356 const <a
357 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
358 >GError</a> *error,
359 <a
360 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
361 >gpointer</a> user_data,
362 <a
363 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
364 >GObject</a> *weak_object);</pre>
365 <p>
366 Signature of the callback called when a Claim method call
367 succeeds or fails.</p>
368 <p>
369 </p>
370 <div class="variablelist"><table border="0">
371 <col align="left" valign="top">
372 <tbody>
373 <tr>
374 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
375 <td> the proxy on which the call was made
376 </td>
377 </tr>
378 <tr>
379 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
380 <td> <a
381 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
382 ><code class="literal">NULL</code></a> on success, or an error on failure
383 </td>
384 </tr>
385 <tr>
386 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
387 <td> user-supplied data
388 </td>
389 </tr>
390 <tr>
391 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
392 <td> user-supplied object
393 </td>
394 </tr>
395 </tbody>
396 </table></div>
397 </div>
398 <hr>
399 <div class="refsect2" title="tp_cli_channel_dispatch_operation_call_claim ()">
400 <a name="tp-cli-channel-dispatch-operation-call-claim"></a><h3>tp_cli_channel_dispatch_operation_call_claim ()</h3>
401 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_dispatch_operation_call_claim
402 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
403 <a
404 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
405 >gint</a> timeout_ms,
406 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim" title="tp_cli_channel_dispatch_operation_callback_for_claim ()">tp_cli_channel_dispatch_operation_callback_for_claim</a> callback,
407 <a
408 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
409 >gpointer</a> user_data,
410 <a
411 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
412 >GDestroyNotify</a> destroy,
413 <a
414 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
415 >GObject</a> *weak_object);</pre>
416 <p>
417 Start a Claim method call.
418 </p>
419 <p>
420 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by an approver to claim channels for handling internally. If this method is called successfully, the process calling this method becomes the handler for the channel, but &lt;em&gt;does not&lt;/em&gt; have the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt; method called on it.&lt;/p&gt; &lt;p&gt;Clients that call Claim on channels but do not immediately close them SHOULD implement the Handler interface and its &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandledChannels&lt;/tp:dbus-ref&gt; property.&lt;/p&gt; &lt;p&gt;Approvers wishing to reject channels MUST call this method to claim ownership of them, and MUST NOT call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;Close&lt;/tp:dbus-ref&gt; on the channels unless/until this method returns successfully.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The channel dispatcher can't know how best to close arbitrary channel types, so it leaves it up to the approver to do so. For instance, for Text channels it is necessary to acknowledge any messages that have already been displayed to the user first - ideally, the approver would display and then acknowledge the messages - or to call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel.Interface.Destroyable.Destroy&lt;/tp:dbus-ref&gt; if the destructive behaviour of that method is desired.&lt;/p&gt; &lt;p&gt;Similarly, an Approver for StreamedMedia channels can close the channel with a reason (e.g. &amp;quot;busy&amp;quot;) if desired. The channel dispatcher, which is designed to have no specific knowledge of particular channel types, can't do that.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation object to disappear, emitting &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;, in the same way as for &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;This method may fail because the dispatch operation has already been completed. Again, see HandleWith for more details. The approver MUST NOT attempt to interact with the channels further in this case.&lt;/p&gt; &lt;p&gt;(FIXME: list some other possible errors)&lt;/p&gt;</p>
421 <p>
422 </p>
423 <div class="variablelist"><table border="0">
424 <col align="left" valign="top">
425 <tbody>
426 <tr>
427 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
428 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
429 </td>
430 </tr>
431 <tr>
432 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
433 <td> the timeout in milliseconds, or -1 to use the
434 default
435 </td>
436 </tr>
437 <tr>
438 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
439 <td> called when the method call succeeds or fails;
440 may be <a
441 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
442 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
443 reply tracking
444 </td>
445 </tr>
446 <tr>
447 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
448 <td> user-supplied data passed to the callback;
449 must be <a
450 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
451 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
452 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
453 ><code class="literal">NULL</code></a>
454 </td>
455 </tr>
456 <tr>
457 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
458 <td> called with the user_data as argument, after the
459 call has succeeded, failed or been cancelled;
460 must be <a
461 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
462 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
463 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
464 ><code class="literal">NULL</code></a>
465 </td>
466 </tr>
467 <tr>
468 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
469 <td> If not <a
470 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
471 ><code class="literal">NULL</code></a>, a <a
472 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
473 ><span class="type">GObject</span></a> which will be
474 weakly referenced; if it is destroyed, this call
475 will automatically be cancelled. Must be <a
476 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
477 ><code class="literal">NULL</code></a> if
478 <em class="parameter"><code>callback</code></em> is <a
479 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
480 ><code class="literal">NULL</code></a>
481 </td>
482 </tr>
483 <tr>
484 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
485 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
486 progress. It is borrowed from the object, and will become
487 invalid when the callback is called, the call is
488 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
489 </td>
490 </tr>
491 </tbody>
492 </table></div>
493 </div>
494 <hr>
495 <div class="refsect2" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()">
496 <a name="tp-cli-channel-dispatch-operation-callback-for-handle-with"></a><h3>tp_cli_channel_dispatch_operation_callback_for_handle_with ()</h3>
497 <pre class="programlisting">void (*tp_cli_channel_dispatch_operation_callback_for_handle_with)
498 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
499 const <a
500 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
501 >GError</a> *error,
502 <a
503 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
504 >gpointer</a> user_data,
505 <a
506 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
507 >GObject</a> *weak_object);</pre>
508 <p>
509 Signature of the callback called when a HandleWith method call
510 succeeds or fails.</p>
511 <p>
512 </p>
513 <div class="variablelist"><table border="0">
514 <col align="left" valign="top">
515 <tbody>
516 <tr>
517 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
518 <td> the proxy on which the call was made
519 </td>
520 </tr>
521 <tr>
522 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
523 <td> <a
524 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
525 ><code class="literal">NULL</code></a> on success, or an error on failure
526 </td>
527 </tr>
528 <tr>
529 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
530 <td> user-supplied data
531 </td>
532 </tr>
533 <tr>
534 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
535 <td> user-supplied object
536 </td>
537 </tr>
538 </tbody>
539 </table></div>
540 </div>
541 <hr>
542 <div class="refsect2" title="tp_cli_channel_dispatch_operation_call_handle_with ()">
543 <a name="tp-cli-channel-dispatch-operation-call-handle-with"></a><h3>tp_cli_channel_dispatch_operation_call_handle_with ()</h3>
544 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_dispatch_operation_call_handle_with
545 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
546 <a
547 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
548 >gint</a> timeout_ms,
549 const <a
550 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
551 >gchar</a> *in_Handler,
552 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()">tp_cli_channel_dispatch_operation_callback_for_handle_with</a> callback,
553 <a
554 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
555 >gpointer</a> user_data,
556 <a
557 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
558 >GDestroyNotify</a> destroy,
559 <a
560 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
561 >GObject</a> *weak_object);</pre>
562 <p>
563 Start a HandleWith method call.
564 </p>
565 <p>
566 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by an approver to accept a channel bundle and request that the given handler be used to handle it.&lt;/p&gt; &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation object to disappear, emitting &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;However, this method may fail because the dispatch has already been completed and the object has already gone. If this occurs, it indicates that another approver has asked for the bundle to be handled by a particular handler. The approver MUST NOT attempt to interact with the channels further in this case, unless it is separately invoked as the handler.&lt;/p&gt; &lt;p&gt;Approvers which are also channel handlers SHOULD use &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; instead of HandleWith to request that they can handle a channel bundle themselves.&lt;/p&gt; &lt;p&gt;(FIXME: list some possible errors)&lt;/p&gt; &lt;p&gt;If the channel handler raises an error from &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt;, this method MAY respond by raising that same error, even if it is not specifically documented here.&lt;/p&gt;</p>
567 <p>
568 </p>
569 <div class="variablelist"><table border="0">
570 <col align="left" valign="top">
571 <tbody>
572 <tr>
573 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
574 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
575 </td>
576 </tr>
577 <tr>
578 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
579 <td> the timeout in milliseconds, or -1 to use the
580 default
581 </td>
582 </tr>
583 <tr>
584 <td><p><span class="term"><em class="parameter"><code>in_Handler</code></em> :</span></p></td>
585 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the channel handler that should handle the channel, or the empty string if the client has no preferred channel handler.&lt;/p&gt;
586 </td>
587 </tr>
588 <tr>
589 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
590 <td> called when the method call succeeds or fails;
591 may be <a
592 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
593 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
594 reply tracking
595 </td>
596 </tr>
597 <tr>
598 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
599 <td> user-supplied data passed to the callback;
600 must be <a
601 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
602 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
603 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
604 ><code class="literal">NULL</code></a>
605 </td>
606 </tr>
607 <tr>
608 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
609 <td> called with the user_data as argument, after the
610 call has succeeded, failed or been cancelled;
611 must be <a
612 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
613 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
614 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
615 ><code class="literal">NULL</code></a>
616 </td>
617 </tr>
618 <tr>
619 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
620 <td> If not <a
621 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
622 ><code class="literal">NULL</code></a>, a <a
623 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
624 ><span class="type">GObject</span></a> which will be
625 weakly referenced; if it is destroyed, this call
626 will automatically be cancelled. Must be <a
627 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
628 ><code class="literal">NULL</code></a> if
629 <em class="parameter"><code>callback</code></em> is <a
630 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
631 ><code class="literal">NULL</code></a>
632 </td>
633 </tr>
634 <tr>
635 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
636 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
637 progress. It is borrowed from the object, and will become
638 invalid when the callback is called, the call is
639 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
640 </td>
641 </tr>
642 </tbody>
643 </table></div>
644 </div>
645 <hr>
646 <div class="refsect2" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()">
647 <a name="tp-cli-channel-dispatch-operation-signal-callback-channel-lost"></a><h3>tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()</h3>
648 <pre class="programlisting">void (*tp_cli_channel_dispatch_operation_signal_callback_channel_lost)
649 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
650 const <a
651 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
652 >gchar</a> *arg_Channel,
653 const <a
654 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
655 >gchar</a> *arg_Error,
656 const <a
657 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
658 >gchar</a> *arg_Message,
659 <a
660 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
661 >gpointer</a> user_data,
662 <a
663 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
664 >GObject</a> *weak_object);</pre>
665 <p>
666 Represents the signature of a callback for the signal ChannelLost.</p>
667 <p>
668 </p>
669 <div class="variablelist"><table border="0">
670 <col align="left" valign="top">
671 <tbody>
672 <tr>
673 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
674 <td> The proxy on which <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()"><code class="function">tp_cli_channel_dispatch_operation_connect_to_channel_lost()</code></a>
675 was called
676 </td>
677 </tr>
678 <tr>
679 <td><p><span class="term"><em class="parameter"><code>arg_Channel</code></em> :</span></p></td>
680 <td> The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel&lt;/tp:dbus-ref&gt; that closed.
681 </td>
682 </tr>
683 <tr>
684 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
685 <td> &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The name of a D-Bus error indicating why the channel closed. If no better reason can be found, &lt;code&gt;org.freedesktop.Telepathy.Error.NotAvailable&lt;/code&gt; MAY be used as a fallback; this means that this error SHOULD NOT be given any more specific meaning.&lt;/p&gt;
686 </td>
687 </tr>
688 <tr>
689 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
690 <td> A string associated with the D-Bus error.
691 </td>
692 </tr>
693 <tr>
694 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
695 <td> User-supplied data
696 </td>
697 </tr>
698 <tr>
699 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
700 <td> User-supplied weakly referenced object
701 </td>
702 </tr>
703 </tbody>
704 </table></div>
705 </div>
706 <hr>
707 <div class="refsect2" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()">
708 <a name="tp-cli-channel-dispatch-operation-connect-to-channel-lost"></a><h3>tp_cli_channel_dispatch_operation_connect_to_channel_lost ()</h3>
709 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_dispatch_operation_connect_to_channel_lost
710 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
711 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</a> callback,
712 <a
713 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
714 >gpointer</a> user_data,
715 <a
716 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
717 >GDestroyNotify</a> destroy,
718 <a
719 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
720 >GObject</a> *weak_object,
721 <a
722 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
723 >GError</a> **error);</pre>
724 <p>
725 Connect a handler to the signal ChannelLost.
726 </p>
727 <p>
728 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;A channel has closed before it could be claimed or handled. If this is emitted for the last remaining channel in a channel dispatch operation, it MUST immediately be followed by &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were invoked have returned (successfully or with an error) from their &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Approver"&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means that Approvers can connect to the ChannelLost signal in a race-free way. Non-approver processes that discover a channel dispatch operation in some way (such as observers) will have to follow the usual &amp;quot;connect to signals then recover state&amp;quot; model - first connect to ChannelLost and &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;, then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt; (and on error, perhaps assume that the operation has already Finished).&lt;/p&gt; &lt;/tp:rationale&gt;</p>
729 <p>
730 </p>
731 <div class="variablelist"><table border="0">
732 <col align="left" valign="top">
733 <tbody>
734 <tr>
735 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
736 <td> A <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> or subclass
737 </td>
738 </tr>
739 <tr>
740 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
741 <td> Callback to be called when the signal is
742 received
743 </td>
744 </tr>
745 <tr>
746 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
747 <td> User-supplied data for the callback
748 </td>
749 </tr>
750 <tr>
751 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
752 <td> Destructor for the user-supplied data, which
753 will be called when this signal is disconnected, or
754 before this function returns <a
755 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
756 ><code class="literal">NULL</code></a>
757 </td>
758 </tr>
759 <tr>
760 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
761 <td> A <a
762 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
763 ><span class="type">GObject</span></a> which will be weakly referenced;
764 if it is destroyed, this callback will automatically be
765 disconnected
766 </td>
767 </tr>
768 <tr>
769 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
770 <td> If not <a
771 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
772 ><code class="literal">NULL</code></a>, used to raise an error if <a
773 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
774 ><code class="literal">NULL</code></a> is
775 returned
776 </td>
777 </tr>
778 <tr>
779 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
780 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
781 above, which can be used to disconnect the signal; or
782 <a
783 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
784 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
785 or has become invalid.
786 </td>
787 </tr>
788 </tbody>
789 </table></div>
790 </div>
791 <hr>
792 <div class="refsect2" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()">
793 <a name="tp-cli-channel-dispatch-operation-signal-callback-finished"></a><h3>tp_cli_channel_dispatch_operation_signal_callback_finished ()</h3>
794 <pre class="programlisting">void (*tp_cli_channel_dispatch_operation_signal_callback_finished)
795 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
796 <a
797 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
798 >gpointer</a> user_data,
799 <a
800 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
801 >GObject</a> *weak_object);</pre>
802 <p>
803 Represents the signature of a callback for the signal Finished.</p>
804 <p>
805 </p>
806 <div class="variablelist"><table border="0">
807 <col align="left" valign="top">
808 <tbody>
809 <tr>
810 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
811 <td> The proxy on which <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished" title="tp_cli_channel_dispatch_operation_connect_to_finished ()"><code class="function">tp_cli_channel_dispatch_operation_connect_to_finished()</code></a>
812 was called
813 </td>
814 </tr>
815 <tr>
816 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
817 <td> User-supplied data
818 </td>
819 </tr>
820 <tr>
821 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
822 <td> User-supplied weakly referenced object
823 </td>
824 </tr>
825 </tbody>
826 </table></div>
827 </div>
828 <hr>
829 <div class="refsect2" title="tp_cli_channel_dispatch_operation_connect_to_finished ()">
830 <a name="tp-cli-channel-dispatch-operation-connect-to-finished"></a><h3>tp_cli_channel_dispatch_operation_connect_to_finished ()</h3>
831 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_dispatch_operation_connect_to_finished
832 (<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a> *proxy,
833 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()">tp_cli_channel_dispatch_operation_signal_callback_finished</a> callback,
834 <a
835 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
836 >gpointer</a> user_data,
837 <a
838 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
839 >GDestroyNotify</a> destroy,
840 <a
841 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
842 >GObject</a> *weak_object,
843 <a
844 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
845 >GError</a> **error);</pre>
846 <p>
847 Connect a handler to the signal Finished.
848 </p>
849 <p>
850 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Emitted when this dispatch operation finishes. The dispatch operation is no longer present and further methods must not be called on it.&lt;/p&gt; &lt;p&gt;Approvers that have a user interface SHOULD stop notifying the user about the channels in response to this signal; they MAY assume that on errors, they would have received &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; first.&lt;/p&gt; &lt;p&gt;Its object path SHOULD NOT be reused for a subsequent dispatch operation; the ChannelDispatcher MUST choose object paths in a way that avoids immediate re-use.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Otherwise, clients might accidentally call &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt; or &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; on a new dispatch operation instead of the one they intended to handle.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were invoked have returned (successfully or with an error) from their &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Approver"&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means that Approvers can connect to the ChannelLost signal in a race-free way. Non-approver processes that discover a channel dispatch operation in some way (such as observers) will have to follow the usual &amp;quot;connect to signals then recover state&amp;quot; model - first connect to &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; and Finished, then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt; (and on error, perhaps assume that the operation has already Finished).&lt;/p&gt; &lt;/tp:rationale&gt;</p>
851 <p>
852 </p>
853 <div class="variablelist"><table border="0">
854 <col align="left" valign="top">
855 <tbody>
856 <tr>
857 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
858 <td> A <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> or subclass
859 </td>
860 </tr>
861 <tr>
862 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
863 <td> Callback to be called when the signal is
864 received
865 </td>
866 </tr>
867 <tr>
868 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
869 <td> User-supplied data for the callback
870 </td>
871 </tr>
872 <tr>
873 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
874 <td> Destructor for the user-supplied data, which
875 will be called when this signal is disconnected, or
876 before this function returns <a
877 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
878 ><code class="literal">NULL</code></a>
879 </td>
880 </tr>
881 <tr>
882 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
883 <td> A <a
884 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
885 ><span class="type">GObject</span></a> which will be weakly referenced;
886 if it is destroyed, this callback will automatically be
887 disconnected
888 </td>
889 </tr>
890 <tr>
891 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
892 <td> If not <a
893 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
894 ><code class="literal">NULL</code></a>, used to raise an error if <a
895 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
896 ><code class="literal">NULL</code></a> is
897 returned
898 </td>
899 </tr>
900 <tr>
901 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
902 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
903 above, which can be used to disconnect the signal; or
904 <a
905 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
906 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
907 or has become invalid.
908 </td>
909 </tr>
910 </tbody>
911 </table></div>
912 </div>
913 </div>
914 <div class="refsect1" title="See Also">
915 <a name="telepathy-glib-channel-dispatch-operation.see-also"></a><h2>See Also</h2>
916 #TpChannelDispatcher
917 </div>
918 </div>
919 <div class="footer">
920 <hr>
921 Generated by GTK-Doc V1.11</div>
922 </body>
923 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpChannelDispatcher</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-account.html" title="TpAccount">
9 <link rel="next" href="telepathy-glib-channel-dispatch-operation.html" title="TpChannelDispatchOperation">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-account.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-channel-dispatch-operation.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-channel-dispatcher.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-channel-dispatcher.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-channel-dispatcher.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="TpChannelDispatcher">
38 <a name="telepathy-glib-channel-dispatcher"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-channel-dispatcher.top_of_page"></a>TpChannelDispatcher</span></h2>
42 <p>TpChannelDispatcher — proxy object for the Telepathy channel dispatcher</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv" title="Synopsis">
47 <a name="telepathy-glib-channel-dispatcher.synopsis"></a><h2>Synopsis</h2>
48 <a name="TpChannelDispatcher"></a><pre class="synopsis">
49
50 #include &lt;telepathy-glib/channel-dispatcher.h&gt;
51
52 <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher-struct" title="TpChannelDispatcher">TpChannelDispatcher</a>;
53 <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcherClass" title="TpChannelDispatcherClass">TpChannelDispatcherClass</a>;
54 <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> * <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-new" title="tp_channel_dispatcher_new ()">tp_channel_dispatcher_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon);
55 void <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-init-known-interfaces" title="tp_channel_dispatcher_init_known_interfaces ()">tp_channel_dispatcher_init_known_interfaces</a>
56 (void);
57
58 void (<a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel" title="tp_cli_channel_dispatcher_callback_for_create_channel ()">*tp_cli_channel_dispatcher_callback_for_create_channel</a>)
59 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
60 const <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
62 >gchar</a> *out_Request,
63 const <a
64 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
65 >GError</a> *error,
66 <a
67 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
68 >gpointer</a> user_data,
69 <a
70 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
71 >GObject</a> *weak_object);
72 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-create-channel" title="tp_cli_channel_dispatcher_call_create_channel ()">tp_cli_channel_dispatcher_call_create_channel</a>
73 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
74 <a
75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
76 >gint</a> timeout_ms,
77 const <a
78 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
79 >gchar</a> *in_Account,
80 <a
81 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
82 >GHashTable</a> *in_Requested_Properties,
83 <a
84 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
85 >gint64</a> in_User_Action_Time,
86 const <a
87 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
88 >gchar</a> *in_Preferred_Handler,
89 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel" title="tp_cli_channel_dispatcher_callback_for_create_channel ()">tp_cli_channel_dispatcher_callback_for_create_channel</a> callback,
90 <a
91 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
92 >gpointer</a> user_data,
93 <a
94 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
95 >GDestroyNotify</a> destroy,
96 <a
97 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
98 >GObject</a> *weak_object);
99 void (<a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel" title="tp_cli_channel_dispatcher_callback_for_ensure_channel ()">*tp_cli_channel_dispatcher_callback_for_ensure_channel</a>)
100 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
101 const <a
102 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
103 >gchar</a> *out_Request,
104 const <a
105 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
106 >GError</a> *error,
107 <a
108 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
109 >gpointer</a> user_data,
110 <a
111 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
112 >GObject</a> *weak_object);
113 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-ensure-channel" title="tp_cli_channel_dispatcher_call_ensure_channel ()">tp_cli_channel_dispatcher_call_ensure_channel</a>
114 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
115 <a
116 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
117 >gint</a> timeout_ms,
118 const <a
119 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
120 >gchar</a> *in_Account,
121 <a
122 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
123 >GHashTable</a> *in_Requested_Properties,
124 <a
125 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
126 >gint64</a> in_User_Action_Time,
127 const <a
128 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
129 >gchar</a> *in_Preferred_Handler,
130 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel" title="tp_cli_channel_dispatcher_callback_for_ensure_channel ()">tp_cli_channel_dispatcher_callback_for_ensure_channel</a> callback,
131 <a
132 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
133 >gpointer</a> user_data,
134 <a
135 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
136 >GDestroyNotify</a> destroy,
137 <a
138 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
139 >GObject</a> *weak_object);
140
141 void (<a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()">*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</a>)
142 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
143 const <a
144 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
145 >gchar</a> *arg_Dispatch_Operation,
146 <a
147 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
148 >gpointer</a> user_data,
149 <a
150 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
151 >GObject</a> *weak_object);
152 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()">tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished</a>
153 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
154 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</a> callback,
155 <a
156 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
157 >gpointer</a> user_data,
158 <a
159 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
160 >GDestroyNotify</a> destroy,
161 <a
162 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
163 >GObject</a> *weak_object,
164 <a
165 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
166 >GError</a> **error);
167 void (<a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()">*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</a>)
168 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
169 const <a
170 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
171 >gchar</a> *arg_Dispatch_Operation,
172 <a
173 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
174 >GHashTable</a> *arg_Properties,
175 <a
176 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
177 >gpointer</a> user_data,
178 <a
179 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
180 >GObject</a> *weak_object);
181 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()">tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation</a>
182 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
183 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</a> callback,
184 <a
185 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
186 >gpointer</a> user_data,
187 <a
188 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
189 >GDestroyNotify</a> destroy,
190 <a
191 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
192 >GObject</a> *weak_object,
193 <a
194 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
195 >GError</a> **error);
196 </pre>
197 </div>
198 <div class="refsect1" title="Object Hierarchy">
199 <a name="telepathy-glib-channel-dispatcher.object-hierarchy"></a><h2>Object Hierarchy</h2>
200 <pre class="synopsis">
201 <a
202 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
203 >GObject</a>
204 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
205 +----TpChannelDispatcher
206 </pre>
207 </div>
208 <div class="refsect1" title="Description">
209 <a name="telepathy-glib-channel-dispatcher.description"></a><h2>Description</h2>
210 <p>
211 The <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher"><span class="type">TpChannelDispatcher</span></a> object can be used to communicate with any
212 implementation of the Telepathy ChannelDispatcher service to request
213 new channels.</p>
214 <p>
215 </p>
216 </div>
217 <div class="refsect1" title="Details">
218 <a name="telepathy-glib-channel-dispatcher.details"></a><h2>Details</h2>
219 <div class="refsect2" title="TpChannelDispatcher">
220 <a name="TpChannelDispatcher-struct"></a><h3>TpChannelDispatcher</h3>
221 <pre class="programlisting">typedef struct _TpChannelDispatcher TpChannelDispatcher;</pre>
222 <p>
223 The Channel Dispatcher's main D-Bus API is used to request channels,
224 which is done by calling <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-create-channel" title="tp_cli_channel_dispatcher_call_create_channel ()"><code class="function">tp_cli_channel_dispatcher_call_create_channel()</code></a> or
225 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-ensure-channel" title="tp_cli_channel_dispatcher_call_ensure_channel ()"><code class="function">tp_cli_channel_dispatcher_call_ensure_channel()</code></a> as appropriate.
226 </p>
227 <p>
228 The Telepathy Channel Dispatcher is also responsible for responding to new
229 channels and launching client processes to handle them. However, clients
230 that can work with incoming channels do not have to call methods
231 on the channel dispatcher: instead, they must register with the channel
232 dispatcher passively, by taking a bus name starting with
233 <a class="link" href="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE--CAPS" title="TP_CLIENT_BUS_NAME_BASE"><code class="literal">TP_CLIENT_BUS_NAME_BASE</code></a> and implementing the <a class="link" href="telepathy-glib-svc-client.html#TpSvcClient"><span class="type">TpSvcClient</span></a> interface.
234 See the Telepathy D-Bus Interface Specification for details.
235 </p>
236 <p>
237 This proxy is usable but incomplete: convenience methods will be added in
238 a later version of telepathy-glib, along with a mechanism similar to
239 <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>.</p>
240 <p>
241 </p>
242 <p class="since">Since 0.7.UNRELEASED</p>
243 </div>
244 <hr>
245 <div class="refsect2" title="TpChannelDispatcherClass">
246 <a name="TpChannelDispatcherClass"></a><h3>TpChannelDispatcherClass</h3>
247 <pre class="programlisting">typedef struct {
248 } TpChannelDispatcherClass;
249 </pre>
250 <p>
251 The class of a <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher"><span class="type">TpChannelDispatcher</span></a>.</p>
252 <p>
253 </p>
254 </div>
255 <hr>
256 <div class="refsect2" title="tp_channel_dispatcher_new ()">
257 <a name="tp-channel-dispatcher-new"></a><h3>tp_channel_dispatcher_new ()</h3>
258 <pre class="programlisting"><a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> * tp_channel_dispatcher_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon);</pre>
259 <p>
260 Convenience function to create a new channel dispatcher proxy.</p>
261 <p>
262 </p>
263 <div class="variablelist"><table border="0">
264 <col align="left" valign="top">
265 <tbody>
266 <tr>
267 <td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
268 <td> Proxy for the D-Bus daemon
269 </td>
270 </tr>
271 <tr>
272 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
273 <td> a new reference to a channel dispatcher proxy
274 </td>
275 </tr>
276 </tbody>
277 </table></div>
278 </div>
279 <hr>
280 <div class="refsect2" title="tp_channel_dispatcher_init_known_interfaces ()">
281 <a name="tp-channel-dispatcher-init-known-interfaces"></a><h3>tp_channel_dispatcher_init_known_interfaces ()</h3>
282 <pre class="programlisting">void tp_channel_dispatcher_init_known_interfaces
283 (void);</pre>
284 <p>
285 Ensure that the known interfaces for TpChannelDispatcher have been set up.
286 This is done automatically when necessary, but for correct
287 overriding of library interfaces by local extensions, you should
288 call this function before calling
289 <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
290 <code class="literal">TP_TYPE_CHANNEL_DISPATCHER</code>.</p>
291 <p>
292 </p>
293 <p class="since">Since 0.7.UNRELEASED</p>
294 </div>
295 <hr>
296 <div class="refsect2" title="tp_cli_channel_dispatcher_callback_for_create_channel ()">
297 <a name="tp-cli-channel-dispatcher-callback-for-create-channel"></a><h3>tp_cli_channel_dispatcher_callback_for_create_channel ()</h3>
298 <pre class="programlisting">void (*tp_cli_channel_dispatcher_callback_for_create_channel)
299 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
300 const <a
301 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
302 >gchar</a> *out_Request,
303 const <a
304 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
305 >GError</a> *error,
306 <a
307 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
308 >gpointer</a> user_data,
309 <a
310 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
311 >GObject</a> *weak_object);</pre>
312 <p>
313 Signature of the callback called when a CreateChannel method call
314 succeeds or fails.</p>
315 <p>
316 </p>
317 <div class="variablelist"><table border="0">
318 <col align="left" valign="top">
319 <tbody>
320 <tr>
321 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
322 <td> the proxy on which the call was made
323 </td>
324 </tr>
325 <tr>
326 <td><p><span class="term"><em class="parameter"><code>out_Request</code></em> :</span></p></td>
327 <td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
328 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
329 ><code class="literal">NULL</code></a>: A &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object.
330 </td>
331 </tr>
332 <tr>
333 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
334 <td> <a
335 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
336 ><code class="literal">NULL</code></a> on success, or an error on failure
337 </td>
338 </tr>
339 <tr>
340 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
341 <td> user-supplied data
342 </td>
343 </tr>
344 <tr>
345 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
346 <td> user-supplied object
347 </td>
348 </tr>
349 </tbody>
350 </table></div>
351 </div>
352 <hr>
353 <div class="refsect2" title="tp_cli_channel_dispatcher_call_create_channel ()">
354 <a name="tp-cli-channel-dispatcher-call-create-channel"></a><h3>tp_cli_channel_dispatcher_call_create_channel ()</h3>
355 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_dispatcher_call_create_channel
356 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
357 <a
358 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
359 >gint</a> timeout_ms,
360 const <a
361 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
362 >gchar</a> *in_Account,
363 <a
364 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
365 >GHashTable</a> *in_Requested_Properties,
366 <a
367 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
368 >gint64</a> in_User_Action_Time,
369 const <a
370 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
371 >gchar</a> *in_Preferred_Handler,
372 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel" title="tp_cli_channel_dispatcher_callback_for_create_channel ()">tp_cli_channel_dispatcher_callback_for_create_channel</a> callback,
373 <a
374 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
375 >gpointer</a> user_data,
376 <a
377 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
378 >GDestroyNotify</a> destroy,
379 <a
380 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
381 >GObject</a> *weak_object);</pre>
382 <p>
383 Start a CreateChannel method call.
384 </p>
385 <p>
386 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Start a request to create a channel. This initially just creates a &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which can be used to continue the request and track its success or failure.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The request can take a long time - in the worst case, the channel dispatcher has to ask the account manager to put the account online, the account manager has to ask the operating system to obtain an Internet connection, and the operating system has to ask the user whether to activate an Internet connection using an on-demand mechanism like dialup.&lt;/p&gt; &lt;p&gt;This means that using a single D-Bus method call and response to represent the whole request will tend to lead to that call timing out, which is not the behaviour we want.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If this method is called for an Account that is disabled, invalid or otherwise unusable, no error is signalled until &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest.Proceed&lt;/tp:dbus-ref&gt; is called, at which point &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest.Failed&lt;/tp:dbus-ref&gt; is emitted with an appropriate error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means there's only one code path for errors, apart from InvalidArgument for &amp;quot;that request makes no sense&amp;quot;.&lt;/p&gt; &lt;p&gt;It also means that the request will proceed if the account is enabled after calling CreateChannel, but before calling Proceed.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
387 <p>
388 </p>
389 <div class="variablelist"><table border="0">
390 <col align="left" valign="top">
391 <tbody>
392 <tr>
393 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
394 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
395 </td>
396 </tr>
397 <tr>
398 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
399 <td> the timeout in milliseconds, or -1 to use the
400 default
401 </td>
402 </tr>
403 <tr>
404 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
405 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt; for which the new channel is to be created.
406 </td>
407 </tr>
408 <tr>
409 <td><p><span class="term"><em class="parameter"><code>in_Requested_Properties</code></em> :</span></p></td>
410 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;A dictionary containing desirable properties. This has the same semantics as the corresponding parameter to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection.Interface.Requests.CreateChannel&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Certain properties will not necessarily make sense in this dictionary: for instance, &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt; can only be given if the requester is able to interact with a &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection&lt;/tp:dbus-ref&gt; to the desired account.&lt;/p&gt;
411 </td>
412 </tr>
413 <tr>
414 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
415 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The time at which user action occurred, or 0 if this channel request is for some reason not involving user action. The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelRequest"&gt;UserActionTime&lt;/tp:dbus-ref&gt; property will be set to this value, and it will eventually be passed as the &lt;code&gt;User_Action_Time&lt;/code&gt; parameter of &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt;.&lt;/p&gt;
416 </td>
417 </tr>
418 <tr>
419 <td><p><span class="term"><em class="parameter"><code>in_Preferred_Handler</code></em> :</span></p></td>
420 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Either the well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the preferred handler for this channel, or an empty string to indicate that any handler would be acceptable. The channel dispatcher SHOULD dispatch as many as possible of the resulting channels (ideally, all of them) to that handler, and SHOULD remember the preferred handler so it can try to dispatch subsequent channels in the same bundle to the same handler.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This must be the well-known bus name, not the unique name, to ensure that all handlers do indeed have the Client API, and the Client object on the handler can be located easily.&lt;/p&gt; &lt;p&gt;This is partly so the channel dispatcher can call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt; on it, and partly so the channel dispatcher can recover state if it crashes and is restarted.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If this is a well-known bus name and the handler has the Requests interface, the channel dispatcher SHOULD call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Interface.Requests"&gt;AddRequest&lt;/tp:dbus-ref&gt; on that Handler after this method has returned.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This ordering allows a Handler which calls CreateChannel with itself as the preferred handler to associate the call to AddRequest with that call.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This is copied to the ChannelRequest that is returned, as the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelRequest"&gt;PreferredHandler&lt;/tp:dbus-ref&gt; property.&lt;/p&gt;
421 </td>
422 </tr>
423 <tr>
424 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
425 <td> called when the method call succeeds or fails;
426 may be <a
427 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
428 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
429 reply tracking
430 </td>
431 </tr>
432 <tr>
433 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
434 <td> user-supplied data passed to the callback;
435 must be <a
436 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
437 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
438 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
439 ><code class="literal">NULL</code></a>
440 </td>
441 </tr>
442 <tr>
443 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
444 <td> called with the user_data as argument, after the
445 call has succeeded, failed or been cancelled;
446 must be <a
447 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
448 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
449 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
450 ><code class="literal">NULL</code></a>
451 </td>
452 </tr>
453 <tr>
454 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
455 <td> If not <a
456 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
457 ><code class="literal">NULL</code></a>, a <a
458 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
459 ><span class="type">GObject</span></a> which will be
460 weakly referenced; if it is destroyed, this call
461 will automatically be cancelled. Must be <a
462 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
463 ><code class="literal">NULL</code></a> if
464 <em class="parameter"><code>callback</code></em> is <a
465 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
466 ><code class="literal">NULL</code></a>
467 </td>
468 </tr>
469 <tr>
470 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
471 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
472 progress. It is borrowed from the object, and will become
473 invalid when the callback is called, the call is
474 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
475 </td>
476 </tr>
477 </tbody>
478 </table></div>
479 </div>
480 <hr>
481 <div class="refsect2" title="tp_cli_channel_dispatcher_callback_for_ensure_channel ()">
482 <a name="tp-cli-channel-dispatcher-callback-for-ensure-channel"></a><h3>tp_cli_channel_dispatcher_callback_for_ensure_channel ()</h3>
483 <pre class="programlisting">void (*tp_cli_channel_dispatcher_callback_for_ensure_channel)
484 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
485 const <a
486 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
487 >gchar</a> *out_Request,
488 const <a
489 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
490 >GError</a> *error,
491 <a
492 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
493 >gpointer</a> user_data,
494 <a
495 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
496 >GObject</a> *weak_object);</pre>
497 <p>
498 Signature of the callback called when a EnsureChannel method call
499 succeeds or fails.</p>
500 <p>
501 </p>
502 <div class="variablelist"><table border="0">
503 <col align="left" valign="top">
504 <tbody>
505 <tr>
506 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
507 <td> the proxy on which the call was made
508 </td>
509 </tr>
510 <tr>
511 <td><p><span class="term"><em class="parameter"><code>out_Request</code></em> :</span></p></td>
512 <td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a
513 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
514 ><code class="literal">NULL</code></a>: A &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object.
515 </td>
516 </tr>
517 <tr>
518 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
519 <td> <a
520 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
521 ><code class="literal">NULL</code></a> on success, or an error on failure
522 </td>
523 </tr>
524 <tr>
525 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
526 <td> user-supplied data
527 </td>
528 </tr>
529 <tr>
530 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
531 <td> user-supplied object
532 </td>
533 </tr>
534 </tbody>
535 </table></div>
536 </div>
537 <hr>
538 <div class="refsect2" title="tp_cli_channel_dispatcher_call_ensure_channel ()">
539 <a name="tp-cli-channel-dispatcher-call-ensure-channel"></a><h3>tp_cli_channel_dispatcher_call_ensure_channel ()</h3>
540 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_dispatcher_call_ensure_channel
541 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
542 <a
543 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
544 >gint</a> timeout_ms,
545 const <a
546 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
547 >gchar</a> *in_Account,
548 <a
549 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
550 >GHashTable</a> *in_Requested_Properties,
551 <a
552 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
553 >gint64</a> in_User_Action_Time,
554 const <a
555 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
556 >gchar</a> *in_Preferred_Handler,
557 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel" title="tp_cli_channel_dispatcher_callback_for_ensure_channel ()">tp_cli_channel_dispatcher_callback_for_ensure_channel</a> callback,
558 <a
559 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
560 >gpointer</a> user_data,
561 <a
562 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
563 >GDestroyNotify</a> destroy,
564 <a
565 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
566 >GObject</a> *weak_object);</pre>
567 <p>
568 Start a EnsureChannel method call.
569 </p>
570 <p>
571 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Start a request to ensure that a channel exists, creating it if necessary. This initially just creates a &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which can be used to continue the request and track its success or failure.&lt;/p&gt; &lt;p&gt;If this method is called for an Account that is disabled, invalid or otherwise unusable, no error is signalled until &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest.Proceed&lt;/tp:dbus-ref&gt; is called, at which point &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest.Failed&lt;/tp:dbus-ref&gt; is emitted with an appropriate error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The rationale is as for &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher"&gt;CreateChannel&lt;/tp:dbus-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
572 <p>
573 </p>
574 <div class="variablelist"><table border="0">
575 <col align="left" valign="top">
576 <tbody>
577 <tr>
578 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
579 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
580 </td>
581 </tr>
582 <tr>
583 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
584 <td> the timeout in milliseconds, or -1 to use the
585 default
586 </td>
587 </tr>
588 <tr>
589 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
590 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt; for which the new channel is to be created.
591 </td>
592 </tr>
593 <tr>
594 <td><p><span class="term"><em class="parameter"><code>in_Requested_Properties</code></em> :</span></p></td>
595 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;A dictionary containing desirable properties. This has the same semantics as the corresponding parameter to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection.Interface.Requests.EnsureChannel&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Certain properties will not necessarily make sense in this dictionary: for instance, &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt; can only be given if the requester is able to interact with a &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection&lt;/tp:dbus-ref&gt; to the desired account.&lt;/p&gt;
596 </td>
597 </tr>
598 <tr>
599 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
600 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The time at which user action occurred, or 0 if this channel request is for some reason not involving user action.&lt;/p&gt; &lt;p&gt;This parameter is used in the same way as the corresponding parameter to &lt;tp:member-ref&gt;CreateChannel&lt;/tp:member-ref&gt;.&lt;/p&gt;
601 </td>
602 </tr>
603 <tr>
604 <td><p><span class="term"><em class="parameter"><code>in_Preferred_Handler</code></em> :</span></p></td>
605 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Either the well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the preferred handler for this channel, or an empty string to indicate that any handler would be acceptable. The behaviour and rationale are the same as for the corresponding parameter to &lt;tp:member-ref&gt;CreateChannel&lt;/tp:member-ref&gt;, except as noted here.&lt;/p&gt; &lt;p&gt;If any new channels are created in response to this request, the channel dispatcher SHOULD dispatch as many as possible of the resulting channels (ideally, all of them) to that handler, and SHOULD remember the preferred handler so it can try to dispatch subsequent channels in the same bundle to the same handler. If the requested channel already exists (that is, &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection.Interface.Requests.EnsureChannel&lt;/tp:dbus-ref&gt; returns &lt;code&gt;Yours=False&lt;/code&gt;) then the channel dispatcher SHOULD re-dispatch the channel to its existing handler, and MUST NOT dispatch it to this client (unless it is the existing handler); the request is still deemed to have succeeded in this case.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;An address book application, for example, might call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher"&gt;EnsureChannel&lt;/tp:dbus-ref&gt; to ensure that a text channel with a particular contact is displayed to the user; it does not care whether a new channel was made. An IM client might call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher"&gt;EnsureChannel&lt;/tp:dbus-ref&gt; in response to the user double-clicking an entry in the contact list, with itself as the &lt;code&gt;Preferred_Handler&lt;/code&gt;; if the user already has a conversation with that contact in another application, they would expect the existing window to be presented, rather than their double-click leading to an error message. So the request should succeed, even if its &lt;code&gt;Preferred_Handler&lt;/code&gt; is not used.&lt;/p&gt; &lt;/tp:rationale&gt;
606 </td>
607 </tr>
608 <tr>
609 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
610 <td> called when the method call succeeds or fails;
611 may be <a
612 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
613 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
614 reply tracking
615 </td>
616 </tr>
617 <tr>
618 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
619 <td> user-supplied data passed to the callback;
620 must be <a
621 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
622 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
623 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
624 ><code class="literal">NULL</code></a>
625 </td>
626 </tr>
627 <tr>
628 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
629 <td> called with the user_data as argument, after the
630 call has succeeded, failed or been cancelled;
631 must be <a
632 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
633 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
634 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
635 ><code class="literal">NULL</code></a>
636 </td>
637 </tr>
638 <tr>
639 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
640 <td> If not <a
641 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
642 ><code class="literal">NULL</code></a>, a <a
643 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
644 ><span class="type">GObject</span></a> which will be
645 weakly referenced; if it is destroyed, this call
646 will automatically be cancelled. Must be <a
647 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
648 ><code class="literal">NULL</code></a> if
649 <em class="parameter"><code>callback</code></em> is <a
650 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
651 ><code class="literal">NULL</code></a>
652 </td>
653 </tr>
654 <tr>
655 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
656 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
657 progress. It is borrowed from the object, and will become
658 invalid when the callback is called, the call is
659 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
660 </td>
661 </tr>
662 </tbody>
663 </table></div>
664 </div>
665 <hr>
666 <div class="refsect2" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()">
667 <a name="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished"></a><h3>tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()</h3>
668 <pre class="programlisting">void (*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished)
669 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
670 const <a
671 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
672 >gchar</a> *arg_Dispatch_Operation,
673 <a
674 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
675 >gpointer</a> user_data,
676 <a
677 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
678 >GObject</a> *weak_object);</pre>
679 <p>
680 Represents the signature of a callback for the signal DispatchOperationFinished.</p>
681 <p>
682 </p>
683 <div class="variablelist"><table border="0">
684 <col align="left" valign="top">
685 <tbody>
686 <tr>
687 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
688 <td> The proxy on which <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()"><code class="function">tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished()</code></a>
689 was called
690 </td>
691 </tr>
692 <tr>
693 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
694 <td> The dispatch operation that was closed.
695 </td>
696 </tr>
697 <tr>
698 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
699 <td> User-supplied data
700 </td>
701 </tr>
702 <tr>
703 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
704 <td> User-supplied weakly referenced object
705 </td>
706 </tr>
707 </tbody>
708 </table></div>
709 </div>
710 <hr>
711 <div class="refsect2" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()">
712 <a name="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"></a><h3>tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()</h3>
713 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished
714 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
715 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</a> callback,
716 <a
717 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
718 >gpointer</a> user_data,
719 <a
720 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
721 >GDestroyNotify</a> destroy,
722 <a
723 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
724 >GObject</a> *weak_object,
725 <a
726 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
727 >GError</a> **error);</pre>
728 <p>
729 Connect a handler to the signal DispatchOperationFinished.
730 </p>
731 <p>
732 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; Emitted when a dispatch operation finishes (i.e. exactly once per emission of &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation.Finished&lt;/tp:dbus-ref&gt;). &lt;tp:rationale&gt; Strictly speaking this is redundant with ChannelDispatchOperation.Finished, but it provides full change-notification for the &lt;tp:member-ref&gt;DispatchOperations&lt;/tp:member-ref&gt; property. &lt;/tp:rationale&gt;</p>
733 <p>
734 </p>
735 <div class="variablelist"><table border="0">
736 <col align="left" valign="top">
737 <tbody>
738 <tr>
739 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
740 <td> A <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher"><span class="type">TpChannelDispatcher</span></a> or subclass
741 </td>
742 </tr>
743 <tr>
744 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
745 <td> Callback to be called when the signal is
746 received
747 </td>
748 </tr>
749 <tr>
750 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
751 <td> User-supplied data for the callback
752 </td>
753 </tr>
754 <tr>
755 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
756 <td> Destructor for the user-supplied data, which
757 will be called when this signal is disconnected, or
758 before this function returns <a
759 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
760 ><code class="literal">NULL</code></a>
761 </td>
762 </tr>
763 <tr>
764 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
765 <td> A <a
766 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
767 ><span class="type">GObject</span></a> which will be weakly referenced;
768 if it is destroyed, this callback will automatically be
769 disconnected
770 </td>
771 </tr>
772 <tr>
773 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
774 <td> If not <a
775 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
776 ><code class="literal">NULL</code></a>, used to raise an error if <a
777 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
778 ><code class="literal">NULL</code></a> is
779 returned
780 </td>
781 </tr>
782 <tr>
783 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
784 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
785 above, which can be used to disconnect the signal; or
786 <a
787 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
788 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
789 or has become invalid.
790 </td>
791 </tr>
792 </tbody>
793 </table></div>
794 </div>
795 <hr>
796 <div class="refsect2" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()">
797 <a name="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation"></a><h3>tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()</h3>
798 <pre class="programlisting">void (*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation)
799 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
800 const <a
801 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
802 >gchar</a> *arg_Dispatch_Operation,
803 <a
804 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
805 >GHashTable</a> *arg_Properties,
806 <a
807 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
808 >gpointer</a> user_data,
809 <a
810 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
811 >GObject</a> *weak_object);</pre>
812 <p>
813 Represents the signature of a callback for the signal NewDispatchOperation.</p>
814 <p>
815 </p>
816 <div class="variablelist"><table border="0">
817 <col align="left" valign="top">
818 <tbody>
819 <tr>
820 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
821 <td> The proxy on which <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()"><code class="function">tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation()</code></a>
822 was called
823 </td>
824 </tr>
825 <tr>
826 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
827 <td> The dispatch operation that was created.
828 </td>
829 </tr>
830 <tr>
831 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
832 <td> The same properties that would appear in the Properties member of &lt;tp:type-ref&gt;Dispatch_Operation_Details&lt;/tp:type-ref&gt;.
833 </td>
834 </tr>
835 <tr>
836 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
837 <td> User-supplied data
838 </td>
839 </tr>
840 <tr>
841 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
842 <td> User-supplied weakly referenced object
843 </td>
844 </tr>
845 </tbody>
846 </table></div>
847 </div>
848 <hr>
849 <div class="refsect2" title="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()">
850 <a name="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"></a><h3>tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()</h3>
851 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation
852 (<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a> *proxy,
853 <a class="link" href="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation" title="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</a> callback,
854 <a
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);</pre>
866 <p>
867 Connect a handler to the signal NewDispatchOperation.
868 </p>
869 <p>
870 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Emitted when a dispatch operation is added to &lt;tp:member-ref&gt;DispatchOperations&lt;/tp:member-ref&gt;.&lt;/p&gt;</p>
871 <p>
872 </p>
873 <div class="variablelist"><table border="0">
874 <col align="left" valign="top">
875 <tbody>
876 <tr>
877 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
878 <td> A <a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher"><span class="type">TpChannelDispatcher</span></a> or subclass
879 </td>
880 </tr>
881 <tr>
882 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
883 <td> Callback to be called when the signal is
884 received
885 </td>
886 </tr>
887 <tr>
888 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
889 <td> User-supplied data for the callback
890 </td>
891 </tr>
892 <tr>
893 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
894 <td> Destructor for the user-supplied data, which
895 will be called when this signal is disconnected, or
896 before this function returns <a
897 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
898 ><code class="literal">NULL</code></a>
899 </td>
900 </tr>
901 <tr>
902 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
903 <td> A <a
904 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
905 ><span class="type">GObject</span></a> which will be weakly referenced;
906 if it is destroyed, this callback will automatically be
907 disconnected
908 </td>
909 </tr>
910 <tr>
911 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
912 <td> If not <a
913 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
914 ><code class="literal">NULL</code></a>, used to raise an error if <a
915 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
916 ><code class="literal">NULL</code></a> is
917 returned
918 </td>
919 </tr>
920 <tr>
921 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
922 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
923 above, which can be used to disconnect the signal; or
924 <a
925 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
926 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
927 or has become invalid.
928 </td>
929 </tr>
930 </tbody>
931 </table></div>
932 </div>
933 </div>
934 <div class="refsect1" title="See Also">
935 <a name="telepathy-glib-channel-dispatcher.see-also"></a><h2>See Also</h2>
936 #TpChannelDispatchOperation, <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a>
937 </div>
938 </div>
939 <div class="footer">
940 <hr>
941 Generated by GTK-Doc V1.11</div>
942 </body>
943 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>File transfer</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-media.html" title="Media channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Group interface on Channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel.html" title="TpChannel">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Media channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-text.html" title="Text channels">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpChannelRequest</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-channel-dispatch-operation.html" title="TpChannelDispatchOperation">
9 <link rel="next" href="telepathy-glib-client.html" title="TpClient">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-channel-dispatch-operation.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-client.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-channel-request.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-channel-request.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-channel-request.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-channel-request.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="TpChannelRequest">
40 <a name="telepathy-glib-channel-request"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-channel-request.top_of_page"></a>TpChannelRequest</span></h2>
44 <p>TpChannelRequest — proxy object for a request to the Telepathy channel
45 dispatcher</p>
46 </td>
47 <td valign="top" align="right"></td>
48 </tr></table></div>
49 <div class="refsynopsisdiv" title="Synopsis">
50 <a name="telepathy-glib-channel-request.synopsis"></a><h2>Synopsis</h2>
51 <a name="TpChannelRequest"></a><pre class="synopsis">
52
53 #include &lt;telepathy-glib/channel-request.h&gt;
54
55 <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest-struct" title="TpChannelRequest">TpChannelRequest</a>;
56 <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequestClass" title="TpChannelRequestClass">TpChannelRequestClass</a>;
57 <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> * <a class="link" href="telepathy-glib-channel-request.html#tp-channel-request-new" title="tp_channel_request_new ()">tp_channel_request_new</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
58 const <a
59 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
60 >gchar</a> *object_path,
61 <a
62 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
63 >GHashTable</a> *immutable_properties,
64 <a
65 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
66 >GError</a> **error);
67 void <a class="link" href="telepathy-glib-channel-request.html#tp-channel-request-init-known-interfaces" title="tp_channel_request_init_known_interfaces ()">tp_channel_request_init_known_interfaces</a>
68 (void);
69
70 void (<a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel" title="tp_cli_channel_request_callback_for_cancel ()">*tp_cli_channel_request_callback_for_cancel</a>)
71 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
72 const <a
73 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
74 >GError</a> *error,
75 <a
76 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
77 >gpointer</a> user_data,
78 <a
79 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
80 >GObject</a> *weak_object);
81 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-call-cancel" title="tp_cli_channel_request_call_cancel ()">tp_cli_channel_request_call_cancel</a> (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
82 <a
83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
84 >gint</a> timeout_ms,
85 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel" title="tp_cli_channel_request_callback_for_cancel ()">tp_cli_channel_request_callback_for_cancel</a> callback,
86 <a
87 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
88 >gpointer</a> user_data,
89 <a
90 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
91 >GDestroyNotify</a> destroy,
92 <a
93 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
94 >GObject</a> *weak_object);
95 void (<a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed" title="tp_cli_channel_request_callback_for_proceed ()">*tp_cli_channel_request_callback_for_proceed</a>)
96 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
97 const <a
98 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
99 >GError</a> *error,
100 <a
101 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
102 >gpointer</a> user_data,
103 <a
104 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
105 >GObject</a> *weak_object);
106 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-call-proceed" title="tp_cli_channel_request_call_proceed ()">tp_cli_channel_request_call_proceed</a>
107 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
108 <a
109 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
110 >gint</a> timeout_ms,
111 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed" title="tp_cli_channel_request_callback_for_proceed ()">tp_cli_channel_request_callback_for_proceed</a> callback,
112 <a
113 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
114 >gpointer</a> user_data,
115 <a
116 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
117 >GDestroyNotify</a> destroy,
118 <a
119 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
120 >GObject</a> *weak_object);
121 void (<a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed" title="tp_cli_channel_request_signal_callback_failed ()">*tp_cli_channel_request_signal_callback_failed</a>)
122 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
123 const <a
124 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
125 >gchar</a> *arg_Error,
126 const <a
127 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
128 >gchar</a> *arg_Message,
129 <a
130 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
131 >gpointer</a> user_data,
132 <a
133 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
134 >GObject</a> *weak_object);
135 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-failed" title="tp_cli_channel_request_connect_to_failed ()">tp_cli_channel_request_connect_to_failed</a>
136 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
137 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed" title="tp_cli_channel_request_signal_callback_failed ()">tp_cli_channel_request_signal_callback_failed</a> callback,
138 <a
139 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
140 >gpointer</a> user_data,
141 <a
142 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
143 >GDestroyNotify</a> destroy,
144 <a
145 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
146 >GObject</a> *weak_object,
147 <a
148 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
149 >GError</a> **error);
150 void (<a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded" title="tp_cli_channel_request_signal_callback_succeeded ()">*tp_cli_channel_request_signal_callback_succeeded</a>)
151 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
152 <a
153 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
154 >gpointer</a> user_data,
155 <a
156 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
157 >GObject</a> *weak_object);
158 <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-succeeded" title="tp_cli_channel_request_connect_to_succeeded ()">tp_cli_channel_request_connect_to_succeeded</a>
159 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
160 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded" title="tp_cli_channel_request_signal_callback_succeeded ()">tp_cli_channel_request_signal_callback_succeeded</a> callback,
161 <a
162 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
163 >gpointer</a> user_data,
164 <a
165 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
166 >GDestroyNotify</a> destroy,
167 <a
168 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
169 >GObject</a> *weak_object,
170 <a
171 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
172 >GError</a> **error);
173 </pre>
174 </div>
175 <div class="refsect1" title="Object Hierarchy">
176 <a name="telepathy-glib-channel-request.object-hierarchy"></a><h2>Object Hierarchy</h2>
177 <pre class="synopsis">
178 <a
179 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
180 >GObject</a>
181 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
182 +----TpChannelRequest
183 </pre>
184 </div>
185 <div class="refsect1" title="Signals">
186 <a name="telepathy-glib-channel-request.signals"></a><h2>Signals</h2>
187 <pre class="synopsis">
188 "<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest-succeeded" title='The "succeeded" signal'>succeeded</a>" : Run Last / Has Details
189 </pre>
190 </div>
191 <div class="refsect1" title="Description">
192 <a name="telepathy-glib-channel-request.description"></a><h2>Description</h2>
193 <p>
194 Requesting a channel from the channel dispatcher can take some time, so an
195 object is created in the channel dispatcher to represent each request.
196 Objects of the <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> class provide access to one of those
197 objects.</p>
198 <p>
199 </p>
200 </div>
201 <div class="refsect1" title="Details">
202 <a name="telepathy-glib-channel-request.details"></a><h2>Details</h2>
203 <div class="refsect2" title="TpChannelRequest">
204 <a name="TpChannelRequest-struct"></a><h3>TpChannelRequest</h3>
205 <pre class="programlisting">typedef struct _TpChannelRequest TpChannelRequest;</pre>
206 <p>
207 Requesting a channel from the channel dispatcher can take some time, so an
208 object is created in the channel dispatcher to represent each request. This
209 proxy represents one of those objects.
210 </p>
211 <p>
212 Any client can call <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-call-cancel" title="tp_cli_channel_request_call_cancel ()"><code class="function">tp_cli_channel_request_call_cancel()</code></a> at any time to
213 attempt to cancel the request.
214 </p>
215 <p>
216 On success, the <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest-succeeded" title='The "succeeded" signal'><span class="type">"succeeded"</span></a> signal will be emitted.
217 Immediately after that, the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal will be emitted,
218 with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
219 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a> (this is not an error condition, it merely
220 indicates that the channel request no longer exists).
221 </p>
222 <p>
223 On failure, the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal will be emitted with some
224 other suitable error, usually from the <a class="link" href="telepathy-glib-errors.html#TP-ERRORS--CAPS" title="TP_ERRORS"><code class="literal">TP_ERRORS</code></a> domain.
225 </p>
226 <p>
227 If the channel dispatcher crashes or exits, the <a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a>
228 signal will be emitted with the domain <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERRORS--CAPS" title="TP_DBUS_ERRORS"><code class="literal">TP_DBUS_ERRORS</code></a> and the error code
229 <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-NAME-OWNER-LOST--CAPS"><code class="literal">TP_DBUS_ERROR_NAME_OWNER_LOST</code></a>.
230 </p>
231 <p>
232 This proxy is usable but incomplete: accessors for the Account,
233 UserActionTime, PreferredHandler, Requests and Interfaces properties will
234 be added in a later version of telepathy-glib, along with a mechanism
235 similar 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>.
236 </p>
237 <p>
238 Until suitable convenience methods are implemented, the generic
239 <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-get-all" title="tp_cli_dbus_properties_call_get_all ()"><code class="function">tp_cli_dbus_properties_call_get_all()</code></a> method can be used to get those
240 properties.</p>
241 <p>
242 </p>
243 <p class="since">Since 0.7.UNRELEASED</p>
244 </div>
245 <hr>
246 <div class="refsect2" title="TpChannelRequestClass">
247 <a name="TpChannelRequestClass"></a><h3>TpChannelRequestClass</h3>
248 <pre class="programlisting">typedef struct {
249 } TpChannelRequestClass;
250 </pre>
251 <p>
252 The class of a <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a>.</p>
253 <p>
254 </p>
255 </div>
256 <hr>
257 <div class="refsect2" title="tp_channel_request_new ()">
258 <a name="tp-channel-request-new"></a><h3>tp_channel_request_new ()</h3>
259 <pre class="programlisting"><a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> * tp_channel_request_new (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *bus_daemon,
260 const <a
261 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
262 >gchar</a> *object_path,
263 <a
264 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
265 >GHashTable</a> *immutable_properties,
266 <a
267 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
268 >GError</a> **error);</pre>
269 <p>
270 Convenience function to create a new channel request proxy.
271 </p>
272 <p>
273 If the channel request was newly created, the client making the request
274 is responsible for calling <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-call-proceed" title="tp_cli_channel_request_call_proceed ()"><code class="function">tp_cli_channel_request_call_proceed()</code></a> when it
275 is ready for the channel request to proceed.
276 </p>
277 <p>
278 The <em class="parameter"><code>immutable_properties</code></em> argument is not yet used.</p>
279 <p>
280 </p>
281 <div class="variablelist"><table border="0">
282 <col align="left" valign="top">
283 <tbody>
284 <tr>
285 <td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
286 <td> Proxy for the D-Bus daemon
287 </td>
288 </tr>
289 <tr>
290 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
291 <td> The non-NULL object path of this channel request
292 </td>
293 </tr>
294 <tr>
295 <td><p><span class="term"><em class="parameter"><code>immutable_properties</code></em> :</span></p></td>
296 <td> As many as are known of the immutable D-Bus
297 properties of this channel request, or <a
298 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
299 ><code class="literal">NULL</code></a> if none are known
300 </td>
301 </tr>
302 <tr>
303 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
304 <td> Used to raise an error if <a
305 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
306 ><code class="literal">NULL</code></a> is returned
307 </td>
308 </tr>
309 <tr>
310 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
311 <td> a new reference to an channel request proxy, or <a
312 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
313 ><code class="literal">NULL</code></a> if
314 <em class="parameter"><code>object_path</code></em> is not syntactically valid or the channel dispatcher is
315 not running
316 </td>
317 </tr>
318 </tbody>
319 </table></div>
320 </div>
321 <hr>
322 <div class="refsect2" title="tp_channel_request_init_known_interfaces ()">
323 <a name="tp-channel-request-init-known-interfaces"></a><h3>tp_channel_request_init_known_interfaces ()</h3>
324 <pre class="programlisting">void tp_channel_request_init_known_interfaces
325 (void);</pre>
326 <p>
327 Ensure that the known interfaces for TpChannelRequest have been set up.
328 This is done automatically when necessary, but for correct
329 overriding of library interfaces by local extensions, you should
330 call this function before calling
331 <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
332 <code class="literal">TP_TYPE_CHANNEL_REQUEST</code>.</p>
333 <p>
334 </p>
335 <p class="since">Since 0.7.UNRELEASED</p>
336 </div>
337 <hr>
338 <div class="refsect2" title="tp_cli_channel_request_callback_for_cancel ()">
339 <a name="tp-cli-channel-request-callback-for-cancel"></a><h3>tp_cli_channel_request_callback_for_cancel ()</h3>
340 <pre class="programlisting">void (*tp_cli_channel_request_callback_for_cancel)
341 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
342 const <a
343 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
344 >GError</a> *error,
345 <a
346 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
347 >gpointer</a> user_data,
348 <a
349 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
350 >GObject</a> *weak_object);</pre>
351 <p>
352 Signature of the callback called when a Cancel method call
353 succeeds or fails.</p>
354 <p>
355 </p>
356 <div class="variablelist"><table border="0">
357 <col align="left" valign="top">
358 <tbody>
359 <tr>
360 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
361 <td> the proxy on which the call was made
362 </td>
363 </tr>
364 <tr>
365 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
366 <td> <a
367 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
368 ><code class="literal">NULL</code></a> on success, or an error on failure
369 </td>
370 </tr>
371 <tr>
372 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
373 <td> user-supplied data
374 </td>
375 </tr>
376 <tr>
377 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
378 <td> user-supplied object
379 </td>
380 </tr>
381 </tbody>
382 </table></div>
383 </div>
384 <hr>
385 <div class="refsect2" title="tp_cli_channel_request_call_cancel ()">
386 <a name="tp-cli-channel-request-call-cancel"></a><h3>tp_cli_channel_request_call_cancel ()</h3>
387 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_request_call_cancel (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
388 <a
389 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
390 >gint</a> timeout_ms,
391 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel" title="tp_cli_channel_request_callback_for_cancel ()">tp_cli_channel_request_callback_for_cancel</a> callback,
392 <a
393 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
394 >gpointer</a> user_data,
395 <a
396 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
397 >GDestroyNotify</a> destroy,
398 <a
399 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
400 >GObject</a> *weak_object);</pre>
401 <p>
402 Start a Cancel method call.
403 </p>
404 <p>
405 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Cancel the channel request. The precise effect depends on the current progress of the request.&lt;/p&gt; &lt;p&gt;If the connection manager has not already been asked to create a channel, then &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; is emitted immediately, and the channel request is removed.&lt;/p&gt; &lt;p&gt;If the connection manager has already been asked to create a channel but has not produced one yet (e.g. if &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection.Interface.Requests.CreateChannel&lt;/tp:dbus-ref&gt; has been called, but has not yet returned), then the ChannelDispatcher will remember that the request has been cancelled. When the channel appears, it will be closed (if it was newly created and can be closed), and will not be dispatched to a handler.&lt;/p&gt; &lt;p&gt;If the connection manager has already returned a channel, but the channel has not yet been dispatched to a handler then the channel dispatcher will not dispatch that channel to a handler. If the channel was newly created for this request, the channel dispatcher will close it with &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;Close&lt;/tp:dbus-ref&gt;; otherwise, the channel dispatcher will ignore it. In either case, &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; will be emitted when processing has been completed.&lt;/p&gt; &lt;p&gt;If &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; is emitted in response to this method, the error SHOULD be &lt;code&gt;org.freedesktop.Telepathy.Error.Cancelled&lt;/code&gt;.&lt;/p&gt; &lt;p&gt;If the channel has already been dispatched to a handler, then it's too late to call this method, and the channel request will no longer exist.&lt;/p&gt;</p>
406 <p>
407 </p>
408 <div class="variablelist"><table border="0">
409 <col align="left" valign="top">
410 <tbody>
411 <tr>
412 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
413 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
414 </td>
415 </tr>
416 <tr>
417 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
418 <td> the timeout in milliseconds, or -1 to use the
419 default
420 </td>
421 </tr>
422 <tr>
423 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
424 <td> called when the method call succeeds or fails;
425 may be <a
426 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
427 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
428 reply tracking
429 </td>
430 </tr>
431 <tr>
432 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
433 <td> user-supplied data passed to the callback;
434 must be <a
435 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
436 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
437 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
438 ><code class="literal">NULL</code></a>
439 </td>
440 </tr>
441 <tr>
442 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
443 <td> called with the user_data as argument, after the
444 call has succeeded, failed or been cancelled;
445 must be <a
446 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
447 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
448 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
449 ><code class="literal">NULL</code></a>
450 </td>
451 </tr>
452 <tr>
453 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
454 <td> If not <a
455 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
456 ><code class="literal">NULL</code></a>, a <a
457 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
458 ><span class="type">GObject</span></a> which will be
459 weakly referenced; if it is destroyed, this call
460 will automatically be cancelled. Must be <a
461 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
462 ><code class="literal">NULL</code></a> if
463 <em class="parameter"><code>callback</code></em> is <a
464 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
465 ><code class="literal">NULL</code></a>
466 </td>
467 </tr>
468 <tr>
469 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
470 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
471 progress. It is borrowed from the object, and will become
472 invalid when the callback is called, the call is
473 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
474 </td>
475 </tr>
476 </tbody>
477 </table></div>
478 </div>
479 <hr>
480 <div class="refsect2" title="tp_cli_channel_request_callback_for_proceed ()">
481 <a name="tp-cli-channel-request-callback-for-proceed"></a><h3>tp_cli_channel_request_callback_for_proceed ()</h3>
482 <pre class="programlisting">void (*tp_cli_channel_request_callback_for_proceed)
483 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
484 const <a
485 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
486 >GError</a> *error,
487 <a
488 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
489 >gpointer</a> user_data,
490 <a
491 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
492 >GObject</a> *weak_object);</pre>
493 <p>
494 Signature of the callback called when a Proceed method call
495 succeeds or fails.</p>
496 <p>
497 </p>
498 <div class="variablelist"><table border="0">
499 <col align="left" valign="top">
500 <tbody>
501 <tr>
502 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
503 <td> the proxy on which the call was made
504 </td>
505 </tr>
506 <tr>
507 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
508 <td> <a
509 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
510 ><code class="literal">NULL</code></a> on success, or an error on failure
511 </td>
512 </tr>
513 <tr>
514 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
515 <td> user-supplied data
516 </td>
517 </tr>
518 <tr>
519 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
520 <td> user-supplied object
521 </td>
522 </tr>
523 </tbody>
524 </table></div>
525 </div>
526 <hr>
527 <div class="refsect2" title="tp_cli_channel_request_call_proceed ()">
528 <a name="tp-cli-channel-request-call-proceed"></a><h3>tp_cli_channel_request_call_proceed ()</h3>
529 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_channel_request_call_proceed
530 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
531 <a
532 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
533 >gint</a> timeout_ms,
534 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed" title="tp_cli_channel_request_callback_for_proceed ()">tp_cli_channel_request_callback_for_proceed</a> callback,
535 <a
536 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
537 >gpointer</a> user_data,
538 <a
539 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
540 >GDestroyNotify</a> destroy,
541 <a
542 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
543 >GObject</a> *weak_object);</pre>
544 <p>
545 Start a Proceed method call.
546 </p>
547 <p>
548 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Proceed with the channel request.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The client that created this object calls this method when it has connected signal handlers for &lt;tp:member-ref&gt;Succeeded&lt;/tp:member-ref&gt; and &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Clients other than the client which created the ChannelRequest MUST NOT call this method.&lt;/p&gt; &lt;p&gt;This method SHOULD return immediately; on success, the request might still fail, but this will be indicated asynchronously by the &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; signal.&lt;/p&gt; &lt;p&gt;Proceed cannot fail, unless clients have got the life-cycle of a ChannelRequest seriously wrong (e.g. a client calls this method twice, or a client that did not create the ChannelRequest calls this method). If it fails, clients SHOULD assume that the whole ChannelRequest has become useless.&lt;/p&gt;</p>
549 <p>
550 </p>
551 <div class="variablelist"><table border="0">
552 <col align="left" valign="top">
553 <tbody>
554 <tr>
555 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
556 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
557 </td>
558 </tr>
559 <tr>
560 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
561 <td> the timeout in milliseconds, or -1 to use the
562 default
563 </td>
564 </tr>
565 <tr>
566 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
567 <td> called when the method call succeeds or fails;
568 may be <a
569 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
570 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
571 reply tracking
572 </td>
573 </tr>
574 <tr>
575 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
576 <td> user-supplied data passed to the callback;
577 must be <a
578 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
579 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
580 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
581 ><code class="literal">NULL</code></a>
582 </td>
583 </tr>
584 <tr>
585 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
586 <td> called with the user_data as argument, after the
587 call has succeeded, failed or been cancelled;
588 must be <a
589 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
590 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
591 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
592 ><code class="literal">NULL</code></a>
593 </td>
594 </tr>
595 <tr>
596 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
597 <td> If not <a
598 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
599 ><code class="literal">NULL</code></a>, a <a
600 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
601 ><span class="type">GObject</span></a> which will be
602 weakly referenced; if it is destroyed, this call
603 will automatically be cancelled. Must be <a
604 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
605 ><code class="literal">NULL</code></a> if
606 <em class="parameter"><code>callback</code></em> is <a
607 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
608 ><code class="literal">NULL</code></a>
609 </td>
610 </tr>
611 <tr>
612 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
613 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
614 progress. It is borrowed from the object, and will become
615 invalid when the callback is called, the call is
616 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
617 </td>
618 </tr>
619 </tbody>
620 </table></div>
621 </div>
622 <hr>
623 <div class="refsect2" title="tp_cli_channel_request_signal_callback_failed ()">
624 <a name="tp-cli-channel-request-signal-callback-failed"></a><h3>tp_cli_channel_request_signal_callback_failed ()</h3>
625 <pre class="programlisting">void (*tp_cli_channel_request_signal_callback_failed)
626 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
627 const <a
628 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
629 >gchar</a> *arg_Error,
630 const <a
631 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
632 >gchar</a> *arg_Message,
633 <a
634 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
635 >gpointer</a> user_data,
636 <a
637 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
638 >GObject</a> *weak_object);</pre>
639 <p>
640 Represents the signature of a callback for the signal Failed.</p>
641 <p>
642 </p>
643 <div class="variablelist"><table border="0">
644 <col align="left" valign="top">
645 <tbody>
646 <tr>
647 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
648 <td> The proxy on which <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-failed" title="tp_cli_channel_request_connect_to_failed ()"><code class="function">tp_cli_channel_request_connect_to_failed()</code></a>
649 was called
650 </td>
651 </tr>
652 <tr>
653 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
654 <td> &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The name of a D-Bus error. This can come from various sources, including the error raised by &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Requests"&gt;CreateChannel&lt;/tp:dbus-ref&gt;, or an error generated to represent failure to establish the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection&lt;/tp:dbus-ref&gt;.&lt;/p&gt;
655 </td>
656 </tr>
657 <tr>
658 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
659 <td> If the first argument of the D-Bus error message was a string, that string. Otherwise, an empty string.
660 </td>
661 </tr>
662 <tr>
663 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
664 <td> User-supplied data
665 </td>
666 </tr>
667 <tr>
668 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
669 <td> User-supplied weakly referenced object
670 </td>
671 </tr>
672 </tbody>
673 </table></div>
674 </div>
675 <hr>
676 <div class="refsect2" title="tp_cli_channel_request_connect_to_failed ()">
677 <a name="tp-cli-channel-request-connect-to-failed"></a><h3>tp_cli_channel_request_connect_to_failed ()</h3>
678 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_request_connect_to_failed
679 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
680 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed" title="tp_cli_channel_request_signal_callback_failed ()">tp_cli_channel_request_signal_callback_failed</a> callback,
681 <a
682 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
683 >gpointer</a> user_data,
684 <a
685 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
686 >GDestroyNotify</a> destroy,
687 <a
688 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
689 >GObject</a> *weak_object,
690 <a
691 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
692 >GError</a> **error);</pre>
693 <p>
694 Connect a handler to the signal Failed.
695 </p>
696 <p>
697 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The channel request has failed. It is no longer present, and further methods must not be called on it.&lt;/p&gt;</p>
698 <p>
699 </p>
700 <div class="variablelist"><table border="0">
701 <col align="left" valign="top">
702 <tbody>
703 <tr>
704 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
705 <td> A <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> or subclass
706 </td>
707 </tr>
708 <tr>
709 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
710 <td> Callback to be called when the signal is
711 received
712 </td>
713 </tr>
714 <tr>
715 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
716 <td> User-supplied data for the callback
717 </td>
718 </tr>
719 <tr>
720 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
721 <td> Destructor for the user-supplied data, which
722 will be called when this signal is disconnected, or
723 before this function returns <a
724 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
725 ><code class="literal">NULL</code></a>
726 </td>
727 </tr>
728 <tr>
729 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
730 <td> A <a
731 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
732 ><span class="type">GObject</span></a> which will be weakly referenced;
733 if it is destroyed, this callback will automatically be
734 disconnected
735 </td>
736 </tr>
737 <tr>
738 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
739 <td> If not <a
740 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
741 ><code class="literal">NULL</code></a>, used to raise an error if <a
742 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
743 ><code class="literal">NULL</code></a> is
744 returned
745 </td>
746 </tr>
747 <tr>
748 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
749 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
750 above, which can be used to disconnect the signal; or
751 <a
752 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
753 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
754 or has become invalid.
755 </td>
756 </tr>
757 </tbody>
758 </table></div>
759 </div>
760 <hr>
761 <div class="refsect2" title="tp_cli_channel_request_signal_callback_succeeded ()">
762 <a name="tp-cli-channel-request-signal-callback-succeeded"></a><h3>tp_cli_channel_request_signal_callback_succeeded ()</h3>
763 <pre class="programlisting">void (*tp_cli_channel_request_signal_callback_succeeded)
764 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
765 <a
766 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
767 >gpointer</a> user_data,
768 <a
769 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
770 >GObject</a> *weak_object);</pre>
771 <p>
772 Represents the signature of a callback for the signal Succeeded.</p>
773 <p>
774 </p>
775 <div class="variablelist"><table border="0">
776 <col align="left" valign="top">
777 <tbody>
778 <tr>
779 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
780 <td> The proxy on which <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-succeeded" title="tp_cli_channel_request_connect_to_succeeded ()"><code class="function">tp_cli_channel_request_connect_to_succeeded()</code></a>
781 was called
782 </td>
783 </tr>
784 <tr>
785 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
786 <td> User-supplied data
787 </td>
788 </tr>
789 <tr>
790 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
791 <td> User-supplied weakly referenced object
792 </td>
793 </tr>
794 </tbody>
795 </table></div>
796 </div>
797 <hr>
798 <div class="refsect2" title="tp_cli_channel_request_connect_to_succeeded ()">
799 <a name="tp-cli-channel-request-connect-to-succeeded"></a><h3>tp_cli_channel_request_connect_to_succeeded ()</h3>
800 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection">TpProxySignalConnection</a> * tp_cli_channel_request_connect_to_succeeded
801 (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *proxy,
802 <a class="link" href="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded" title="tp_cli_channel_request_signal_callback_succeeded ()">tp_cli_channel_request_signal_callback_succeeded</a> callback,
803 <a
804 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
805 >gpointer</a> user_data,
806 <a
807 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
808 >GDestroyNotify</a> destroy,
809 <a
810 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
811 >GObject</a> *weak_object,
812 <a
813 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
814 >GError</a> **error);</pre>
815 <p>
816 Connect a handler to the signal Succeeded.
817 </p>
818 <p>
819 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The channel request has succeeded. It is no longer present, and further methods must not be called on it.&lt;/p&gt;</p>
820 <p>
821 </p>
822 <div class="variablelist"><table border="0">
823 <col align="left" valign="top">
824 <tbody>
825 <tr>
826 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
827 <td> A <a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest"><span class="type">TpChannelRequest</span></a> or subclass
828 </td>
829 </tr>
830 <tr>
831 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
832 <td> Callback to be called when the signal is
833 received
834 </td>
835 </tr>
836 <tr>
837 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
838 <td> User-supplied data for the callback
839 </td>
840 </tr>
841 <tr>
842 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
843 <td> Destructor for the user-supplied data, which
844 will be called when this signal is disconnected, or
845 before this function returns <a
846 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
847 ><code class="literal">NULL</code></a>
848 </td>
849 </tr>
850 <tr>
851 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
852 <td> A <a
853 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
854 ><span class="type">GObject</span></a> which will be weakly referenced;
855 if it is destroyed, this callback will automatically be
856 disconnected
857 </td>
858 </tr>
859 <tr>
860 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
861 <td> If not <a
862 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
863 ><code class="literal">NULL</code></a>, used to raise an error if <a
864 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
865 ><code class="literal">NULL</code></a> is
866 returned
867 </td>
868 </tr>
869 <tr>
870 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
871 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
872 above, which can be used to disconnect the signal; or
873 <a
874 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
875 ><code class="literal">NULL</code></a> if the proxy does not have the desired interface
876 or has become invalid.
877 </td>
878 </tr>
879 </tbody>
880 </table></div>
881 </div>
882 </div>
883 <div class="refsect1" title="Signal Details">
884 <a name="telepathy-glib-channel-request.signal-details"></a><h2>Signal Details</h2>
885 <div class="refsect2" title='The "succeeded" signal'>
886 <a name="TpChannelRequest-succeeded"></a><h3>The <code class="literal">"succeeded"</code> signal</h3>
887 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a> *self,
888 <a
889 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
890 >gpointer</a> user_data) : Run Last / Has Details</pre>
891 <p>
892 Emitted when the channel request succeeds.</p>
893 <p>
894 </p>
895 <div class="variablelist"><table border="0">
896 <col align="left" valign="top">
897 <tbody>
898 <tr>
899 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
900 <td> the channel request proxy
901 </td>
902 </tr>
903 <tr>
904 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
905 <td>user data set when the signal handler was connected.</td>
906 </tr>
907 </tbody>
908 </table></div>
909 </div>
910 </div>
911 <div class="refsect1" title="See Also">
912 <a name="telepathy-glib-channel-request.see-also"></a><h2>See Also</h2>
913 #TpChannelDispatcher
914 </div>
915 </div>
916 <div class="footer">
917 <hr>
918 Generated by GTK-Doc V1.11</div>
919 </body>
920 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Room List channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-tube.html" title="Tube channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Text channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-group.html" title="Group interface on Channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Tube channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-tubes.html" title="Tubes channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Tubes channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-file-transfer.html" title="File transfer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpChannel</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-presence.html" title="Connection Presence interface">
795795 <p>
796796 Returns the connection for this channel. The returned pointer is only valid
797797 while this channel is valid - reference it with <a
798 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
798 href="../libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
799799 ><code class="function">g_object_ref()</code></a> if needed.</p>
800800 <p>
801801 </p>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>TpClient</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-client.html" title="Client-side proxies">
8 <link rel="prev" href="telepathy-glib-channel-request.html" title="TpChannelRequest">
9 <link rel="next" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-channel-request.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="ch-service-dbus.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-client.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-client.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-client.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="TpClient">
38 <a name="telepathy-glib-client"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-client.top_of_page"></a>TpClient</span></h2>
42 <p>TpClient — proxy object for a client of the ChannelDispatcher</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv" title="Synopsis">
47 <a name="telepathy-glib-client.synopsis"></a><h2>Synopsis</h2>
48 <a name="TpClient"></a><pre class="synopsis">
49
50 #include &lt;telepathy-glib/client.h&gt;
51
52 <a class="link" href="telepathy-glib-client.html#TpClient-struct" title="TpClient">TpClient</a>;
53 <a class="link" href="telepathy-glib-client.html#TpClientClass" title="TpClientClass">TpClientClass</a>;
54 void <a class="link" href="telepathy-glib-client.html#tp-client-init-known-interfaces" title="tp_client_init_known_interfaces ()">tp_client_init_known_interfaces</a> (void);
55
56 void (<a class="link" href="telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels" title="tp_cli_client_observer_callback_for_observe_channels ()">*tp_cli_client_observer_callback_for_observe_channels</a>)
57 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
58 const <a
59 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
60 >GError</a> *error,
61 <a
62 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
63 >gpointer</a> user_data,
64 <a
65 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
66 >GObject</a> *weak_object);
67 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-client.html#tp-cli-client-observer-call-observe-channels" title="tp_cli_client_observer_call_observe_channels ()">tp_cli_client_observer_call_observe_channels</a>
68 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
69 <a
70 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
71 >gint</a> timeout_ms,
72 const <a
73 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
74 >gchar</a> *in_Account,
75 const <a
76 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
77 >gchar</a> *in_Connection,
78 const <a
79 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
80 >GPtrArray</a> *in_Channels,
81 const <a
82 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
83 >gchar</a> *in_Dispatch_Operation,
84 const <a
85 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
86 >GPtrArray</a> *in_Requests_Satisfied,
87 <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
89 >GHashTable</a> *in_Observer_Info,
90 <a class="link" href="telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels" title="tp_cli_client_observer_callback_for_observe_channels ()">tp_cli_client_observer_callback_for_observe_channels</a> callback,
91 <a
92 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
93 >gpointer</a> user_data,
94 <a
95 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
96 >GDestroyNotify</a> destroy,
97 <a
98 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
99 >GObject</a> *weak_object);
100
101 void (<a class="link" href="telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels" title="tp_cli_client_handler_callback_for_handle_channels ()">*tp_cli_client_handler_callback_for_handle_channels</a>)
102 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
103 const <a
104 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
105 >GError</a> *error,
106 <a
107 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
108 >gpointer</a> user_data,
109 <a
110 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
111 >GObject</a> *weak_object);
112 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-client.html#tp-cli-client-handler-call-handle-channels" title="tp_cli_client_handler_call_handle_channels ()">tp_cli_client_handler_call_handle_channels</a>
113 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
114 <a
115 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
116 >gint</a> timeout_ms,
117 const <a
118 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
119 >gchar</a> *in_Account,
120 const <a
121 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
122 >gchar</a> *in_Connection,
123 const <a
124 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
125 >GPtrArray</a> *in_Channels,
126 const <a
127 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
128 >GPtrArray</a> *in_Requests_Satisfied,
129 <a
130 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"
131 >guint64</a> in_User_Action_Time,
132 <a
133 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
134 >GHashTable</a> *in_Handler_Info,
135 <a class="link" href="telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels" title="tp_cli_client_handler_callback_for_handle_channels ()">tp_cli_client_handler_callback_for_handle_channels</a> callback,
136 <a
137 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
138 >gpointer</a> user_data,
139 <a
140 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
141 >GDestroyNotify</a> destroy,
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-client.html#tp-cli-client-interface-requests-callback-for-add-request" title="tp_cli_client_interface_requests_callback_for_add_request ()">*tp_cli_client_interface_requests_callback_for_add_request</a>)
146 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
147 const <a
148 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
149 >GError</a> *error,
150 <a
151 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
152 >gpointer</a> user_data,
153 <a
154 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
155 >GObject</a> *weak_object);
156 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-call-add-request" title="tp_cli_client_interface_requests_call_add_request ()">tp_cli_client_interface_requests_call_add_request</a>
157 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
158 <a
159 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
160 >gint</a> timeout_ms,
161 const <a
162 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
163 >gchar</a> *in_Request,
164 <a
165 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
166 >GHashTable</a> *in_Properties,
167 <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-add-request" title="tp_cli_client_interface_requests_callback_for_add_request ()">tp_cli_client_interface_requests_callback_for_add_request</a> callback,
168 <a
169 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
170 >gpointer</a> user_data,
171 <a
172 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
173 >GDestroyNotify</a> destroy,
174 <a
175 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
176 >GObject</a> *weak_object);
177 void (<a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request" title="tp_cli_client_interface_requests_callback_for_remove_request ()">*tp_cli_client_interface_requests_callback_for_remove_request</a>)
178 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
179 const <a
180 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
181 >GError</a> *error,
182 <a
183 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
184 >gpointer</a> user_data,
185 <a
186 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
187 >GObject</a> *weak_object);
188 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-call-remove-request" title="tp_cli_client_interface_requests_call_remove_request ()">tp_cli_client_interface_requests_call_remove_request</a>
189 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
190 <a
191 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
192 >gint</a> timeout_ms,
193 const <a
194 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
195 >gchar</a> *in_Request,
196 const <a
197 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
198 >gchar</a> *in_Error,
199 const <a
200 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
201 >gchar</a> *in_Message,
202 <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request" title="tp_cli_client_interface_requests_callback_for_remove_request ()">tp_cli_client_interface_requests_callback_for_remove_request</a> callback,
203 <a
204 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
205 >gpointer</a> user_data,
206 <a
207 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
208 >GDestroyNotify</a> destroy,
209 <a
210 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
211 >GObject</a> *weak_object);
212
213 void (<a class="link" href="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation" title="tp_cli_client_approver_callback_for_add_dispatch_operation ()">*tp_cli_client_approver_callback_for_add_dispatch_operation</a>)
214 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
215 const <a
216 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
217 >GError</a> *error,
218 <a
219 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
220 >gpointer</a> user_data,
221 <a
222 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
223 >GObject</a> *weak_object);
224 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-client.html#tp-cli-client-approver-call-add-dispatch-operation" title="tp_cli_client_approver_call_add_dispatch_operation ()">tp_cli_client_approver_call_add_dispatch_operation</a>
225 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
226 <a
227 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
228 >gint</a> timeout_ms,
229 const <a
230 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
231 >GPtrArray</a> *in_Channels,
232 const <a
233 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
234 >gchar</a> *in_DispatchOperation,
235 <a
236 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
237 >GHashTable</a> *in_Properties,
238 <a class="link" href="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation" title="tp_cli_client_approver_callback_for_add_dispatch_operation ()">tp_cli_client_approver_callback_for_add_dispatch_operation</a> callback,
239 <a
240 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
241 >gpointer</a> user_data,
242 <a
243 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
244 >GDestroyNotify</a> destroy,
245 <a
246 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
247 >GObject</a> *weak_object);
248 </pre>
249 </div>
250 <div class="refsect1" title="Object Hierarchy">
251 <a name="telepathy-glib-client.object-hierarchy"></a><h2>Object Hierarchy</h2>
252 <pre class="synopsis">
253 <a
254 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
255 >GObject</a>
256 +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
257 +----TpClient
258 </pre>
259 </div>
260 <div class="refsect1" title="Description">
261 <a name="telepathy-glib-client.description"></a><h2>Description</h2>
262 <p>
263 Each client to which the ChannelDispatcher can send channels must implement
264 the Client interface. This object represents such a client, and is mainly
265 useful in the implementation of the ChannelDispatcher itself.</p>
266 <p>
267 </p>
268 </div>
269 <div class="refsect1" title="Details">
270 <a name="telepathy-glib-client.details"></a><h2>Details</h2>
271 <div class="refsect2" title="TpClient">
272 <a name="TpClient-struct"></a><h3>TpClient</h3>
273 <pre class="programlisting">typedef struct _TpClient TpClient;</pre>
274 <p>
275 Each client to which the ChannelDispatcher can send channels must implement
276 the Client interface. This object represents such a client, and is mainly
277 useful in the implementation of the ChannelDispatcher itself.
278 </p>
279 <p>
280 This proxy is usable but very incomplete: accessors for D-Bus properties
281 will be added in a later version of telepathy-glib, along with a mechanism
282 similar 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>.
283 </p>
284 <p>
285 Many operations performed on a Client are done via D-Bus properties.
286 Until convenience methods for this are implemented, use of the generic
287 <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-get-all" title="tp_cli_dbus_properties_call_get_all ()"><code class="function">tp_cli_dbus_properties_call_get_all()</code></a> and <a class="link" href="telepathy-glib-proxy-dbus-core.html#tp-cli-dbus-properties-call-set" title="tp_cli_dbus_properties_call_set ()"><code class="function">tp_cli_dbus_properties_call_set()</code></a>
288 methods is recommended.</p>
289 <p>
290 </p>
291 <p class="since">Since 0.7.UNRELEASED</p>
292 </div>
293 <hr>
294 <div class="refsect2" title="TpClientClass">
295 <a name="TpClientClass"></a><h3>TpClientClass</h3>
296 <pre class="programlisting">typedef struct {
297 } TpClientClass;
298 </pre>
299 <p>
300 The class of a <a class="link" href="telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a>.</p>
301 <p>
302 </p>
303 </div>
304 <hr>
305 <div class="refsect2" title="tp_client_init_known_interfaces ()">
306 <a name="tp-client-init-known-interfaces"></a><h3>tp_client_init_known_interfaces ()</h3>
307 <pre class="programlisting">void tp_client_init_known_interfaces (void);</pre>
308 <p>
309 Ensure that the known interfaces for TpClient have been set up.
310 This is done automatically when necessary, but for correct
311 overriding of library interfaces by local extensions, you should
312 call this function before calling
313 <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
314 <code class="literal">TP_TYPE_CLIENT</code>.</p>
315 <p>
316 </p>
317 <p class="since">Since 0.7.UNRELEASED</p>
318 </div>
319 <hr>
320 <div class="refsect2" title="tp_cli_client_observer_callback_for_observe_channels ()">
321 <a name="tp-cli-client-observer-callback-for-observe-channels"></a><h3>tp_cli_client_observer_callback_for_observe_channels ()</h3>
322 <pre class="programlisting">void (*tp_cli_client_observer_callback_for_observe_channels)
323 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
324 const <a
325 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
326 >GError</a> *error,
327 <a
328 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
329 >gpointer</a> user_data,
330 <a
331 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
332 >GObject</a> *weak_object);</pre>
333 <p>
334 Signature of the callback called when a ObserveChannels method call
335 succeeds or fails.</p>
336 <p>
337 </p>
338 <div class="variablelist"><table border="0">
339 <col align="left" valign="top">
340 <tbody>
341 <tr>
342 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
343 <td> the proxy on which the call was made
344 </td>
345 </tr>
346 <tr>
347 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
348 <td> <a
349 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
350 ><code class="literal">NULL</code></a> on success, or an error on failure
351 </td>
352 </tr>
353 <tr>
354 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
355 <td> user-supplied data
356 </td>
357 </tr>
358 <tr>
359 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
360 <td> user-supplied object
361 </td>
362 </tr>
363 </tbody>
364 </table></div>
365 </div>
366 <hr>
367 <div class="refsect2" title="tp_cli_client_observer_call_observe_channels ()">
368 <a name="tp-cli-client-observer-call-observe-channels"></a><h3>tp_cli_client_observer_call_observe_channels ()</h3>
369 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_client_observer_call_observe_channels
370 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
371 <a
372 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
373 >gint</a> timeout_ms,
374 const <a
375 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
376 >gchar</a> *in_Account,
377 const <a
378 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
379 >gchar</a> *in_Connection,
380 const <a
381 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
382 >GPtrArray</a> *in_Channels,
383 const <a
384 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
385 >gchar</a> *in_Dispatch_Operation,
386 const <a
387 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
388 >GPtrArray</a> *in_Requests_Satisfied,
389 <a
390 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
391 >GHashTable</a> *in_Observer_Info,
392 <a class="link" href="telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels" title="tp_cli_client_observer_callback_for_observe_channels ()">tp_cli_client_observer_callback_for_observe_channels</a> callback,
393 <a
394 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
395 >gpointer</a> user_data,
396 <a
397 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
398 >GDestroyNotify</a> destroy,
399 <a
400 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
401 >GObject</a> *weak_object);</pre>
402 <p>
403 Start a ObserveChannels method call.
404 </p>
405 <p>
406 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by the channel dispatcher when channels in which the observer has registered an interest are announced in a &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Requests"&gt;NewChannels&lt;/tp:dbus-ref&gt; signal.&lt;/p&gt; &lt;p&gt;If the same NewChannels signal announces some channels that match the filter, and some that do not, then only a subset of the channels (those that do match the filter) are passed to this method.&lt;/p&gt; &lt;p&gt;If the channel dispatcher will split up the channels from a single NewChannels signal and dispatch them separately (for instance because no installed Handler can handle all of them), it will call ObserveChannels several times.&lt;/p&gt; &lt;p&gt;The observer MUST NOT return from this method call until it is ready for a handler for the channel to run (which may change the channel's state).&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The channel dispatcher must wait for observers to start up, to avoid the following race: text channel logger (observer) gets ObserveChannels, text channel handler gets &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt; channel handler starts up faster and acknowledges messages, logger never sees those messages.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The channel dispatcher SHOULD NOT change its behaviour based on whether this method succeeds or fails: there are no defined D-Bus errors for this method, and if it fails, this only indicates that an Observer is somehow broken.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The expected error response in the channel dispatcher is to log a warning, and otherwise continue as though this method had succeeded.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
407 <p>
408 </p>
409 <div class="variablelist"><table border="0">
410 <col align="left" valign="top">
411 <tbody>
412 <tr>
413 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
414 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
415 </td>
416 </tr>
417 <tr>
418 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
419 <td> the timeout in milliseconds, or -1 to use the
420 default
421 </td>
422 </tr>
423 <tr>
424 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
425 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use is that of the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;AccountManager&lt;/tp:dbus-ref&gt;.
426 </td>
427 </tr>
428 <tr>
429 <td><p><span class="term"><em class="parameter"><code>in_Connection</code></em> :</span></p></td>
430 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Connection&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use can be derived from this object path by removing the leading '/' and replacing all subsequent '/' by '.'.
431 </td>
432 </tr>
433 <tr>
434 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
435 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel&lt;/tp:dbus-ref&gt;s and their properties. Their well-known bus names are all the same as that of the Connection.
436 </td>
437 </tr>
438 <tr>
439 <td><p><span class="term"><em class="parameter"><code>in_Dispatch_Operation</code></em> :</span></p></td>
440 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The path to the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt; for these channels, or the special value '/' if there is no ChannelDispatchOperation (because the channels were requested, not incoming).&lt;/p&gt; &lt;p&gt;If the Observer calls &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;Claim&lt;/tp:dbus-ref&gt; or &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;HandleWith&lt;/tp:dbus-ref&gt; on the dispatch operation, it MUST be careful to avoid deadlock, since these methods cannot return until the Observer has returned from &lt;tp:member-ref&gt;ObserveChannels&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This allows an Observer to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;Claim&lt;/tp:dbus-ref&gt; a set of channels without having to match up calls to this method with calls to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Approver"&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt;
441 </td>
442 </tr>
443 <tr>
444 <td><p><span class="term"><em class="parameter"><code>in_Requests_Satisfied</code></em> :</span></p></td>
445 <td> Used to pass an 'in' argument: The requests satisfied by these channels. &lt;tp:rationale&gt; If the same process is an Observer and a Handler, it can be useful to be given this information as soon as possible (it will also be passed to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client"&gt;Handler.HandleChannels&lt;/tp:dbus-ref&gt;). &lt;/tp:rationale&gt;
446 </td>
447 </tr>
448 <tr>
449 <td><p><span class="term"><em class="parameter"><code>in_Observer_Info</code></em> :</span></p></td>
450 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Additional information about these channels. No keys are currently defined.&lt;/p&gt; &lt;p&gt;If keys are defined for this dictionary, all will be optional; observers MAY safely ignore any entry in this dictionary.&lt;/p&gt;
451 </td>
452 </tr>
453 <tr>
454 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
455 <td> called when the method call succeeds or fails;
456 may be <a
457 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
458 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
459 reply tracking
460 </td>
461 </tr>
462 <tr>
463 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
464 <td> user-supplied data passed to the callback;
465 must be <a
466 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
467 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
468 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
469 ><code class="literal">NULL</code></a>
470 </td>
471 </tr>
472 <tr>
473 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
474 <td> called with the user_data as argument, after the
475 call has succeeded, failed or been cancelled;
476 must be <a
477 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
478 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
479 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
480 ><code class="literal">NULL</code></a>
481 </td>
482 </tr>
483 <tr>
484 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
485 <td> If not <a
486 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
487 ><code class="literal">NULL</code></a>, a <a
488 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
489 ><span class="type">GObject</span></a> which will be
490 weakly referenced; if it is destroyed, this call
491 will automatically be cancelled. Must be <a
492 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
493 ><code class="literal">NULL</code></a> if
494 <em class="parameter"><code>callback</code></em> is <a
495 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
496 ><code class="literal">NULL</code></a>
497 </td>
498 </tr>
499 <tr>
500 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
501 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
502 progress. It is borrowed from the object, and will become
503 invalid when the callback is called, the call is
504 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
505 </td>
506 </tr>
507 </tbody>
508 </table></div>
509 </div>
510 <hr>
511 <div class="refsect2" title="tp_cli_client_handler_callback_for_handle_channels ()">
512 <a name="tp-cli-client-handler-callback-for-handle-channels"></a><h3>tp_cli_client_handler_callback_for_handle_channels ()</h3>
513 <pre class="programlisting">void (*tp_cli_client_handler_callback_for_handle_channels)
514 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
515 const <a
516 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
517 >GError</a> *error,
518 <a
519 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
520 >gpointer</a> user_data,
521 <a
522 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
523 >GObject</a> *weak_object);</pre>
524 <p>
525 Signature of the callback called when a HandleChannels method call
526 succeeds or fails.</p>
527 <p>
528 </p>
529 <div class="variablelist"><table border="0">
530 <col align="left" valign="top">
531 <tbody>
532 <tr>
533 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
534 <td> the proxy on which the call was made
535 </td>
536 </tr>
537 <tr>
538 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
539 <td> <a
540 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
541 ><code class="literal">NULL</code></a> on success, or an error on failure
542 </td>
543 </tr>
544 <tr>
545 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
546 <td> user-supplied data
547 </td>
548 </tr>
549 <tr>
550 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
551 <td> user-supplied object
552 </td>
553 </tr>
554 </tbody>
555 </table></div>
556 </div>
557 <hr>
558 <div class="refsect2" title="tp_cli_client_handler_call_handle_channels ()">
559 <a name="tp-cli-client-handler-call-handle-channels"></a><h3>tp_cli_client_handler_call_handle_channels ()</h3>
560 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_client_handler_call_handle_channels
561 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
562 <a
563 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
564 >gint</a> timeout_ms,
565 const <a
566 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
567 >gchar</a> *in_Account,
568 const <a
569 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
570 >gchar</a> *in_Connection,
571 const <a
572 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
573 >GPtrArray</a> *in_Channels,
574 const <a
575 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
576 >GPtrArray</a> *in_Requests_Satisfied,
577 <a
578 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"
579 >guint64</a> in_User_Action_Time,
580 <a
581 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
582 >GHashTable</a> *in_Handler_Info,
583 <a class="link" href="telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels" title="tp_cli_client_handler_callback_for_handle_channels ()">tp_cli_client_handler_callback_for_handle_channels</a> callback,
584 <a
585 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
586 >gpointer</a> user_data,
587 <a
588 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
589 >GDestroyNotify</a> destroy,
590 <a
591 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
592 >GObject</a> *weak_object);</pre>
593 <p>
594 Start a HandleChannels method call.
595 </p>
596 <p>
597 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by the channel dispatcher when this client should handle these channels, or when this client should present channels that it is already handling to the user (e.g. bring them into the foreground).&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Clients are expected to know what channels they're already handling, and which channel object path corresponds to which window or tab. This can easily be done using a hash table keyed by channels' object paths.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This method can raise any D-Bus error. If it does, the handler is assumed to have failed or crashed, and the channel dispatcher MUST recover in an implementation-specific way; it MAY attempt to dispatch the channels to another handler, or close the channels.&lt;/p&gt; &lt;p&gt;If closing the channels, it is RECOMMENDED that the channel dispatcher attempts to close the channels using &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel.Close&lt;/tp:dbus-ref&gt;, but resorts to calling &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel.Interface.Destroyable.Destroy&lt;/tp:dbus-ref&gt; (if available) or ignoring the channel (if not) if the same handler repeatedly fails to handle channels.&lt;/p&gt; &lt;p&gt;After HandleChannels returns successfully, the client process is considered to be responsible for the channel until it its unique name disappears from the bus.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;If a process has multiple Client bus names - some temporary and some long-lived - and drops one of the temporary bus names in order to reduce the set of channels that it will handle, any channels that it is already handling should remain unaffected.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
598 <p>
599 </p>
600 <div class="variablelist"><table border="0">
601 <col align="left" valign="top">
602 <tbody>
603 <tr>
604 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
605 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
606 </td>
607 </tr>
608 <tr>
609 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
610 <td> the timeout in milliseconds, or -1 to use the
611 default
612 </td>
613 </tr>
614 <tr>
615 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
616 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Account&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use is that of the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;AccountManager&lt;/tp:dbus-ref&gt;.
617 </td>
618 </tr>
619 <tr>
620 <td><p><span class="term"><em class="parameter"><code>in_Connection</code></em> :</span></p></td>
621 <td> Used to pass an 'in' argument: The Connection with which the channels are associated. The well-known bus name to use can be derived from this object path by removing the leading '/' and replacing all subsequent '/' by '.'.
622 </td>
623 </tr>
624 <tr>
625 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
626 <td> Used to pass an 'in' argument: The channels and their immutable properties. Their well-known bus name is the same as that of the Connection.
627 </td>
628 </tr>
629 <tr>
630 <td><p><span class="term"><em class="parameter"><code>in_Requests_Satisfied</code></em> :</span></p></td>
631 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The requests satisfied by these channels.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;If the handler implements Requests, this tells it that these channels match previous &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Interface.Requests"&gt;AddRequest&lt;/tp:dbus-ref&gt; calls that it may have received.&lt;/p&gt; &lt;p&gt;There can be more than one, if they were EnsureChannel requests.&lt;/p&gt; &lt;/tp:rationale&gt;
632 </td>
633 </tr>
634 <tr>
635 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
636 <td> Used to pass an 'in' argument: The time at which user action occurred, or 0 if this channel is to be handled for some reason not involving user action. Handlers SHOULD use this for focus-stealing prevention, if applicable.
637 </td>
638 </tr>
639 <tr>
640 <td><p><span class="term"><em class="parameter"><code>in_Handler_Info</code></em> :</span></p></td>
641 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Additional information about these channels. No keys are currently defined.&lt;/p&gt; &lt;p&gt;If keys are defined for this dictionary, all will be optional; handlers MAY safely ignore any entry in this dictionary.&lt;/p&gt;
642 </td>
643 </tr>
644 <tr>
645 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
646 <td> called when the method call succeeds or fails;
647 may be <a
648 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
649 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
650 reply tracking
651 </td>
652 </tr>
653 <tr>
654 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
655 <td> user-supplied data passed to the callback;
656 must be <a
657 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
658 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
659 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
660 ><code class="literal">NULL</code></a>
661 </td>
662 </tr>
663 <tr>
664 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
665 <td> called with the user_data as argument, after the
666 call has succeeded, failed or been cancelled;
667 must be <a
668 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
669 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
670 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
671 ><code class="literal">NULL</code></a>
672 </td>
673 </tr>
674 <tr>
675 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
676 <td> If not <a
677 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
678 ><code class="literal">NULL</code></a>, a <a
679 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
680 ><span class="type">GObject</span></a> which will be
681 weakly referenced; if it is destroyed, this call
682 will automatically be cancelled. Must be <a
683 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
684 ><code class="literal">NULL</code></a> if
685 <em class="parameter"><code>callback</code></em> is <a
686 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
687 ><code class="literal">NULL</code></a>
688 </td>
689 </tr>
690 <tr>
691 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
692 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
693 progress. It is borrowed from the object, and will become
694 invalid when the callback is called, the call is
695 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
696 </td>
697 </tr>
698 </tbody>
699 </table></div>
700 </div>
701 <hr>
702 <div class="refsect2" title="tp_cli_client_interface_requests_callback_for_add_request ()">
703 <a name="tp-cli-client-interface-requests-callback-for-add-request"></a><h3>tp_cli_client_interface_requests_callback_for_add_request ()</h3>
704 <pre class="programlisting">void (*tp_cli_client_interface_requests_callback_for_add_request)
705 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
706 const <a
707 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
708 >GError</a> *error,
709 <a
710 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
711 >gpointer</a> user_data,
712 <a
713 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
714 >GObject</a> *weak_object);</pre>
715 <p>
716 Signature of the callback called when a AddRequest method call
717 succeeds or fails.</p>
718 <p>
719 </p>
720 <div class="variablelist"><table border="0">
721 <col align="left" valign="top">
722 <tbody>
723 <tr>
724 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
725 <td> the proxy on which the call was made
726 </td>
727 </tr>
728 <tr>
729 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
730 <td> <a
731 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
732 ><code class="literal">NULL</code></a> on success, or an error on failure
733 </td>
734 </tr>
735 <tr>
736 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
737 <td> user-supplied data
738 </td>
739 </tr>
740 <tr>
741 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
742 <td> user-supplied object
743 </td>
744 </tr>
745 </tbody>
746 </table></div>
747 </div>
748 <hr>
749 <div class="refsect2" title="tp_cli_client_interface_requests_call_add_request ()">
750 <a name="tp-cli-client-interface-requests-call-add-request"></a><h3>tp_cli_client_interface_requests_call_add_request ()</h3>
751 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_client_interface_requests_call_add_request
752 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
753 <a
754 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
755 >gint</a> timeout_ms,
756 const <a
757 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
758 >gchar</a> *in_Request,
759 <a
760 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
761 >GHashTable</a> *in_Properties,
762 <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-add-request" title="tp_cli_client_interface_requests_callback_for_add_request ()">tp_cli_client_interface_requests_callback_for_add_request</a> callback,
763 <a
764 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
765 >gpointer</a> user_data,
766 <a
767 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
768 >GDestroyNotify</a> destroy,
769 <a
770 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
771 >GObject</a> *weak_object);</pre>
772 <p>
773 Start a AddRequest method call.
774 </p>
775 <p>
776 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by the ChannelDispatcher to indicate that channels have been requested, and that if the request is successful, they will probably be handled by this Handler. The ChannelDispatcher SHOULD only call this method on one handler per request.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This allows the UI to start preparing to handle the channels in advance (e.g. render a window with an &amp;quot;in progress&amp;quot; message), improving perceived responsiveness.&lt;/p&gt; &lt;p&gt;The use of &amp;quot;probably&amp;quot; is because you can't necessarily tell from a channel request which handler will handle particular channels. A reasonable heuristic would be to match the request against the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandlerChannelFilter&lt;/tp:dbus-ref&gt;, and respect the preferred handler (if any).&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If the request succeeds and is given to the expected Handler, the Requests_Satisfied parameter to &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt; can be used to match the channel to a previous AddRequest call.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This lets the UI direct the channels to the window that it already opened.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If the request fails, the expected handler is notified by the channel dispatcher calling its &lt;tp:member-ref&gt;RemoveRequest&lt;/tp:member-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This lets the UI close the window or display the error.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The channel dispatcher SHOULD remember which handler was notified, and if the channel request succeeds, it SHOULD dispatch the channels to the expected handler, unless the channels do not match that handler's &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandlerChannelFilter&lt;/tp:dbus-ref&gt;. If the channels are not dispatched to the expected handler, the handler that was expected is notified by the channel dispatcher calling its &lt;tp:member-ref&gt;RemoveRequest&lt;/tp:member-ref&gt; method with the NotYours error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Expected handling is for the UI to close the window it previously opened.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Handlers SHOULD NOT return an error from this method; errors returned from this method SHOULD NOT alter the channel dispatcher's behaviour.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Calls to this method are merely a notification.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
777 <p>
778 </p>
779 <div class="variablelist"><table border="0">
780 <col align="left" valign="top">
781 <tbody>
782 <tr>
783 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
784 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
785 </td>
786 </tr>
787 <tr>
788 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
789 <td> the timeout in milliseconds, or -1 to use the
790 default
791 </td>
792 </tr>
793 <tr>
794 <td><p><span class="term"><em class="parameter"><code>in_Request</code></em> :</span></p></td>
795 <td> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which MUST have been returned by &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher"&gt;CreateChannel&lt;/tp:dbus-ref&gt; or &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher"&gt;EnsureChannel&lt;/tp:dbus-ref&gt; before this method is called. &lt;tp:rationale&gt; See those methods for the rationale of this ordering. &lt;/tp:rationale&gt;
796 </td>
797 </tr>
798 <tr>
799 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
800 <td> Used to pass an 'in' argument: &lt;p&gt;Some of the properties of the ChannelRequest. To avoid race conditions, this dictionary MUST NOT include properties whose values could subsequently change. It SHOULD include as many properties as possible, given that constraint.&lt;/p&gt; &lt;p&gt;In particular, the properties &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelRequest"&gt;Requests&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelRequest"&gt;UserActionTime&lt;/tp:dbus-ref&gt; MUST be included.&lt;/p&gt;
801 </td>
802 </tr>
803 <tr>
804 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
805 <td> called when the method call succeeds or fails;
806 may be <a
807 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
808 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
809 reply tracking
810 </td>
811 </tr>
812 <tr>
813 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
814 <td> user-supplied data passed to the callback;
815 must be <a
816 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
817 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
818 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
819 ><code class="literal">NULL</code></a>
820 </td>
821 </tr>
822 <tr>
823 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
824 <td> called with the user_data as argument, after the
825 call has succeeded, failed or been cancelled;
826 must be <a
827 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
828 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
829 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
830 ><code class="literal">NULL</code></a>
831 </td>
832 </tr>
833 <tr>
834 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
835 <td> If not <a
836 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
837 ><code class="literal">NULL</code></a>, a <a
838 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
839 ><span class="type">GObject</span></a> which will be
840 weakly referenced; if it is destroyed, this call
841 will automatically be cancelled. Must be <a
842 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
843 ><code class="literal">NULL</code></a> if
844 <em class="parameter"><code>callback</code></em> is <a
845 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
846 ><code class="literal">NULL</code></a>
847 </td>
848 </tr>
849 <tr>
850 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
851 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
852 progress. It is borrowed from the object, and will become
853 invalid when the callback is called, the call is
854 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
855 </td>
856 </tr>
857 </tbody>
858 </table></div>
859 </div>
860 <hr>
861 <div class="refsect2" title="tp_cli_client_interface_requests_callback_for_remove_request ()">
862 <a name="tp-cli-client-interface-requests-callback-for-remove-request"></a><h3>tp_cli_client_interface_requests_callback_for_remove_request ()</h3>
863 <pre class="programlisting">void (*tp_cli_client_interface_requests_callback_for_remove_request)
864 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
865 const <a
866 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
867 >GError</a> *error,
868 <a
869 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
870 >gpointer</a> user_data,
871 <a
872 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
873 >GObject</a> *weak_object);</pre>
874 <p>
875 Signature of the callback called when a RemoveRequest method call
876 succeeds or fails.</p>
877 <p>
878 </p>
879 <div class="variablelist"><table border="0">
880 <col align="left" valign="top">
881 <tbody>
882 <tr>
883 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
884 <td> the proxy on which the call was made
885 </td>
886 </tr>
887 <tr>
888 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
889 <td> <a
890 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
891 ><code class="literal">NULL</code></a> on success, or an error on failure
892 </td>
893 </tr>
894 <tr>
895 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
896 <td> user-supplied data
897 </td>
898 </tr>
899 <tr>
900 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
901 <td> user-supplied object
902 </td>
903 </tr>
904 </tbody>
905 </table></div>
906 </div>
907 <hr>
908 <div class="refsect2" title="tp_cli_client_interface_requests_call_remove_request ()">
909 <a name="tp-cli-client-interface-requests-call-remove-request"></a><h3>tp_cli_client_interface_requests_call_remove_request ()</h3>
910 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_client_interface_requests_call_remove_request
911 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
912 <a
913 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
914 >gint</a> timeout_ms,
915 const <a
916 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
917 >gchar</a> *in_Request,
918 const <a
919 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
920 >gchar</a> *in_Error,
921 const <a
922 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
923 >gchar</a> *in_Message,
924 <a class="link" href="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request" title="tp_cli_client_interface_requests_callback_for_remove_request ()">tp_cli_client_interface_requests_callback_for_remove_request</a> callback,
925 <a
926 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
927 >gpointer</a> user_data,
928 <a
929 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
930 >GDestroyNotify</a> destroy,
931 <a
932 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
933 >GObject</a> *weak_object);</pre>
934 <p>
935 Start a RemoveRequest method call.
936 </p>
937 <p>
938 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by the ChannelDispatcher to indicate that a request previously passed to &lt;tp:member-ref&gt;AddRequest&lt;/tp:member-ref&gt; has failed and should be disregarded.&lt;/p&gt; &lt;p&gt;Handlers SHOULD NOT return an error from this method; errors returned from this method SHOULD NOT alter the channel dispatcher's behaviour.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Calls to this method are merely a notification.&lt;/p&gt; &lt;/tp:rationale&gt;</p>
939 <p>
940 </p>
941 <div class="variablelist"><table border="0">
942 <col align="left" valign="top">
943 <tbody>
944 <tr>
945 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
946 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
947 </td>
948 </tr>
949 <tr>
950 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
951 <td> the timeout in milliseconds, or -1 to use the
952 default
953 </td>
954 </tr>
955 <tr>
956 <td><p><span class="term"><em class="parameter"><code>in_Request</code></em> :</span></p></td>
957 <td> Used to pass an 'in' argument: The request that failed.
958 </td>
959 </tr>
960 <tr>
961 <td><p><span class="term"><em class="parameter"><code>in_Error</code></em> :</span></p></td>
962 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The name of the D-Bus error with which the request failed.&lt;/p&gt; &lt;p&gt;If this is &lt;code&gt;org.freedesktop.Telepathy.Error.NotYours&lt;/code&gt;, this indicates that the request succeeded, but all the resulting channels were given to some other handler.&lt;/p&gt;
963 </td>
964 </tr>
965 <tr>
966 <td><p><span class="term"><em class="parameter"><code>in_Message</code></em> :</span></p></td>
967 <td> Used to pass an 'in' argument: Any message supplied with the D-Bus error.
968 </td>
969 </tr>
970 <tr>
971 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
972 <td> called when the method call succeeds or fails;
973 may be <a
974 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
975 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
976 reply tracking
977 </td>
978 </tr>
979 <tr>
980 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
981 <td> user-supplied data passed to the callback;
982 must be <a
983 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
984 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
985 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
986 ><code class="literal">NULL</code></a>
987 </td>
988 </tr>
989 <tr>
990 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
991 <td> called with the user_data as argument, after the
992 call has succeeded, failed or been cancelled;
993 must be <a
994 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
995 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
996 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
997 ><code class="literal">NULL</code></a>
998 </td>
999 </tr>
1000 <tr>
1001 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1002 <td> If not <a
1003 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1004 ><code class="literal">NULL</code></a>, a <a
1005 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1006 ><span class="type">GObject</span></a> which will be
1007 weakly referenced; if it is destroyed, this call
1008 will automatically be cancelled. Must be <a
1009 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1010 ><code class="literal">NULL</code></a> if
1011 <em class="parameter"><code>callback</code></em> is <a
1012 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1013 ><code class="literal">NULL</code></a>
1014 </td>
1015 </tr>
1016 <tr>
1017 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1018 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1019 progress. It is borrowed from the object, and will become
1020 invalid when the callback is called, the call is
1021 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
1022 </td>
1023 </tr>
1024 </tbody>
1025 </table></div>
1026 </div>
1027 <hr>
1028 <div class="refsect2" title="tp_cli_client_approver_callback_for_add_dispatch_operation ()">
1029 <a name="tp-cli-client-approver-callback-for-add-dispatch-operation"></a><h3>tp_cli_client_approver_callback_for_add_dispatch_operation ()</h3>
1030 <pre class="programlisting">void (*tp_cli_client_approver_callback_for_add_dispatch_operation)
1031 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
1032 const <a
1033 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1034 >GError</a> *error,
1035 <a
1036 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1037 >gpointer</a> user_data,
1038 <a
1039 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1040 >GObject</a> *weak_object);</pre>
1041 <p>
1042 Signature of the callback called when a AddDispatchOperation method call
1043 succeeds or fails.</p>
1044 <p>
1045 </p>
1046 <div class="variablelist"><table border="0">
1047 <col align="left" valign="top">
1048 <tbody>
1049 <tr>
1050 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1051 <td> the proxy on which the call was made
1052 </td>
1053 </tr>
1054 <tr>
1055 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1056 <td> <a
1057 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1058 ><code class="literal">NULL</code></a> on success, or an error on failure
1059 </td>
1060 </tr>
1061 <tr>
1062 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1063 <td> user-supplied data
1064 </td>
1065 </tr>
1066 <tr>
1067 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1068 <td> user-supplied object
1069 </td>
1070 </tr>
1071 </tbody>
1072 </table></div>
1073 </div>
1074 <hr>
1075 <div class="refsect2" title="tp_cli_client_approver_call_add_dispatch_operation ()">
1076 <a name="tp-cli-client-approver-call-add-dispatch-operation"></a><h3>tp_cli_client_approver_call_add_dispatch_operation ()</h3>
1077 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_client_approver_call_add_dispatch_operation
1078 (<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a> *proxy,
1079 <a
1080 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1081 >gint</a> timeout_ms,
1082 const <a
1083 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
1084 >GPtrArray</a> *in_Channels,
1085 const <a
1086 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1087 >gchar</a> *in_DispatchOperation,
1088 <a
1089 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
1090 >GHashTable</a> *in_Properties,
1091 <a class="link" href="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation" title="tp_cli_client_approver_callback_for_add_dispatch_operation ()">tp_cli_client_approver_callback_for_add_dispatch_operation</a> callback,
1092 <a
1093 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1094 >gpointer</a> user_data,
1095 <a
1096 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
1097 >GDestroyNotify</a> destroy,
1098 <a
1099 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1100 >GObject</a> *weak_object);</pre>
1101 <p>
1102 Start a AddDispatchOperation method call.
1103 </p>
1104 <p>
1105 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Called by the channel dispatcher when a ChannelDispatchOperation in which the approver has registered an interest is created, or when the approver starts up while such channel dispatch operations already exist.&lt;/p&gt; &lt;p&gt;The channel dispatcher SHOULD call this method on all approvers at the same time. If an approver returns an error from this method, the approver is assumed to be faulty.&lt;/p&gt; &lt;p&gt;If no approvers return from this method successfully (including situations where there are no matching approvers at all), the channel dispatcher SHOULD consider this to be an error, and recover by dispatching the channel to the most preferred handler.&lt;/p&gt; &lt;tp:rationale&gt; Processes that aren't approvers (or don't at least ensure that there is some approver) probably shouldn't be making connections anyway, so there should always be at least one approver running. &lt;/tp:rationale&gt;</p>
1106 <p>
1107 </p>
1108 <div class="variablelist"><table border="0">
1109 <col align="left" valign="top">
1110 <tbody>
1111 <tr>
1112 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1113 <td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1114 </td>
1115 </tr>
1116 <tr>
1117 <td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1118 <td> the timeout in milliseconds, or -1 to use the
1119 default
1120 </td>
1121 </tr>
1122 <tr>
1123 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
1124 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The initial value of the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation.Channels&lt;/tp:dbus-ref&gt; property, containing the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel&lt;/tp:dbus-ref&gt;s to be dispatched and their properties.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This can't be signalled to the approver through the Properties parameter of this method, because Channels is not an immutable property.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This argument always contains all of the channels in the channel dispatch operation, even if not all of them actually match the &lt;tp:member-ref&gt;ApproverChannelFilter&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This seems the least bad way to handle such a situation; see the discussion on &lt;a href="http://bugs.freedesktop.org/show_bug.cgi?id=21090"&gt;bug <span class="type">21090</span>&lt;/a&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The actual channels to be dispatched may reduce as channels are closed: this is signalled by &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation.ChannelLost&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Approvers SHOULD connect to ChannelLost and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation.Finished&lt;/tp:dbus-ref&gt;. (if desired) before returning from AddDispatchOperation, since those signals are guaranteed not to be emitted until after all AddDispatchOperation calls have returned (with success or failure) or timed out.&lt;/p&gt;
1125 </td>
1126 </tr>
1127 <tr>
1128 <td><p><span class="term"><em class="parameter"><code>in_DispatchOperation</code></em> :</span></p></td>
1129 <td> Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt; to be processed.&lt;/p&gt;
1130 </td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
1134 <td> Used to pass an 'in' argument: &lt;p&gt;Properties of the channel dispatch operation. This MUST NOT include properties that could change, SHOULD include as many properties as possible given that constraint, and MUST include at least the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;Account&lt;/tp:dbus-ref&gt;, &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;Connection&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatchOperation"&gt;PossibleHandlers&lt;/tp:dbus-ref&gt; properties.&lt;/p&gt;
1135 </td>
1136 </tr>
1137 <tr>
1138 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1139 <td> called when the method call succeeds or fails;
1140 may be <a
1141 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1142 ><code class="literal">NULL</code></a> to make a "fire and forget" call with no
1143 reply tracking
1144 </td>
1145 </tr>
1146 <tr>
1147 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1148 <td> user-supplied data passed to the callback;
1149 must be <a
1150 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1151 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1152 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1153 ><code class="literal">NULL</code></a>
1154 </td>
1155 </tr>
1156 <tr>
1157 <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1158 <td> called with the user_data as argument, after the
1159 call has succeeded, failed or been cancelled;
1160 must be <a
1161 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1162 ><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a
1163 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1164 ><code class="literal">NULL</code></a>
1165 </td>
1166 </tr>
1167 <tr>
1168 <td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1169 <td> If not <a
1170 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1171 ><code class="literal">NULL</code></a>, a <a
1172 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
1173 ><span class="type">GObject</span></a> which will be
1174 weakly referenced; if it is destroyed, this call
1175 will automatically be cancelled. Must be <a
1176 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1177 ><code class="literal">NULL</code></a> if
1178 <em class="parameter"><code>callback</code></em> is <a
1179 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1180 ><code class="literal">NULL</code></a>
1181 </td>
1182 </tr>
1183 <tr>
1184 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1185 <td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1186 progress. It is borrowed from the object, and will become
1187 invalid when the callback is called, the call is
1188 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
1189 </td>
1190 </tr>
1191 </tbody>
1192 </table></div>
1193 </div>
1194 </div>
1195 </div>
1196 <div class="footer">
1197 <hr>
1198 Generated by GTK-Doc V1.11</div>
1199 </body>
1200 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Aliasing interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-contact.html" title="TpContact">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Avatars interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-aliasing.html" title="Connection Aliasing interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Capabilities interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-contacts.html" title="Connection Contacts interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Contacts interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-avatars.html" title="Connection Avatars interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpConnectionManager</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="ch-client.html" title="Client-side proxies">
212212 <a
213213 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
214214 >GError</a> **error);
215 void <a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-init-known-interfaces" title="tp_connection_manager_init_known_interfaces ()">tp_connection_manager_init_known_interfaces</a>
216 (void);
215217
216218
217219 void (<a class="link" href="telepathy-glib-connection-manager.html#tp-cli-connection-manager-callback-for-get-parameters" title="tp_cli_connection_manager_callback_for_get_parameters ()">*tp_cli_connection_manager_callback_for_get_parameters</a>)
17981800 <p class="since">Since 0.7.1</p>
17991801 </div>
18001802 <hr>
1803 <div class="refsect2" title="tp_connection_manager_init_known_interfaces ()">
1804 <a name="tp-connection-manager-init-known-interfaces"></a><h3>tp_connection_manager_init_known_interfaces ()</h3>
1805 <pre class="programlisting">void tp_connection_manager_init_known_interfaces
1806 (void);</pre>
1807 <p>
1808 Ensure that the known interfaces for TpConnectionManager have been set up.
1809 This is done automatically when necessary, but for correct
1810 overriding of library interfaces by local extensions, you should
1811 call this function before calling
1812 <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
1813 <code class="literal">TP_TYPE_CONNECTION_MANAGER</code>.</p>
1814 <p>
1815 </p>
1816 <p class="since">Since 0.7.UNRELEASED</p>
1817 </div>
1818 <hr>
18011819 <div class="refsect2" title="tp_cli_connection_manager_callback_for_get_parameters ()">
18021820 <a name="tp-cli-connection-manager-callback-for-get-parameters"></a><h3>tp_cli_connection_manager_callback_for_get_parameters ()</h3>
18031821 <pre class="programlisting">void (*tp_cli_connection_manager_callback_for_get_parameters)
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Presence interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-simple-presence.html" title="Connection SimplePresence interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection Requests interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-caps.html" title="Connection Capabilities interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection SimplePresence interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-requests.html" title="Connection Requests interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpConnection</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection-manager.html" title="TpConnectionManager">
17881788 <p>
17891789 This is a thin wrapper around the GetContactAttributes D-Bus method, and
17901790 should be used in preference to
1791 <code class="function">tp_cli_connection_interface_contacts_get_contact_attributes()</code>.
1791 <code class="function">tp_cli_connection_interface_contacts_get_contact_attributes()</code>; mixing this
1792 function, <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-unref-handles" title="tp_connection_unref_handles ()"><code class="function">tp_connection_unref_handles()</code></a>, and
1793 <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> with direct use of the RequestHandles, HoldHandles and
1794 GetContactAttributes D-Bus methods is unwise, as <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> and
1795 <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> perform client-side reference counting of handles.
17921796 The <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> API provides a higher-level abstraction which should
17931797 usually be used instead.
17941798 </p>
18971901 <p>
18981902 If they are valid, the callback will later be called with the given
18991903 handles; if not all of them are valid, the callback will be called with
1900 an error.</p>
1904 an error.
1905 </p>
1906 <p>
1907 This function, along 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>,
1908 <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> and <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a>, keeps a client-side
1909 reference count of handles; you should not use the RequestHandles,
1910 HoldHandles and GetContactAttributes D-Bus methods directly as well as these
1911 functions.</p>
19011912 <p>
19021913 </p>
19031914 <div class="variablelist"><table border="0">
19791990 <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.
19801991 Those functions should be avoided in favour of using <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a>,
19811992 <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
1982 <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>.
1993 <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>, which along with this function
1994 perform client-side reference counting of handles.
19831995 </p>
19841996 <p>
19851997 If <em class="parameter"><code>self</code></em> has already become invalid, this function does nothing.</p>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpContact</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-connection.html" title="TpConnection">
370370 <td><p><span class="term"><em class="parameter"><code>contacts</code></em> :</span></p></td>
371371 <td> An array of <em class="parameter"><code>n_contacts</code></em> TpContact objects (this callback is
372372 not given a reference to any of these objects, and must call <a
373 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
373 href="../libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
374374 ><code class="function">g_object_ref()</code></a>
375375 on any that it will keep), or <a
376376 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
587587 <td> An array of <em class="parameter"><code>n_contacts</code></em> TpContact objects (this callback is
588588 not given a reference to any of these objects, and must call
589589 <a
590 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
590 href="../libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
591591 ><code class="function">g_object_ref()</code></a> on any that it will keep), or <a
592592 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
593593 ><code class="literal">NULL</code></a> on unrecoverable errors
778778 <td> An array of <em class="parameter"><code>n_contacts</code></em> TpContact objects (this callback is
779779 not given an extra reference to any of these objects, and must call
780780 <a
781 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
781 href="../libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
782782 ><code class="function">g_object_ref()</code></a> on any that it will keep)
783783 </td>
784784 </tr>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpDBusPropertiesMixin</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="telepathy-glib-TpContactsMixin.html" title="TpContactsMixin">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>D-Bus utilities</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="telepathy-glib-proxy-tp-properties.html" title="TpProxy Telepathy Properties">
185185 <a
186186 href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
187187 >GDestroyNotify</a> destroy);
188 void <a class="link" href="telepathy-glib-dbus.html#tp-dbus-daemon-init-known-interfaces" title="tp_dbus_daemon_init_known_interfaces ()">tp_dbus_daemon_init_known_interfaces</a>
189 (void);
188190
189191 <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * <a class="link" href="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-add-match" title="tp_cli_dbus_daemon_call_add_match ()">tp_cli_dbus_daemon_call_add_match</a> (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *proxy,
190192 <a
19871989 <p class="since">Since 0.7.1</p>
19881990 </div>
19891991 <hr>
1992 <div class="refsect2" title="tp_dbus_daemon_init_known_interfaces ()">
1993 <a name="tp-dbus-daemon-init-known-interfaces"></a><h3>tp_dbus_daemon_init_known_interfaces ()</h3>
1994 <pre class="programlisting">void tp_dbus_daemon_init_known_interfaces
1995 (void);</pre>
1996 <p>
1997 Ensure that the known interfaces for TpDBusDaemon have been set up.
1998 This is done automatically when necessary, but for correct
1999 overriding of library interfaces by local extensions, you should
2000 call this function before calling
2001 <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
2002 <code class="literal">TP_TYPE_DBUS_DAEMON</code>.</p>
2003 <p>
2004 </p>
2005 <p class="since">Since 0.7.UNRELEASED</p>
2006 </div>
2007 <hr>
19902008 <div class="refsect2" title="tp_cli_dbus_daemon_call_add_match ()">
19912009 <a name="tp-cli-dbus-daemon-call-add-match"></a><h3>tp_cli_dbus_daemon_call_add_match ()</h3>
19922010 <pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall">TpProxyPendingCall</a> * tp_cli_dbus_daemon_call_add_match (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a> *proxy,
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>ANSI codes for debug messages</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-utilities.html" title="Utilities">
88 <link rel="prev" href="telepathy-glib-util.html" title="Utilities">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Common debug support</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-utilities.html" title="Utilities">
88 <link rel="prev" href="telepathy-glib-debug-ansi.html" title="ANSI codes for debug messages">
118118 <code class="literal">handles</code> - handle reference tracking tracking
119119 in <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> (service) and <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> (client)</li>
120120 <li class="listitem">
121 <code class="literal">accounts</code> - the <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> and
122 <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> objects (client)</li>
123 <li class="listitem">
121124 <code class="literal">all</code> - all of the above</li>
122125 </ul></div>
123126 <p>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Miscellaneous definitions</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="ch-protocol.html" title="The Telepathy protocol">
5252 #define <a class="link" href="telepathy-glib-defs.html#TP-CM-OBJECT-PATH-BASE--CAPS" title="TP_CM_OBJECT_PATH_BASE">TP_CM_OBJECT_PATH_BASE</a>
5353 #define <a class="link" href="telepathy-glib-defs.html#TP-CONN-BUS-NAME-BASE--CAPS" title="TP_CONN_BUS_NAME_BASE">TP_CONN_BUS_NAME_BASE</a>
5454 #define <a class="link" href="telepathy-glib-defs.html#TP-CONN-OBJECT-PATH-BASE--CAPS" title="TP_CONN_OBJECT_PATH_BASE">TP_CONN_OBJECT_PATH_BASE</a>
55 #define <a class="link" href="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-BUS-NAME--CAPS" title="TP_ACCOUNT_MANAGER_BUS_NAME">TP_ACCOUNT_MANAGER_BUS_NAME</a>
56 #define <a class="link" href="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS" title="TP_ACCOUNT_MANAGER_OBJECT_PATH">TP_ACCOUNT_MANAGER_OBJECT_PATH</a>
57 #define <a class="link" href="telepathy-glib-defs.html#TP-ACCOUNT-OBJECT-PATH-BASE--CAPS" title="TP_ACCOUNT_OBJECT_PATH_BASE">TP_ACCOUNT_OBJECT_PATH_BASE</a>
58 #define <a class="link" href="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS" title="TP_CHANNEL_DISPATCHER_BUS_NAME">TP_CHANNEL_DISPATCHER_BUS_NAME</a>
59 #define <a class="link" href="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS" title="TP_CHANNEL_DISPATCHER_OBJECT_PATH">TP_CHANNEL_DISPATCHER_OBJECT_PATH</a>
60 #define <a class="link" href="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE--CAPS" title="TP_CLIENT_BUS_NAME_BASE">TP_CLIENT_BUS_NAME_BASE</a>
61 #define <a class="link" href="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE--CAPS" title="TP_CLIENT_OBJECT_PATH_BASE">TP_CLIENT_OBJECT_PATH_BASE</a>
5562 </pre>
5663 </div>
5764 <div class="refsect1" title="Description">
113120 <p>
114121 </p>
115122 </div>
123 <hr>
124 <div class="refsect2" title="TP_ACCOUNT_MANAGER_BUS_NAME">
125 <a name="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS"></a><h3>TP_ACCOUNT_MANAGER_BUS_NAME</h3>
126 <pre class="programlisting">#define TP_ACCOUNT_MANAGER_BUS_NAME "org.freedesktop.Telepathy.AccountManager"
127 </pre>
128 <p>
129 The account manager's well-known bus name</p>
130 <p>
131 </p>
132 </div>
133 <hr>
134 <div class="refsect2" title="TP_ACCOUNT_MANAGER_OBJECT_PATH">
135 <a name="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS"></a><h3>TP_ACCOUNT_MANAGER_OBJECT_PATH</h3>
136 <pre class="programlisting">#define TP_ACCOUNT_MANAGER_OBJECT_PATH "/org/freedesktop/Telepathy/AccountManager"
137 </pre>
138 <p>
139 The account manager's standard object path</p>
140 <p>
141 </p>
142 </div>
143 <hr>
144 <div class="refsect2" title="TP_ACCOUNT_OBJECT_PATH_BASE">
145 <a name="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS"></a><h3>TP_ACCOUNT_OBJECT_PATH_BASE</h3>
146 <pre class="programlisting">#define TP_ACCOUNT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Account/"
147 </pre>
148 <p>
149 The common prefix of the object path for all Account objects.</p>
150 <p>
151 </p>
152 </div>
153 <hr>
154 <div class="refsect2" title="TP_CHANNEL_DISPATCHER_BUS_NAME">
155 <a name="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS"></a><h3>TP_CHANNEL_DISPATCHER_BUS_NAME</h3>
156 <pre class="programlisting">#define TP_CHANNEL_DISPATCHER_BUS_NAME "org.freedesktop.Telepathy.ChannelDispatcher"
157 </pre>
158 <p>
159 The channel dispatcher's well-known bus name</p>
160 <p>
161 </p>
162 </div>
163 <hr>
164 <div class="refsect2" title="TP_CHANNEL_DISPATCHER_OBJECT_PATH">
165 <a name="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS"></a><h3>TP_CHANNEL_DISPATCHER_OBJECT_PATH</h3>
166 <pre class="programlisting">#define TP_CHANNEL_DISPATCHER_OBJECT_PATH "/org/freedesktop/Telepathy/ChannelDispatcher"
167 </pre>
168 <p>
169 The channel dispatcher's standard object path</p>
170 <p>
171 </p>
172 </div>
173 <hr>
174 <div class="refsect2" title="TP_CLIENT_BUS_NAME_BASE">
175 <a name="TP-CLIENT-BUS-NAME-BASE--CAPS"></a><h3>TP_CLIENT_BUS_NAME_BASE</h3>
176 <pre class="programlisting">#define TP_CLIENT_BUS_NAME_BASE "org.freedesktop.Telepathy.Client."
177 </pre>
178 <p>
179 The common prefix of the well-known bus name for any Telepathy Client.</p>
180 <p>
181 </p>
182 </div>
183 <hr>
184 <div class="refsect2" title="TP_CLIENT_OBJECT_PATH_BASE">
185 <a name="TP-CLIENT-OBJECT-PATH-BASE--CAPS"></a><h3>TP_CLIENT_OBJECT_PATH_BASE</h3>
186 <pre class="programlisting">#define TP_CLIENT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Client/"
187 </pre>
188 <p>
189 The common prefix of the well-known object path for any Telepathy Client.</p>
190 <p>
191 </p>
192 </div>
116193 </div>
117194 </div>
118195 <div class="footer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Telepathy protocol enumerations</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-interfaces.html" title="Telepathy protocol interface strings">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Telepathy protocol errors</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-enums.html" title="Telepathy protocol enumerations">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>GType factory functions</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-errors.html" title="Telepathy protocol errors">
147147
148148 #define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS" title="TP_ARRAY_TYPE_ROOM_INFO_LIST">TP_ARRAY_TYPE_ROOM_INFO_LIST</a>
149149 #define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ROOM-INFO--CAPS" title="TP_STRUCT_TYPE_ROOM_INFO">TP_STRUCT_TYPE_ROOM_INFO</a>
150
151 #define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-AVATAR--CAPS" title="TP_STRUCT_TYPE_AVATAR">TP_STRUCT_TYPE_AVATAR</a>
152
153 #define <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS" title="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</a>
154 #define <a class="link" href="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS" title="TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST">TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</a>
150155 </pre>
151156 </div>
152157 <div class="refsect1" title="Description">
25452550 <p>
25462551 </p>
25472552 </div>
2553 <hr>
2554 <div class="refsect2" title="TP_STRUCT_TYPE_AVATAR">
2555 <a name="TP-STRUCT-TYPE-AVATAR--CAPS"></a><h3>TP_STRUCT_TYPE_AVATAR</h3>
2556 <pre class="programlisting">#define TP_STRUCT_TYPE_AVATAR</pre>
2557 <p>
2558 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;
2559
2560
2561 &lt;p&gt;
2562 A struct containing avatar data marked with its MIME type.
2563 &lt;/p&gt;
2564
2565
2566 </p>
2567 <p>
2568 This macro expands to a call to a function
2569 that returns the <a
2570 href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
2571 ><span class="type">GType</span></a> of a <a
2572 href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
2573 ><span class="type">GValueArray</span></a>
2574 appropriate for representing a D-Bus struct
2575 with signature <code class="literal">(ays)</code>.
2576 </p>
2577 <p>
2578 Member 0 (D-Bus type <code class="literal">ay</code>,
2579 named <code class="literal">Avatar_Data</code>):
2580 (Undocumented)
2581 </p>
2582 <p>
2583 Member 1 (D-Bus type <code class="literal">s</code>,
2584 named <code class="literal">MIME_Type</code>):
2585 (Undocumented)</p>
2586 <p>
2587 </p>
2588 </div>
2589 <hr>
2590 <div class="refsect2" title="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS">
2591 <a name="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"></a><h3>TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</h3>
2592 <pre class="programlisting">#define TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</pre>
2593 <p>
2594 Details of a channel dispatch operation.
2595
2596 </p>
2597 <p>
2598 This macro expands to a call to a function
2599 that returns the <a
2600 href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
2601 ><span class="type">GType</span></a> of a <a
2602 href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
2603 ><span class="type">GValueArray</span></a>
2604 appropriate for representing a D-Bus struct
2605 with signature <code class="literal">(oa{sv})</code>.
2606 </p>
2607 <p>
2608 Member 0 (D-Bus type <code class="literal">o</code>,
2609 named <code class="literal">Channel_Dispatch_Operation</code>):
2610 The object path of the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt;.
2611 </p>
2612 <p>
2613 Member 1 (D-Bus type <code class="literal">a{sv}</code>,
2614 type <code class="literal">Qualified_Property_Value_Map</code>,
2615 named <code class="literal">Properties</code>):
2616 &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;p&gt;Properties of the channel dispatch operation.&lt;/p&gt; &lt;p&gt;Connection managers MUST NOT include properties in this mapping if their values can change. Clients MUST ignore properties that appear in this mapping if their values can change.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The rationale is the same as for &lt;tp:type-ref&gt;Channel_Details&lt;/tp:type-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Each dictionary MUST contain at least the following keys:&lt;/p&gt; &lt;ul&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Interfaces&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Connection&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Account&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.PossibleHandlers&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;/ul&gt;</p>
2617 <p>
2618 </p>
2619 </div>
2620 <hr>
2621 <div class="refsect2" title="TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST">
2622 <a name="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"></a><h3>TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</h3>
2623 <pre class="programlisting">#define TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</pre>
2624 <p>
2625 Expands to a call to a function
2626 that returns the <a
2627 href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
2628 ><span class="type">GType</span></a> of a <a
2629 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
2630 ><span class="type">GPtrArray</span></a>
2631 of <a class="link" href="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS" title="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS"><span class="type">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</span></a>.</p>
2632 <p>
2633 </p>
2634 </div>
25482635 </div>
25492636 </div>
25502637 <div class="footer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpHandleRepoIface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-handles.html" title="Service-side handle repositories">
88 <link rel="prev" href="ch-service-handles.html" title="Service-side handle repositories">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpHandle</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-defs.html" title="Miscellaneous definitions">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Telepathy protocol interface strings</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-protocol.html" title="The Telepathy protocol">
88 <link rel="prev" href="telepathy-glib-handle.html" title="TpHandle">
4747
4848 #include &lt;telepathy-glib/interfaces.h&gt;
4949
50 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT--CAPS" title="TP_IFACE_ACCOUNT">TP_IFACE_ACCOUNT</a>
51 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT--CAPS" title="TP_IFACE_QUARK_ACCOUNT">TP_IFACE_QUARK_ACCOUNT</a>
52 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS" title="TP_IFACE_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_ACCOUNT_INTERFACE_AVATAR</a>
53 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS" title="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</a>
54 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER--CAPS" title="TP_IFACE_ACCOUNT_MANAGER">TP_IFACE_ACCOUNT_MANAGER</a>
55 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS" title="TP_IFACE_QUARK_ACCOUNT_MANAGER">TP_IFACE_QUARK_ACCOUNT_MANAGER</a>
5056 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON--CAPS" title="TP_IFACE_DBUS_DAEMON">TP_IFACE_DBUS_DAEMON</a>
5157 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-DBUS-DAEMON--CAPS" title="TP_IFACE_QUARK_DBUS_DAEMON">TP_IFACE_QUARK_DBUS_DAEMON</a>
5258 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-DBUS-INTROSPECTABLE--CAPS" title="TP_IFACE_DBUS_INTROSPECTABLE">TP_IFACE_DBUS_INTROSPECTABLE</a>
111117 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS" title="TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING">TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING</a>
112118 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS" title="TP_IFACE_CHANNEL_INTERFACE_MESSAGES">TP_IFACE_CHANNEL_INTERFACE_MESSAGES</a>
113119 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS" title="TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES">TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES</a>
120 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER--CAPS" title="TP_IFACE_CHANNEL_DISPATCHER">TP_IFACE_CHANNEL_DISPATCHER</a>
121 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS" title="TP_IFACE_QUARK_CHANNEL_DISPATCHER">TP_IFACE_QUARK_CHANNEL_DISPATCHER</a>
122 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" title="TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</a>
123 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" title="TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</a>
124 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS" title="TP_IFACE_CHANNEL_DISPATCH_OPERATION">TP_IFACE_CHANNEL_DISPATCH_OPERATION</a>
125 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS" title="TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION">TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</a>
126 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-REQUEST--CAPS" title="TP_IFACE_CHANNEL_REQUEST">TP_IFACE_CHANNEL_REQUEST</a>
127 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS" title="TP_IFACE_QUARK_CHANNEL_REQUEST">TP_IFACE_QUARK_CHANNEL_REQUEST</a>
114128 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-SESSION-HANDLER--CAPS" title="TP_IFACE_MEDIA_SESSION_HANDLER">TP_IFACE_MEDIA_SESSION_HANDLER</a>
115129 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS" title="TP_IFACE_QUARK_MEDIA_SESSION_HANDLER">TP_IFACE_QUARK_MEDIA_SESSION_HANDLER</a>
116130 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-STREAM-HANDLER--CAPS" title="TP_IFACE_MEDIA_STREAM_HANDLER">TP_IFACE_MEDIA_STREAM_HANDLER</a>
117131 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS" title="TP_IFACE_QUARK_MEDIA_STREAM_HANDLER">TP_IFACE_QUARK_MEDIA_STREAM_HANDLER</a>
118132 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-PROPERTIES-INTERFACE--CAPS" title="TP_IFACE_PROPERTIES_INTERFACE">TP_IFACE_PROPERTIES_INTERFACE</a>
119133 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS" title="TP_IFACE_QUARK_PROPERTIES_INTERFACE">TP_IFACE_QUARK_PROPERTIES_INTERFACE</a>
134 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CLIENT--CAPS" title="TP_IFACE_CLIENT">TP_IFACE_CLIENT</a>
135 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT--CAPS" title="TP_IFACE_QUARK_CLIENT">TP_IFACE_QUARK_CLIENT</a>
136 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-APPROVER--CAPS" title="TP_IFACE_CLIENT_APPROVER">TP_IFACE_CLIENT_APPROVER</a>
137 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-APPROVER--CAPS" title="TP_IFACE_QUARK_CLIENT_APPROVER">TP_IFACE_QUARK_CLIENT_APPROVER</a>
138 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-HANDLER--CAPS" title="TP_IFACE_CLIENT_HANDLER">TP_IFACE_CLIENT_HANDLER</a>
139 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-HANDLER--CAPS" title="TP_IFACE_QUARK_CLIENT_HANDLER">TP_IFACE_QUARK_CLIENT_HANDLER</a>
140 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-OBSERVER--CAPS" title="TP_IFACE_CLIENT_OBSERVER">TP_IFACE_CLIENT_OBSERVER</a>
141 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS" title="TP_IFACE_QUARK_CLIENT_OBSERVER">TP_IFACE_QUARK_CLIENT_OBSERVER</a>
142 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS" title="TP_IFACE_CLIENT_INTERFACE_REQUESTS">TP_IFACE_CLIENT_INTERFACE_REQUESTS</a>
143 #define <a class="link" href="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS" title="TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS">TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</a>
120144 </pre>
121145 </div>
122146 <div class="refsect1" title="Description">
135159 </div>
136160 <div class="refsect1" title="Details">
137161 <a name="telepathy-glib-interfaces.details"></a><h2>Details</h2>
162 <div class="refsect2" title="TP_IFACE_ACCOUNT">
163 <a name="TP-IFACE-ACCOUNT--CAPS"></a><h3>TP_IFACE_ACCOUNT</h3>
164 <pre class="programlisting">#define TP_IFACE_ACCOUNT</pre>
165 <p>
166 The interface name "org.freedesktop.Telepathy.Account"</p>
167 <p>
168 </p>
169 </div>
170 <hr>
171 <div class="refsect2" title="TP_IFACE_QUARK_ACCOUNT">
172 <a name="TP-IFACE-QUARK-ACCOUNT--CAPS"></a><h3>TP_IFACE_QUARK_ACCOUNT</h3>
173 <pre class="programlisting">#define TP_IFACE_QUARK_ACCOUNT</pre>
174 <p>
175 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Account"</p>
176 <p>
177 </p>
178 </div>
179 <hr>
180 <div class="refsect2" title="TP_IFACE_ACCOUNT_INTERFACE_AVATAR">
181 <a name="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS"></a><h3>TP_IFACE_ACCOUNT_INTERFACE_AVATAR</h3>
182 <pre class="programlisting">#define TP_IFACE_ACCOUNT_INTERFACE_AVATAR</pre>
183 <p>
184 The interface name "org.freedesktop.Telepathy.Account.Interface.Avatar"</p>
185 <p>
186 </p>
187 </div>
188 <hr>
189 <div class="refsect2" title="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR">
190 <a name="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS"></a><h3>TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</h3>
191 <pre class="programlisting">#define TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</pre>
192 <p>
193 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Account.Interface.Avatar"</p>
194 <p>
195 </p>
196 </div>
197 <hr>
198 <div class="refsect2" title="TP_IFACE_ACCOUNT_MANAGER">
199 <a name="TP-IFACE-ACCOUNT-MANAGER--CAPS"></a><h3>TP_IFACE_ACCOUNT_MANAGER</h3>
200 <pre class="programlisting">#define TP_IFACE_ACCOUNT_MANAGER</pre>
201 <p>
202 The interface name "org.freedesktop.Telepathy.AccountManager"</p>
203 <p>
204 </p>
205 </div>
206 <hr>
207 <div class="refsect2" title="TP_IFACE_QUARK_ACCOUNT_MANAGER">
208 <a name="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS"></a><h3>TP_IFACE_QUARK_ACCOUNT_MANAGER</h3>
209 <pre class="programlisting">#define TP_IFACE_QUARK_ACCOUNT_MANAGER</pre>
210 <p>
211 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.AccountManager"</p>
212 <p>
213 </p>
214 </div>
215 <hr>
138216 <div class="refsect2" title="TP_IFACE_DBUS_DAEMON">
139217 <a name="TP-IFACE-DBUS-DAEMON--CAPS"></a><h3>TP_IFACE_DBUS_DAEMON</h3>
140218 <pre class="programlisting">#define TP_IFACE_DBUS_DAEMON</pre>
711789 </p>
712790 </div>
713791 <hr>
792 <div class="refsect2" title="TP_IFACE_CHANNEL_DISPATCHER">
793 <a name="TP-IFACE-CHANNEL-DISPATCHER--CAPS"></a><h3>TP_IFACE_CHANNEL_DISPATCHER</h3>
794 <pre class="programlisting">#define TP_IFACE_CHANNEL_DISPATCHER</pre>
795 <p>
796 The interface name "org.freedesktop.Telepathy.ChannelDispatcher"</p>
797 <p>
798 </p>
799 </div>
800 <hr>
801 <div class="refsect2" title="TP_IFACE_QUARK_CHANNEL_DISPATCHER">
802 <a name="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS"></a><h3>TP_IFACE_QUARK_CHANNEL_DISPATCHER</h3>
803 <pre class="programlisting">#define TP_IFACE_QUARK_CHANNEL_DISPATCHER</pre>
804 <p>
805 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatcher"</p>
806 <p>
807 </p>
808 </div>
809 <hr>
810 <div class="refsect2" title="TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">
811 <a name="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"></a><h3>TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</h3>
812 <pre class="programlisting">#define TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</pre>
813 <p>
814 The interface name "org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList"</p>
815 <p>
816 </p>
817 </div>
818 <hr>
819 <div class="refsect2" title="TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">
820 <a name="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"></a><h3>TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</h3>
821 <pre class="programlisting">#define TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</pre>
822 <p>
823 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList"</p>
824 <p>
825 </p>
826 </div>
827 <hr>
828 <div class="refsect2" title="TP_IFACE_CHANNEL_DISPATCH_OPERATION">
829 <a name="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS"></a><h3>TP_IFACE_CHANNEL_DISPATCH_OPERATION</h3>
830 <pre class="programlisting">#define TP_IFACE_CHANNEL_DISPATCH_OPERATION</pre>
831 <p>
832 The interface name "org.freedesktop.Telepathy.ChannelDispatchOperation"</p>
833 <p>
834 </p>
835 </div>
836 <hr>
837 <div class="refsect2" title="TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION">
838 <a name="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS"></a><h3>TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</h3>
839 <pre class="programlisting">#define TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</pre>
840 <p>
841 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatchOperation"</p>
842 <p>
843 </p>
844 </div>
845 <hr>
846 <div class="refsect2" title="TP_IFACE_CHANNEL_REQUEST">
847 <a name="TP-IFACE-CHANNEL-REQUEST--CAPS"></a><h3>TP_IFACE_CHANNEL_REQUEST</h3>
848 <pre class="programlisting">#define TP_IFACE_CHANNEL_REQUEST</pre>
849 <p>
850 The interface name "org.freedesktop.Telepathy.ChannelRequest"</p>
851 <p>
852 </p>
853 </div>
854 <hr>
855 <div class="refsect2" title="TP_IFACE_QUARK_CHANNEL_REQUEST">
856 <a name="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS"></a><h3>TP_IFACE_QUARK_CHANNEL_REQUEST</h3>
857 <pre class="programlisting">#define TP_IFACE_QUARK_CHANNEL_REQUEST</pre>
858 <p>
859 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelRequest"</p>
860 <p>
861 </p>
862 </div>
863 <hr>
714864 <div class="refsect2" title="TP_IFACE_MEDIA_SESSION_HANDLER">
715865 <a name="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS"></a><h3>TP_IFACE_MEDIA_SESSION_HANDLER</h3>
716866 <pre class="programlisting">#define TP_IFACE_MEDIA_SESSION_HANDLER</pre>
764914 <p>
765915 </p>
766916 </div>
917 <hr>
918 <div class="refsect2" title="TP_IFACE_CLIENT">
919 <a name="TP-IFACE-CLIENT--CAPS"></a><h3>TP_IFACE_CLIENT</h3>
920 <pre class="programlisting">#define TP_IFACE_CLIENT</pre>
921 <p>
922 The interface name "org.freedesktop.Telepathy.Client"</p>
923 <p>
924 </p>
925 </div>
926 <hr>
927 <div class="refsect2" title="TP_IFACE_QUARK_CLIENT">
928 <a name="TP-IFACE-QUARK-CLIENT--CAPS"></a><h3>TP_IFACE_QUARK_CLIENT</h3>
929 <pre class="programlisting">#define TP_IFACE_QUARK_CLIENT</pre>
930 <p>
931 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client"</p>
932 <p>
933 </p>
934 </div>
935 <hr>
936 <div class="refsect2" title="TP_IFACE_CLIENT_APPROVER">
937 <a name="TP-IFACE-CLIENT-APPROVER--CAPS"></a><h3>TP_IFACE_CLIENT_APPROVER</h3>
938 <pre class="programlisting">#define TP_IFACE_CLIENT_APPROVER</pre>
939 <p>
940 The interface name "org.freedesktop.Telepathy.Client.Approver"</p>
941 <p>
942 </p>
943 </div>
944 <hr>
945 <div class="refsect2" title="TP_IFACE_QUARK_CLIENT_APPROVER">
946 <a name="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS"></a><h3>TP_IFACE_QUARK_CLIENT_APPROVER</h3>
947 <pre class="programlisting">#define TP_IFACE_QUARK_CLIENT_APPROVER</pre>
948 <p>
949 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Approver"</p>
950 <p>
951 </p>
952 </div>
953 <hr>
954 <div class="refsect2" title="TP_IFACE_CLIENT_HANDLER">
955 <a name="TP-IFACE-CLIENT-HANDLER--CAPS"></a><h3>TP_IFACE_CLIENT_HANDLER</h3>
956 <pre class="programlisting">#define TP_IFACE_CLIENT_HANDLER</pre>
957 <p>
958 The interface name "org.freedesktop.Telepathy.Client.Handler"</p>
959 <p>
960 </p>
961 </div>
962 <hr>
963 <div class="refsect2" title="TP_IFACE_QUARK_CLIENT_HANDLER">
964 <a name="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS"></a><h3>TP_IFACE_QUARK_CLIENT_HANDLER</h3>
965 <pre class="programlisting">#define TP_IFACE_QUARK_CLIENT_HANDLER</pre>
966 <p>
967 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Handler"</p>
968 <p>
969 </p>
970 </div>
971 <hr>
972 <div class="refsect2" title="TP_IFACE_CLIENT_OBSERVER">
973 <a name="TP-IFACE-CLIENT-OBSERVER--CAPS"></a><h3>TP_IFACE_CLIENT_OBSERVER</h3>
974 <pre class="programlisting">#define TP_IFACE_CLIENT_OBSERVER</pre>
975 <p>
976 The interface name "org.freedesktop.Telepathy.Client.Observer"</p>
977 <p>
978 </p>
979 </div>
980 <hr>
981 <div class="refsect2" title="TP_IFACE_QUARK_CLIENT_OBSERVER">
982 <a name="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS"></a><h3>TP_IFACE_QUARK_CLIENT_OBSERVER</h3>
983 <pre class="programlisting">#define TP_IFACE_QUARK_CLIENT_OBSERVER</pre>
984 <p>
985 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Observer"</p>
986 <p>
987 </p>
988 </div>
989 <hr>
990 <div class="refsect2" title="TP_IFACE_CLIENT_INTERFACE_REQUESTS">
991 <a name="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS"></a><h3>TP_IFACE_CLIENT_INTERFACE_REQUESTS</h3>
992 <pre class="programlisting">#define TP_IFACE_CLIENT_INTERFACE_REQUESTS</pre>
993 <p>
994 The interface name "org.freedesktop.Telepathy.Client.Interface.Requests"</p>
995 <p>
996 </p>
997 </div>
998 <hr>
999 <div class="refsect2" title="TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS">
1000 <a name="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS"></a><h3>TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</h3>
1001 <pre class="programlisting">#define TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</pre>
1002 <p>
1003 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Interface.Requests"</p>
1004 <p>
1005 </p>
1006 </div>
7671007 </div>
7681008 </div>
7691009 <div class="footer">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpMediaSessionHandler, TpMediaStreamHandler</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-client.html" title="Client-side proxies">
88 <link rel="prev" href="telepathy-glib-channel-roomlist.html" title="Room List channels">
9 <link rel="next" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
9 <link rel="next" href="telepathy-glib-account-manager.html" title="TpAccountManager">
1010 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
1111 <link rel="stylesheet" href="style.css" type="text/css">
1212 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
2424 <td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
2525 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
2626 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="ch-service-dbus.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
27 <td><a accesskey="n" href="telepathy-glib-account-manager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
2828 </tr>
2929 <tr><td colspan="5" class="shortcuts">
3030 <a href="#telepathy-glib-media-interfaces.synopsis" class="shortcut">Top</a>
5959 <a
6060 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
6161 >GError</a> **error);
62 void <a class="link" href="telepathy-glib-media-interfaces.html#tp-media-session-handler-init-known-interfaces" title="tp_media_session_handler_init_known_interfaces ()">tp_media_session_handler_init_known_interfaces</a>
63 (void);
6264 <a class="link" href="telepathy-glib-media-interfaces.html#TpMediaSessionHandler-struct" title="TpMediaSessionHandler">TpMediaSessionHandler</a>;
6365 <a class="link" href="telepathy-glib-media-interfaces.html#TpMediaSessionHandlerClass" title="TpMediaSessionHandlerClass">TpMediaSessionHandlerClass</a>;
6466
7274 <a
7375 href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
7476 >GError</a> **error);
77 void <a class="link" href="telepathy-glib-media-interfaces.html#tp-media-stream-handler-init-known-interfaces" title="tp_media_stream_handler_init_known_interfaces ()">tp_media_stream_handler_init_known_interfaces</a>
78 (void);
7579 <a class="link" href="telepathy-glib-media-interfaces.html#TpMediaStreamHandler-struct" title="TpMediaStreamHandler">TpMediaStreamHandler</a>;
7680 <a class="link" href="telepathy-glib-media-interfaces.html#TpMediaStreamHandlerClass" title="TpMediaStreamHandlerClass">TpMediaStreamHandlerClass</a>;
7781
11231127 <p class="since">Since 0.7.1</p>
11241128 </div>
11251129 <hr>
1130 <div class="refsect2" title="tp_media_session_handler_init_known_interfaces ()">
1131 <a name="tp-media-session-handler-init-known-interfaces"></a><h3>tp_media_session_handler_init_known_interfaces ()</h3>
1132 <pre class="programlisting">void tp_media_session_handler_init_known_interfaces
1133 (void);</pre>
1134 <p>
1135 Ensure that the known interfaces for TpMediaSessionHandler have been set up.
1136 This is done automatically when necessary, but for correct
1137 overriding of library interfaces by local extensions, you should
1138 call this function before calling
1139 <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
1140 <code class="literal">TP_TYPE_MEDIA_SESSION_HANDLER</code>.</p>
1141 <p>
1142 </p>
1143 <p class="since">Since 0.7.UNRELEASED</p>
1144 </div>
1145 <hr>
11261146 <div class="refsect2" title="TpMediaSessionHandler">
11271147 <a name="TpMediaSessionHandler-struct"></a><h3>TpMediaSessionHandler</h3>
11281148 <pre class="programlisting">typedef struct _TpMediaSessionHandler TpMediaSessionHandler;</pre>
12021222 </tbody>
12031223 </table></div>
12041224 <p class="since">Since 0.7.1</p>
1225 </div>
1226 <hr>
1227 <div class="refsect2" title="tp_media_stream_handler_init_known_interfaces ()">
1228 <a name="tp-media-stream-handler-init-known-interfaces"></a><h3>tp_media_stream_handler_init_known_interfaces ()</h3>
1229 <pre class="programlisting">void tp_media_stream_handler_init_known_interfaces
1230 (void);</pre>
1231 <p>
1232 Ensure that the known interfaces for TpMediaStreamHandler have been set up.
1233 This is done automatically when necessary, but for correct
1234 overriding of library interfaces by local extensions, you should
1235 call this function before calling
1236 <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
1237 <code class="literal">TP_TYPE_MEDIA_STREAM_HANDLER</code>.</p>
1238 <p>
1239 </p>
1240 <p class="since">Since 0.7.UNRELEASED</p>
12051241 </div>
12061242 <hr>
12071243 <div class="refsect2" title="TpMediaStreamHandler">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpProxy D-Bus core methods</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="telepathy-glib-proxy.html" title="TpProxy">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpProxy subclasses and mixins</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="telepathy-glib-asv.html" title="Manipulating a{sv} mappings">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpProxy Telepathy Properties</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="telepathy-glib-proxy-dbus-core.html" title="TpProxy D-Bus core methods">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>TpProxy</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-dbus.html" title="General D-Bus support">
88 <link rel="prev" href="ch-dbus.html" title="General D-Bus support">
111111 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
112112 >GObject</a>
113113 +----TpProxy
114 +----<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a>
115 +----<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a>
114116 +----<a class="link" href="telepathy-glib-channel.html#TpChannel">TpChannel</a>
117 +----<a class="link" href="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher">TpChannelDispatcher</a>
118 +----<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation">TpChannelDispatchOperation</a>
119 +----<a class="link" href="telepathy-glib-channel-request.html#TpChannelRequest">TpChannelRequest</a>
120 +----<a class="link" href="telepathy-glib-client.html#TpClient">TpClient</a>
115121 +----<a class="link" href="telepathy-glib-connection.html#TpConnection">TpConnection</a>
116122 +----<a class="link" href="telepathy-glib-connection-manager.html#TpConnectionManager">TpConnectionManager</a>
117123 +----<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon">TpDBusDaemon</a>
391397 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
392398 ><code class="literal">NULL</code></a> if this object is itself a <a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a>. The caller must
393399 reference the returned object with <a
394 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
400 href="../libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
395401 ><code class="function">g_object_ref()</code></a> if it will be kept.
396402
397403 </td>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Connection manager life cycle</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-base.html" title="Service-side implementation">
88 <link rel="prev" href="ch-service-base.html" title="Service-side implementation">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Account Manager interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-connection-manager.html" title="Service-side Connection Manager interface">
9 <link rel="next" href="telepathy-glib-svc-account.html" title="Service-side Account interfaces">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-connection-manager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-svc-account.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-account-manager.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-account-manager.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-account-manager.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-svc-account-manager.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="Service-side Account Manager interface">
40 <a name="telepathy-glib-svc-account-manager"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-account-manager.top_of_page"></a>Service-side Account Manager interface</span></h2>
44 <p>Service-side Account Manager interface — GInterface for Telepathy AccountManager objects</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv" title="Synopsis">
49 <a name="telepathy-glib-svc-account-manager.synopsis"></a><h2>Synopsis</h2>
50 <a name="TpSvcAccountManager"></a><pre class="synopsis">
51
52 #include &lt;telepathy-glib/svc-account-manager.h&gt;
53
54 <a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-struct" title="TpSvcAccountManager">TpSvcAccountManager</a>;
55 <a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass" title="TpSvcAccountManagerClass">TpSvcAccountManagerClass</a>;
56 void <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-removed" title="tp_svc_account_manager_emit_account_removed ()">tp_svc_account_manager_emit_account_removed</a>
57 (<a
58 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
59 >gpointer</a> instance,
60 const <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
62 >gchar</a> *arg_Account);
63 void <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-validity-changed" title="tp_svc_account_manager_emit_account_validity_changed ()">tp_svc_account_manager_emit_account_validity_changed</a>
64 (<a
65 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
66 >gpointer</a> instance,
67 const <a
68 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
69 >gchar</a> *arg_Account,
70 <a
71 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
72 >gboolean</a> arg_Valid);
73 void (<a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl" title="tp_svc_account_manager_create_account_impl ()">*tp_svc_account_manager_create_account_impl</a>)
74 (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager">TpSvcAccountManager</a> *self,
75 const <a
76 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
77 >gchar</a> *in_Connection_Manager,
78 const <a
79 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
80 >gchar</a> *in_Protocol,
81 const <a
82 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
83 >gchar</a> *in_Display_Name,
84 <a
85 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
86 >GHashTable</a> *in_Parameters,
87 <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
89 >GHashTable</a> *in_Properties,
90 <a
91 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
92 >DBusGMethodInvocation</a> *context);
93 void <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-return-from-create-account" title="tp_svc_account_manager_return_from_create_account ()">tp_svc_account_manager_return_from_create_account</a>
94 (<a
95 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
96 >DBusGMethodInvocation</a> *context,
97 const <a
98 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
99 >gchar</a> *out_Account);
100 void <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-implement-create-account" title="tp_svc_account_manager_implement_create_account ()">tp_svc_account_manager_implement_create_account</a>
101 (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass" title="TpSvcAccountManagerClass">TpSvcAccountManagerClass</a> *klass,
102 <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl" title="tp_svc_account_manager_create_account_impl ()">tp_svc_account_manager_create_account_impl</a> impl);
103 </pre>
104 </div>
105 <div class="refsect1" title="Object Hierarchy">
106 <a name="telepathy-glib-svc-account-manager.object-hierarchy"></a><h2>Object Hierarchy</h2>
107 <pre class="synopsis">
108 GInterface
109 +----TpSvcAccountManager
110 </pre>
111 </div>
112 <div class="refsect1" title="Signals">
113 <a name="telepathy-glib-svc-account-manager.signals"></a><h2>Signals</h2>
114 <pre class="synopsis">
115 "<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-removed" title='The "account-removed" signal'>account-removed</a>" : Run Last / Has Details
116 "<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-validity-changed" title='The "account-validity-changed" signal'>account-validity-changed</a>" : Run Last / Has Details
117 </pre>
118 </div>
119 <div class="refsect1" title="Description">
120 <a name="telepathy-glib-svc-account-manager.description"></a><h2>Description</h2>
121 <p>
122 The <a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager"><span class="type">TpSvcAccountManager</span></a> interface (auto-generated from the Telepathy
123 spec) makes it easier to export an object implementing the Telepathy
124 AccountManager interface, with the correct method and signal signatures,
125 and emit signals from that object in a type-safe way.
126 </p>
127 <p>
128 You don't need these interfaces unless you're implementing a
129 Telepathy AccountManager, such as Mission Control.</p>
130 <p>
131 </p>
132 </div>
133 <div class="refsect1" title="Details">
134 <a name="telepathy-glib-svc-account-manager.details"></a><h2>Details</h2>
135 <div class="refsect2" title="TpSvcAccountManager">
136 <a name="TpSvcAccountManager-struct"></a><h3>TpSvcAccountManager</h3>
137 <pre class="programlisting">typedef struct _TpSvcAccountManager TpSvcAccountManager;</pre>
138 <p>
139 Dummy typedef representing any implementation of this interface.</p>
140 <p>
141 </p>
142 </div>
143 <hr>
144 <div class="refsect2" title="TpSvcAccountManagerClass">
145 <a name="TpSvcAccountManagerClass"></a><h3>TpSvcAccountManagerClass</h3>
146 <pre class="programlisting">typedef struct _TpSvcAccountManagerClass TpSvcAccountManagerClass;</pre>
147 <p>
148 The class of TpSvcAccountManager.</p>
149 <p>
150 </p>
151 </div>
152 <hr>
153 <div class="refsect2" title="tp_svc_account_manager_emit_account_removed ()">
154 <a name="tp-svc-account-manager-emit-account-removed"></a><h3>tp_svc_account_manager_emit_account_removed ()</h3>
155 <pre class="programlisting">void tp_svc_account_manager_emit_account_removed
156 (<a
157 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
158 >gpointer</a> instance,
159 const <a
160 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
161 >gchar</a> *arg_Account);</pre>
162 <p>
163 Type-safe wrapper around g_signal_emit to emit the
164 AccountRemoved signal on interface org.freedesktop.Telepathy.AccountManager.</p>
165 <p>
166 </p>
167 <div class="variablelist"><table border="0">
168 <col align="left" valign="top">
169 <tbody>
170 <tr>
171 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
172 <td> The object implementing this interface
173 </td>
174 </tr>
175 <tr>
176 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
177 <td> const gchar * (FIXME, generate documentation)
178 </td>
179 </tr>
180 </tbody>
181 </table></div>
182 </div>
183 <hr>
184 <div class="refsect2" title="tp_svc_account_manager_emit_account_validity_changed ()">
185 <a name="tp-svc-account-manager-emit-account-validity-changed"></a><h3>tp_svc_account_manager_emit_account_validity_changed ()</h3>
186 <pre class="programlisting">void tp_svc_account_manager_emit_account_validity_changed
187 (<a
188 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
189 >gpointer</a> instance,
190 const <a
191 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
192 >gchar</a> *arg_Account,
193 <a
194 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
195 >gboolean</a> arg_Valid);</pre>
196 <p>
197 Type-safe wrapper around g_signal_emit to emit the
198 AccountValidityChanged signal on interface org.freedesktop.Telepathy.AccountManager.</p>
199 <p>
200 </p>
201 <div class="variablelist"><table border="0">
202 <col align="left" valign="top">
203 <tbody>
204 <tr>
205 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
206 <td> The object implementing this interface
207 </td>
208 </tr>
209 <tr>
210 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
211 <td> const gchar * (FIXME, generate documentation)
212 </td>
213 </tr>
214 <tr>
215 <td><p><span class="term"><em class="parameter"><code>arg_Valid</code></em> :</span></p></td>
216 <td> gboolean (FIXME, generate documentation)
217 </td>
218 </tr>
219 </tbody>
220 </table></div>
221 </div>
222 <hr>
223 <div class="refsect2" title="tp_svc_account_manager_create_account_impl ()">
224 <a name="tp-svc-account-manager-create-account-impl"></a><h3>tp_svc_account_manager_create_account_impl ()</h3>
225 <pre class="programlisting">void (*tp_svc_account_manager_create_account_impl)
226 (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager">TpSvcAccountManager</a> *self,
227 const <a
228 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
229 >gchar</a> *in_Connection_Manager,
230 const <a
231 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
232 >gchar</a> *in_Protocol,
233 const <a
234 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
235 >gchar</a> *in_Display_Name,
236 <a
237 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
238 >GHashTable</a> *in_Parameters,
239 <a
240 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
241 >GHashTable</a> *in_Properties,
242 <a
243 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
244 >DBusGMethodInvocation</a> *context);</pre>
245 <p>
246 The signature of an implementation of the D-Bus method
247 CreateAccount on interface org.freedesktop.Telepathy.AccountManager.</p>
248 <p>
249 </p>
250 <div class="variablelist"><table border="0">
251 <col align="left" valign="top">
252 <tbody>
253 <tr>
254 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
255 <td> The object implementing this interface
256 </td>
257 </tr>
258 <tr>
259 <td><p><span class="term"><em class="parameter"><code>in_Connection_Manager</code></em> :</span></p></td>
260 <td> const gchar * (FIXME, generate documentation)
261 </td>
262 </tr>
263 <tr>
264 <td><p><span class="term"><em class="parameter"><code>in_Protocol</code></em> :</span></p></td>
265 <td> const gchar * (FIXME, generate documentation)
266 </td>
267 </tr>
268 <tr>
269 <td><p><span class="term"><em class="parameter"><code>in_Display_Name</code></em> :</span></p></td>
270 <td> const gchar * (FIXME, generate documentation)
271 </td>
272 </tr>
273 <tr>
274 <td><p><span class="term"><em class="parameter"><code>in_Parameters</code></em> :</span></p></td>
275 <td> GHashTable * (FIXME, generate documentation)
276 </td>
277 </tr>
278 <tr>
279 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
280 <td> GHashTable * (FIXME, generate documentation)
281 </td>
282 </tr>
283 <tr>
284 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
285 <td> Used to return values or throw an error
286 </td>
287 </tr>
288 </tbody>
289 </table></div>
290 </div>
291 <hr>
292 <div class="refsect2" title="tp_svc_account_manager_return_from_create_account ()">
293 <a name="tp-svc-account-manager-return-from-create-account"></a><h3>tp_svc_account_manager_return_from_create_account ()</h3>
294 <pre class="programlisting">void tp_svc_account_manager_return_from_create_account
295 (<a
296 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
297 >DBusGMethodInvocation</a> *context,
298 const <a
299 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
300 >gchar</a> *out_Account);</pre>
301 <p>
302 Return successfully by calling <a
303 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
304 ><code class="function">dbus_g_method_return()</code></a>.
305 This inline function exists only to provide type-safety.</p>
306 <p>
307 </p>
308 <div class="variablelist"><table border="0">
309 <col align="left" valign="top">
310 <tbody>
311 <tr>
312 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
313 <td> The D-Bus method invocation context
314 </td>
315 </tr>
316 <tr>
317 <td><p><span class="term"><em class="parameter"><code>out_Account</code></em> :</span></p></td>
318 <td> const gchar * (FIXME, generate documentation)
319 </td>
320 </tr>
321 </tbody>
322 </table></div>
323 </div>
324 <hr>
325 <div class="refsect2" title="tp_svc_account_manager_implement_create_account ()">
326 <a name="tp-svc-account-manager-implement-create-account"></a><h3>tp_svc_account_manager_implement_create_account ()</h3>
327 <pre class="programlisting">void tp_svc_account_manager_implement_create_account
328 (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass" title="TpSvcAccountManagerClass">TpSvcAccountManagerClass</a> *klass,
329 <a class="link" href="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl" title="tp_svc_account_manager_create_account_impl ()">tp_svc_account_manager_create_account_impl</a> impl);</pre>
330 <p>
331 Register an implementation for the CreateAccount method in the vtable
332 of an implementation of this interface. To be called from
333 the interface init function.</p>
334 <p>
335 </p>
336 <div class="variablelist"><table border="0">
337 <col align="left" valign="top">
338 <tbody>
339 <tr>
340 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
341 <td> A class whose instances implement this interface
342 </td>
343 </tr>
344 <tr>
345 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
346 <td> A callback used to implement the CreateAccount D-Bus method
347 </td>
348 </tr>
349 </tbody>
350 </table></div>
351 </div>
352 </div>
353 <div class="refsect1" title="Signal Details">
354 <a name="telepathy-glib-svc-account-manager.signal-details"></a><h2>Signal Details</h2>
355 <div class="refsect2" title='The "account-removed" signal'>
356 <a name="TpSvcAccountManager-account-removed"></a><h3>The <code class="literal">"account-removed"</code> signal</h3>
357 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager">TpSvcAccountManager</a> *arg_Account,
358 DBusGObjectPath *arg1,
359 <a
360 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
361 >gpointer</a> user_data) : Run Last / Has Details</pre>
362 <p>
363 The AccountRemoved D-Bus signal is emitted whenever this GObject signal is.</p>
364 <p>
365 </p>
366 <div class="variablelist"><table border="0">
367 <col align="left" valign="top">
368 <tbody>
369 <tr>
370 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
371 <td> const gchar * (FIXME, generate documentation)
372 </td>
373 </tr>
374 <tr>
375 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
376 <td>user data set when the signal handler was connected.</td>
377 </tr>
378 </tbody>
379 </table></div>
380 </div>
381 <hr>
382 <div class="refsect2" title='The "account-validity-changed" signal'>
383 <a name="TpSvcAccountManager-account-validity-changed"></a><h3>The <code class="literal">"account-validity-changed"</code> signal</h3>
384 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-account-manager.html#TpSvcAccountManager">TpSvcAccountManager</a> *arg_Account,
385 DBusGObjectPath *arg_Valid,
386 <a
387 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
388 >gboolean</a> arg2,
389 <a
390 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
391 >gpointer</a> user_data) : Run Last / Has Details</pre>
392 <p>
393 The AccountValidityChanged D-Bus signal is emitted whenever this GObject signal is.</p>
394 <p>
395 </p>
396 <div class="variablelist"><table border="0">
397 <col align="left" valign="top">
398 <tbody>
399 <tr>
400 <td><p><span class="term"><em class="parameter"><code>arg_Account</code></em> :</span></p></td>
401 <td> const gchar * (FIXME, generate documentation)
402 </td>
403 </tr>
404 <tr>
405 <td><p><span class="term"><em class="parameter"><code>arg_Valid</code></em> :</span></p></td>
406 <td> gboolean (FIXME, generate documentation)
407 </td>
408 </tr>
409 <tr>
410 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
411 <td>user data set when the signal handler was connected.</td>
412 </tr>
413 </tbody>
414 </table></div>
415 </div>
416 </div>
417 </div>
418 <div class="footer">
419 <hr>
420 Generated by GTK-Doc V1.11</div>
421 </body>
422 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Account interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-account-manager.html" title="Service-side Account Manager interface">
9 <link rel="next" href="telepathy-glib-svc-channel-dispatcher.html" title="Service-side Channel Dispatcher interface">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-account-manager.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-svc-channel-dispatcher.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-account.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-account.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-account.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-svc-account.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="Service-side Account interfaces">
40 <a name="telepathy-glib-svc-account"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-account.top_of_page"></a>Service-side Account interfaces</span></h2>
44 <p>Service-side Account interfaces — GInterfaces for Telepathy Account objects</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv" title="Synopsis">
49 <a name="telepathy-glib-svc-account.synopsis"></a><h2>Synopsis</h2>
50 <a name="TpSvcAccount"></a><a name="TpSvcAccountInterfaceAvatar"></a><pre class="synopsis">
51
52 #include &lt;telepathy-glib/svc-account.h&gt;
53
54 <a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount-struct" title="TpSvcAccount">TpSvcAccount</a>;
55 <a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a>;
56 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-emit-account-property-changed" title="tp_svc_account_emit_account_property_changed ()">tp_svc_account_emit_account_property_changed</a>
57 (<a
58 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
59 >gpointer</a> instance,
60 <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
62 >GHashTable</a> *arg_Properties);
63 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-emit-removed" title="tp_svc_account_emit_removed ()">tp_svc_account_emit_removed</a> (<a
64 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
65 >gpointer</a> instance);
66 void (<a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl" title="tp_svc_account_reconnect_impl ()">*tp_svc_account_reconnect_impl</a>) (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
67 <a
68 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
69 >DBusGMethodInvocation</a> *context);
70 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-return-from-reconnect" title="tp_svc_account_return_from_reconnect ()">tp_svc_account_return_from_reconnect</a>
71 (<a
72 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
73 >DBusGMethodInvocation</a> *context);
74 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-implement-reconnect" title="tp_svc_account_implement_reconnect ()">tp_svc_account_implement_reconnect</a> (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
75 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl" title="tp_svc_account_reconnect_impl ()">tp_svc_account_reconnect_impl</a> impl);
76 void (<a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-remove-impl" title="tp_svc_account_remove_impl ()">*tp_svc_account_remove_impl</a>) (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
77 <a
78 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
79 >DBusGMethodInvocation</a> *context);
80 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-return-from-remove" title="tp_svc_account_return_from_remove ()">tp_svc_account_return_from_remove</a> (<a
81 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
82 >DBusGMethodInvocation</a> *context);
83 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-implement-remove" title="tp_svc_account_implement_remove ()">tp_svc_account_implement_remove</a> (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
84 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-remove-impl" title="tp_svc_account_remove_impl ()">tp_svc_account_remove_impl</a> impl);
85 void (<a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl" title="tp_svc_account_update_parameters_impl ()">*tp_svc_account_update_parameters_impl</a>)
86 (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
87 <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
89 >GHashTable</a> *in_Set,
90 const <a
91 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
92 >gchar</a> **in_Unset,
93 <a
94 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
95 >DBusGMethodInvocation</a> *context);
96 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-return-from-update-parameters" title="tp_svc_account_return_from_update_parameters ()">tp_svc_account_return_from_update_parameters</a>
97 (<a
98 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
99 >DBusGMethodInvocation</a> *context,
100 const <a
101 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
102 >gchar</a> **out_Reconnect_Required);
103 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-implement-update-parameters" title="tp_svc_account_implement_update_parameters ()">tp_svc_account_implement_update_parameters</a>
104 (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
105 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl" title="tp_svc_account_update_parameters_impl ()">tp_svc_account_update_parameters_impl</a> impl);
106
107
108 <a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct" title="TpSvcAccountInterfaceAvatar">TpSvcAccountInterfaceAvatar</a>;
109 <a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass" title="TpSvcAccountInterfaceAvatarClass">TpSvcAccountInterfaceAvatarClass</a>;
110 void <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed" title="tp_svc_account_interface_avatar_emit_avatar_changed ()">tp_svc_account_interface_avatar_emit_avatar_changed</a>
111 (<a
112 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
113 >gpointer</a> instance);
114 </pre>
115 </div>
116 <div class="refsect1" title="Object Hierarchy">
117 <a name="telepathy-glib-svc-account.object-hierarchy"></a><h2>Object Hierarchy</h2>
118 <pre class="synopsis">
119 GInterface
120 +----TpSvcAccount
121 </pre>
122 <pre class="synopsis">
123 GInterface
124 +----TpSvcAccountInterfaceAvatar
125 </pre>
126 </div>
127 <div class="refsect1" title="Signals">
128 <a name="telepathy-glib-svc-account.signals"></a><h2>Signals</h2>
129 <pre class="synopsis">
130 "<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed" title='The "account-property-changed" signal'>account-property-changed</a>" : Run Last / Has Details
131 "<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount-removed" title='The "removed" signal'>removed</a>" : Run Last / Has Details
132 "<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed" title='The "avatar-changed" signal'>avatar-changed</a>" : Run Last / Has Details
133 </pre>
134 </div>
135 <div class="refsect1" title="Description">
136 <a name="telepathy-glib-svc-account.description"></a><h2>Description</h2>
137 <p>
138 These interfaces (auto-generated from the Telepathy spec) make it easier
139 to export objects implementing the Telepathy Account and its
140 optional interfaces, with the correct method and signal signatures,
141 and emit signals from those objects in a type-safe way.
142 </p>
143 <p>
144 You don't need these interfaces unless you're implementing a
145 Telepathy AccountManager, such as Mission Control.</p>
146 <p>
147 </p>
148 </div>
149 <div class="refsect1" title="Details">
150 <a name="telepathy-glib-svc-account.details"></a><h2>Details</h2>
151 <div class="refsect2" title="TpSvcAccount">
152 <a name="TpSvcAccount-struct"></a><h3>TpSvcAccount</h3>
153 <pre class="programlisting">typedef struct _TpSvcAccount TpSvcAccount;</pre>
154 <p>
155 Dummy typedef representing any implementation of this interface.</p>
156 <p>
157 </p>
158 </div>
159 <hr>
160 <div class="refsect2" title="TpSvcAccountClass">
161 <a name="TpSvcAccountClass"></a><h3>TpSvcAccountClass</h3>
162 <pre class="programlisting">typedef struct _TpSvcAccountClass TpSvcAccountClass;</pre>
163 <p>
164 The class of TpSvcAccount.</p>
165 <p>
166 </p>
167 </div>
168 <hr>
169 <div class="refsect2" title="tp_svc_account_emit_account_property_changed ()">
170 <a name="tp-svc-account-emit-account-property-changed"></a><h3>tp_svc_account_emit_account_property_changed ()</h3>
171 <pre class="programlisting">void tp_svc_account_emit_account_property_changed
172 (<a
173 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
174 >gpointer</a> instance,
175 <a
176 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
177 >GHashTable</a> *arg_Properties);</pre>
178 <p>
179 Type-safe wrapper around g_signal_emit to emit the
180 AccountPropertyChanged signal on interface org.freedesktop.Telepathy.Account.</p>
181 <p>
182 </p>
183 <div class="variablelist"><table border="0">
184 <col align="left" valign="top">
185 <tbody>
186 <tr>
187 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
188 <td> The object implementing this interface
189 </td>
190 </tr>
191 <tr>
192 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
193 <td> GHashTable * (FIXME, generate documentation)
194 </td>
195 </tr>
196 </tbody>
197 </table></div>
198 </div>
199 <hr>
200 <div class="refsect2" title="tp_svc_account_emit_removed ()">
201 <a name="tp-svc-account-emit-removed"></a><h3>tp_svc_account_emit_removed ()</h3>
202 <pre class="programlisting">void tp_svc_account_emit_removed (<a
203 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
204 >gpointer</a> instance);</pre>
205 <p>
206 Type-safe wrapper around g_signal_emit to emit the
207 Removed signal on interface org.freedesktop.Telepathy.Account.</p>
208 <p>
209 </p>
210 <div class="variablelist"><table border="0">
211 <col align="left" valign="top">
212 <tbody><tr>
213 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
214 <td> The object implementing this interface
215 </td>
216 </tr></tbody>
217 </table></div>
218 </div>
219 <hr>
220 <div class="refsect2" title="tp_svc_account_reconnect_impl ()">
221 <a name="tp-svc-account-reconnect-impl"></a><h3>tp_svc_account_reconnect_impl ()</h3>
222 <pre class="programlisting">void (*tp_svc_account_reconnect_impl) (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
223 <a
224 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
225 >DBusGMethodInvocation</a> *context);</pre>
226 <p>
227 The signature of an implementation of the D-Bus method
228 Reconnect on interface org.freedesktop.Telepathy.Account.</p>
229 <p>
230 </p>
231 <div class="variablelist"><table border="0">
232 <col align="left" valign="top">
233 <tbody>
234 <tr>
235 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
236 <td> The object implementing this interface
237 </td>
238 </tr>
239 <tr>
240 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
241 <td> Used to return values or throw an error
242 </td>
243 </tr>
244 </tbody>
245 </table></div>
246 </div>
247 <hr>
248 <div class="refsect2" title="tp_svc_account_return_from_reconnect ()">
249 <a name="tp-svc-account-return-from-reconnect"></a><h3>tp_svc_account_return_from_reconnect ()</h3>
250 <pre class="programlisting">void tp_svc_account_return_from_reconnect
251 (<a
252 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
253 >DBusGMethodInvocation</a> *context);</pre>
254 <p>
255 Return successfully by calling <a
256 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
257 ><code class="function">dbus_g_method_return()</code></a>.
258 This inline function exists only to provide type-safety.</p>
259 <p>
260 </p>
261 <div class="variablelist"><table border="0">
262 <col align="left" valign="top">
263 <tbody><tr>
264 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
265 <td> The D-Bus method invocation context
266 </td>
267 </tr></tbody>
268 </table></div>
269 </div>
270 <hr>
271 <div class="refsect2" title="tp_svc_account_implement_reconnect ()">
272 <a name="tp-svc-account-implement-reconnect"></a><h3>tp_svc_account_implement_reconnect ()</h3>
273 <pre class="programlisting">void tp_svc_account_implement_reconnect (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
274 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl" title="tp_svc_account_reconnect_impl ()">tp_svc_account_reconnect_impl</a> impl);</pre>
275 <p>
276 Register an implementation for the Reconnect method in the vtable
277 of an implementation of this interface. To be called from
278 the interface init function.</p>
279 <p>
280 </p>
281 <div class="variablelist"><table border="0">
282 <col align="left" valign="top">
283 <tbody>
284 <tr>
285 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
286 <td> A class whose instances implement this interface
287 </td>
288 </tr>
289 <tr>
290 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
291 <td> A callback used to implement the Reconnect D-Bus method
292 </td>
293 </tr>
294 </tbody>
295 </table></div>
296 </div>
297 <hr>
298 <div class="refsect2" title="tp_svc_account_remove_impl ()">
299 <a name="tp-svc-account-remove-impl"></a><h3>tp_svc_account_remove_impl ()</h3>
300 <pre class="programlisting">void (*tp_svc_account_remove_impl) (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
301 <a
302 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
303 >DBusGMethodInvocation</a> *context);</pre>
304 <p>
305 The signature of an implementation of the D-Bus method
306 Remove on interface org.freedesktop.Telepathy.Account.</p>
307 <p>
308 </p>
309 <div class="variablelist"><table border="0">
310 <col align="left" valign="top">
311 <tbody>
312 <tr>
313 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
314 <td> The object implementing this interface
315 </td>
316 </tr>
317 <tr>
318 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
319 <td> Used to return values or throw an error
320 </td>
321 </tr>
322 </tbody>
323 </table></div>
324 </div>
325 <hr>
326 <div class="refsect2" title="tp_svc_account_return_from_remove ()">
327 <a name="tp-svc-account-return-from-remove"></a><h3>tp_svc_account_return_from_remove ()</h3>
328 <pre class="programlisting">void tp_svc_account_return_from_remove (<a
329 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
330 >DBusGMethodInvocation</a> *context);</pre>
331 <p>
332 Return successfully by calling <a
333 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
334 ><code class="function">dbus_g_method_return()</code></a>.
335 This inline function exists only to provide type-safety.</p>
336 <p>
337 </p>
338 <div class="variablelist"><table border="0">
339 <col align="left" valign="top">
340 <tbody><tr>
341 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
342 <td> The D-Bus method invocation context
343 </td>
344 </tr></tbody>
345 </table></div>
346 </div>
347 <hr>
348 <div class="refsect2" title="tp_svc_account_implement_remove ()">
349 <a name="tp-svc-account-implement-remove"></a><h3>tp_svc_account_implement_remove ()</h3>
350 <pre class="programlisting">void tp_svc_account_implement_remove (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
351 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-remove-impl" title="tp_svc_account_remove_impl ()">tp_svc_account_remove_impl</a> impl);</pre>
352 <p>
353 Register an implementation for the Remove method in the vtable
354 of an implementation of this interface. To be called from
355 the interface init function.</p>
356 <p>
357 </p>
358 <div class="variablelist"><table border="0">
359 <col align="left" valign="top">
360 <tbody>
361 <tr>
362 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
363 <td> A class whose instances implement this interface
364 </td>
365 </tr>
366 <tr>
367 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
368 <td> A callback used to implement the Remove D-Bus method
369 </td>
370 </tr>
371 </tbody>
372 </table></div>
373 </div>
374 <hr>
375 <div class="refsect2" title="tp_svc_account_update_parameters_impl ()">
376 <a name="tp-svc-account-update-parameters-impl"></a><h3>tp_svc_account_update_parameters_impl ()</h3>
377 <pre class="programlisting">void (*tp_svc_account_update_parameters_impl)
378 (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *self,
379 <a
380 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
381 >GHashTable</a> *in_Set,
382 const <a
383 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
384 >gchar</a> **in_Unset,
385 <a
386 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
387 >DBusGMethodInvocation</a> *context);</pre>
388 <p>
389 The signature of an implementation of the D-Bus method
390 UpdateParameters on interface org.freedesktop.Telepathy.Account.</p>
391 <p>
392 </p>
393 <div class="variablelist"><table border="0">
394 <col align="left" valign="top">
395 <tbody>
396 <tr>
397 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
398 <td> The object implementing this interface
399 </td>
400 </tr>
401 <tr>
402 <td><p><span class="term"><em class="parameter"><code>in_Set</code></em> :</span></p></td>
403 <td> GHashTable * (FIXME, generate documentation)
404 </td>
405 </tr>
406 <tr>
407 <td><p><span class="term"><em class="parameter"><code>in_Unset</code></em> :</span></p></td>
408 <td> const gchar ** (FIXME, generate documentation)
409 </td>
410 </tr>
411 <tr>
412 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
413 <td> Used to return values or throw an error
414 </td>
415 </tr>
416 </tbody>
417 </table></div>
418 </div>
419 <hr>
420 <div class="refsect2" title="tp_svc_account_return_from_update_parameters ()">
421 <a name="tp-svc-account-return-from-update-parameters"></a><h3>tp_svc_account_return_from_update_parameters ()</h3>
422 <pre class="programlisting">void tp_svc_account_return_from_update_parameters
423 (<a
424 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
425 >DBusGMethodInvocation</a> *context,
426 const <a
427 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
428 >gchar</a> **out_Reconnect_Required);</pre>
429 <p>
430 Return successfully by calling <a
431 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
432 ><code class="function">dbus_g_method_return()</code></a>.
433 This inline function exists only to provide type-safety.</p>
434 <p>
435 </p>
436 <div class="variablelist"><table border="0">
437 <col align="left" valign="top">
438 <tbody>
439 <tr>
440 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
441 <td> The D-Bus method invocation context
442 </td>
443 </tr>
444 <tr>
445 <td><p><span class="term"><em class="parameter"><code>out_Reconnect_Required</code></em> :</span></p></td>
446 <td> const gchar ** (FIXME, generate documentation)
447 </td>
448 </tr>
449 </tbody>
450 </table></div>
451 </div>
452 <hr>
453 <div class="refsect2" title="tp_svc_account_implement_update_parameters ()">
454 <a name="tp-svc-account-implement-update-parameters"></a><h3>tp_svc_account_implement_update_parameters ()</h3>
455 <pre class="programlisting">void tp_svc_account_implement_update_parameters
456 (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountClass" title="TpSvcAccountClass">TpSvcAccountClass</a> *klass,
457 <a class="link" href="telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl" title="tp_svc_account_update_parameters_impl ()">tp_svc_account_update_parameters_impl</a> impl);</pre>
458 <p>
459 Register an implementation for the UpdateParameters method in the vtable
460 of an implementation of this interface. To be called from
461 the interface init function.</p>
462 <p>
463 </p>
464 <div class="variablelist"><table border="0">
465 <col align="left" valign="top">
466 <tbody>
467 <tr>
468 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
469 <td> A class whose instances implement this interface
470 </td>
471 </tr>
472 <tr>
473 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
474 <td> A callback used to implement the UpdateParameters D-Bus method
475 </td>
476 </tr>
477 </tbody>
478 </table></div>
479 </div>
480 <hr>
481 <div class="refsect2" title="TpSvcAccountInterfaceAvatar">
482 <a name="TpSvcAccountInterfaceAvatar-struct"></a><h3>TpSvcAccountInterfaceAvatar</h3>
483 <pre class="programlisting">typedef struct _TpSvcAccountInterfaceAvatar TpSvcAccountInterfaceAvatar;</pre>
484 <p>
485 Dummy typedef representing any implementation of this interface.</p>
486 <p>
487 </p>
488 </div>
489 <hr>
490 <div class="refsect2" title="TpSvcAccountInterfaceAvatarClass">
491 <a name="TpSvcAccountInterfaceAvatarClass"></a><h3>TpSvcAccountInterfaceAvatarClass</h3>
492 <pre class="programlisting">typedef struct _TpSvcAccountInterfaceAvatarClass TpSvcAccountInterfaceAvatarClass;</pre>
493 <p>
494 The class of TpSvcAccountInterfaceAvatar.</p>
495 <p>
496 </p>
497 </div>
498 <hr>
499 <div class="refsect2" title="tp_svc_account_interface_avatar_emit_avatar_changed ()">
500 <a name="tp-svc-account-interface-avatar-emit-avatar-changed"></a><h3>tp_svc_account_interface_avatar_emit_avatar_changed ()</h3>
501 <pre class="programlisting">void tp_svc_account_interface_avatar_emit_avatar_changed
502 (<a
503 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
504 >gpointer</a> instance);</pre>
505 <p>
506 Type-safe wrapper around g_signal_emit to emit the
507 AvatarChanged signal on interface org.freedesktop.Telepathy.Account.Interface.Avatar.</p>
508 <p>
509 </p>
510 <div class="variablelist"><table border="0">
511 <col align="left" valign="top">
512 <tbody><tr>
513 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
514 <td> The object implementing this interface
515 </td>
516 </tr></tbody>
517 </table></div>
518 </div>
519 </div>
520 <div class="refsect1" title="Signal Details">
521 <a name="telepathy-glib-svc-account.signal-details"></a><h2>Signal Details</h2>
522 <div class="refsect2" title='The "account-property-changed" signal'>
523 <a name="TpSvcAccount-account-property-changed"></a><h3>The <code class="literal">"account-property-changed"</code> signal</h3>
524 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *arg_Properties,
525 <a
526 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
527 >gpointer</a> user_data) : Run Last / Has Details</pre>
528 <p>
529 The AccountPropertyChanged D-Bus signal is emitted whenever this GObject signal is.</p>
530 <p>
531 </p>
532 <div class="variablelist"><table border="0">
533 <col align="left" valign="top">
534 <tbody>
535 <tr>
536 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
537 <td> GHashTable * (FIXME, generate documentation)
538 </td>
539 </tr>
540 <tr>
541 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
542 <td>user data set when the signal handler was connected.</td>
543 </tr>
544 </tbody>
545 </table></div>
546 </div>
547 <hr>
548 <div class="refsect2" title='The "removed" signal'>
549 <a name="TpSvcAccount-removed"></a><h3>The <code class="literal">"removed"</code> signal</h3>
550 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccount">TpSvcAccount</a> *arg0,
551 <a
552 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
553 >gpointer</a> user_data) : Run Last / Has Details</pre>
554 <p>
555 The Removed D-Bus signal is emitted whenever this GObject signal is.</p>
556 <p>
557 </p>
558 <div class="variablelist"><table border="0">
559 <col align="left" valign="top">
560 <tbody><tr>
561 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
562 <td>user data set when the signal handler was connected.</td>
563 </tr></tbody>
564 </table></div>
565 </div>
566 <hr>
567 <div class="refsect2" title='The "avatar-changed" signal'>
568 <a name="TpSvcAccountInterfaceAvatar-avatar-changed"></a><h3>The <code class="literal">"avatar-changed"</code> signal</h3>
569 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar">TpSvcAccountInterfaceAvatar</a> *arg0,
570 <a
571 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
572 >gpointer</a> user_data) : Run Last / Has Details</pre>
573 <p>
574 The AvatarChanged D-Bus signal is emitted whenever this GObject signal is.</p>
575 <p>
576 </p>
577 <div class="variablelist"><table border="0">
578 <col align="left" valign="top">
579 <tbody><tr>
580 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
581 <td>user data set when the signal handler was connected.</td>
582 </tr></tbody>
583 </table></div>
584 </div>
585 </div>
586 </div>
587 <div class="footer">
588 <hr>
589 Generated by GTK-Doc V1.11</div>
590 </body>
591 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Contact List channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-group.html" title="Service-side Channel Group interface">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Channel Dispatch Operation interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-channel-dispatcher.html" title="Service-side Channel Dispatcher interface">
9 <link rel="next" href="telepathy-glib-svc-channel-request.html" title="Service-side Channel Request interface">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-channel-dispatcher.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-svc-channel-request.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-channel-dispatch-operation.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-channel-dispatch-operation.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-channel-dispatch-operation.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-svc-channel-dispatch-operation.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="Service-side Channel Dispatch Operation interface">
40 <a name="telepathy-glib-svc-channel-dispatch-operation"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-channel-dispatch-operation.top_of_page"></a>Service-side Channel Dispatch Operation interface</span></h2>
44 <p>Service-side Channel Dispatch Operation interface — GInterface for Telepathy ChannelDispatchOperation object</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv" title="Synopsis">
49 <a name="telepathy-glib-svc-channel-dispatch-operation.synopsis"></a><h2>Synopsis</h2>
50 <a name="TpSvcChannelDispatchOperation"></a><pre class="synopsis">
51
52 #include &lt;telepathy-glib/svc-channel-dispatch-operation.h&gt;
53
54 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-struct" title="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a>;
55 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass" title="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</a>;
56 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-claim" title="tp_svc_channel_dispatch_operation_return_from_claim ()">tp_svc_channel_dispatch_operation_return_from_claim</a>
57 (<a
58 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
59 >DBusGMethodInvocation</a> *context);
60 void (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl" title="tp_svc_channel_dispatch_operation_claim_impl ()">*tp_svc_channel_dispatch_operation_claim_impl</a>)
61 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *self,
62 <a
63 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
64 >DBusGMethodInvocation</a> *context);
65 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-claim" title="tp_svc_channel_dispatch_operation_implement_claim ()">tp_svc_channel_dispatch_operation_implement_claim</a>
66 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass" title="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</a> *klass,
67 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl" title="tp_svc_channel_dispatch_operation_claim_impl ()">tp_svc_channel_dispatch_operation_claim_impl</a> impl);
68 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-handle-with" title="tp_svc_channel_dispatch_operation_return_from_handle_with ()">tp_svc_channel_dispatch_operation_return_from_handle_with</a>
69 (<a
70 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
71 >DBusGMethodInvocation</a> *context);
72 void (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl" title="tp_svc_channel_dispatch_operation_handle_with_impl ()">*tp_svc_channel_dispatch_operation_handle_with_impl</a>)
73 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *self,
74 const <a
75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
76 >gchar</a> *in_Handler,
77 <a
78 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
79 >DBusGMethodInvocation</a> *context);
80 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-handle-with" title="tp_svc_channel_dispatch_operation_implement_handle_with ()">tp_svc_channel_dispatch_operation_implement_handle_with</a>
81 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass" title="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</a> *klass,
82 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl" title="tp_svc_channel_dispatch_operation_handle_with_impl ()">tp_svc_channel_dispatch_operation_handle_with_impl</a> impl);
83 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-channel-lost" title="tp_svc_channel_dispatch_operation_emit_channel_lost ()">tp_svc_channel_dispatch_operation_emit_channel_lost</a>
84 (<a
85 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
86 >gpointer</a> instance,
87 const <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
89 >gchar</a> *arg_Channel,
90 const <a
91 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
92 >gchar</a> *arg_Error,
93 const <a
94 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
95 >gchar</a> *arg_Message);
96 void <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-finished" title="tp_svc_channel_dispatch_operation_emit_finished ()">tp_svc_channel_dispatch_operation_emit_finished</a>
97 (<a
98 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
99 >gpointer</a> instance);
100 </pre>
101 </div>
102 <div class="refsect1" title="Object Hierarchy">
103 <a name="telepathy-glib-svc-channel-dispatch-operation.object-hierarchy"></a><h2>Object Hierarchy</h2>
104 <pre class="synopsis">
105 GInterface
106 +----TpSvcChannelDispatchOperation
107 </pre>
108 </div>
109 <div class="refsect1" title="Signals">
110 <a name="telepathy-glib-svc-channel-dispatch-operation.signals"></a><h2>Signals</h2>
111 <pre class="synopsis">
112 "<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-channel-lost" title='The "channel-lost" signal'>channel-lost</a>" : Run Last / Has Details
113 "<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-finished" title='The "finished" signal'>finished</a>" : Run Last / Has Details
114 </pre>
115 </div>
116 <div class="refsect1" title="Description">
117 <a name="telepathy-glib-svc-channel-dispatch-operation.description"></a><h2>Description</h2>
118 <p>
119 This interface (auto-generated from the Telepathy
120 spec) makes it easier to export an object implementing the Telepathy
121 ChannelDispatchOperation interface, with the correct method and signal
122 signatures, and emit signals from that object in a type-safe way.
123 </p>
124 <p>
125 You don't need these interfaces unless you're implementing a
126 Telepathy ChannelDispatcher, such as Mission Control.</p>
127 <p>
128 </p>
129 </div>
130 <div class="refsect1" title="Details">
131 <a name="telepathy-glib-svc-channel-dispatch-operation.details"></a><h2>Details</h2>
132 <div class="refsect2" title="TpSvcChannelDispatchOperation">
133 <a name="TpSvcChannelDispatchOperation-struct"></a><h3>TpSvcChannelDispatchOperation</h3>
134 <pre class="programlisting">typedef struct _TpSvcChannelDispatchOperation TpSvcChannelDispatchOperation;</pre>
135 <p>
136 Dummy typedef representing any implementation of this interface.</p>
137 <p>
138 </p>
139 </div>
140 <hr>
141 <div class="refsect2" title="TpSvcChannelDispatchOperationClass">
142 <a name="TpSvcChannelDispatchOperationClass"></a><h3>TpSvcChannelDispatchOperationClass</h3>
143 <pre class="programlisting">typedef struct _TpSvcChannelDispatchOperationClass TpSvcChannelDispatchOperationClass;</pre>
144 <p>
145 The class of TpSvcChannelDispatchOperation.</p>
146 <p>
147 </p>
148 </div>
149 <hr>
150 <div class="refsect2" title="tp_svc_channel_dispatch_operation_return_from_claim ()">
151 <a name="tp-svc-channel-dispatch-operation-return-from-claim"></a><h3>tp_svc_channel_dispatch_operation_return_from_claim ()</h3>
152 <pre class="programlisting">void tp_svc_channel_dispatch_operation_return_from_claim
153 (<a
154 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
155 >DBusGMethodInvocation</a> *context);</pre>
156 <p>
157 Return successfully by calling <a
158 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
159 ><code class="function">dbus_g_method_return()</code></a>.
160 This inline function exists only to provide type-safety.</p>
161 <p>
162 </p>
163 <div class="variablelist"><table border="0">
164 <col align="left" valign="top">
165 <tbody><tr>
166 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
167 <td> The D-Bus method invocation context
168 </td>
169 </tr></tbody>
170 </table></div>
171 </div>
172 <hr>
173 <div class="refsect2" title="tp_svc_channel_dispatch_operation_claim_impl ()">
174 <a name="tp-svc-channel-dispatch-operation-claim-impl"></a><h3>tp_svc_channel_dispatch_operation_claim_impl ()</h3>
175 <pre class="programlisting">void (*tp_svc_channel_dispatch_operation_claim_impl)
176 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *self,
177 <a
178 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
179 >DBusGMethodInvocation</a> *context);</pre>
180 <p>
181 The signature of an implementation of the D-Bus method
182 Claim on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</p>
183 <p>
184 </p>
185 <div class="variablelist"><table border="0">
186 <col align="left" valign="top">
187 <tbody>
188 <tr>
189 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
190 <td> The object implementing this interface
191 </td>
192 </tr>
193 <tr>
194 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
195 <td> Used to return values or throw an error
196 </td>
197 </tr>
198 </tbody>
199 </table></div>
200 </div>
201 <hr>
202 <div class="refsect2" title="tp_svc_channel_dispatch_operation_implement_claim ()">
203 <a name="tp-svc-channel-dispatch-operation-implement-claim"></a><h3>tp_svc_channel_dispatch_operation_implement_claim ()</h3>
204 <pre class="programlisting">void tp_svc_channel_dispatch_operation_implement_claim
205 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass" title="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</a> *klass,
206 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl" title="tp_svc_channel_dispatch_operation_claim_impl ()">tp_svc_channel_dispatch_operation_claim_impl</a> impl);</pre>
207 <p>
208 Register an implementation for the Claim method in the vtable
209 of an implementation of this interface. To be called from
210 the interface init function.</p>
211 <p>
212 </p>
213 <div class="variablelist"><table border="0">
214 <col align="left" valign="top">
215 <tbody>
216 <tr>
217 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
218 <td> A class whose instances implement this interface
219 </td>
220 </tr>
221 <tr>
222 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
223 <td> A callback used to implement the Claim D-Bus method
224 </td>
225 </tr>
226 </tbody>
227 </table></div>
228 </div>
229 <hr>
230 <div class="refsect2" title="tp_svc_channel_dispatch_operation_return_from_handle_with ()">
231 <a name="tp-svc-channel-dispatch-operation-return-from-handle-with"></a><h3>tp_svc_channel_dispatch_operation_return_from_handle_with ()</h3>
232 <pre class="programlisting">void tp_svc_channel_dispatch_operation_return_from_handle_with
233 (<a
234 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
235 >DBusGMethodInvocation</a> *context);</pre>
236 <p>
237 Return successfully by calling <a
238 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
239 ><code class="function">dbus_g_method_return()</code></a>.
240 This inline function exists only to provide type-safety.</p>
241 <p>
242 </p>
243 <div class="variablelist"><table border="0">
244 <col align="left" valign="top">
245 <tbody><tr>
246 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
247 <td> The D-Bus method invocation context
248 </td>
249 </tr></tbody>
250 </table></div>
251 </div>
252 <hr>
253 <div class="refsect2" title="tp_svc_channel_dispatch_operation_handle_with_impl ()">
254 <a name="tp-svc-channel-dispatch-operation-handle-with-impl"></a><h3>tp_svc_channel_dispatch_operation_handle_with_impl ()</h3>
255 <pre class="programlisting">void (*tp_svc_channel_dispatch_operation_handle_with_impl)
256 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *self,
257 const <a
258 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
259 >gchar</a> *in_Handler,
260 <a
261 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
262 >DBusGMethodInvocation</a> *context);</pre>
263 <p>
264 The signature of an implementation of the D-Bus method
265 HandleWith on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</p>
266 <p>
267 </p>
268 <div class="variablelist"><table border="0">
269 <col align="left" valign="top">
270 <tbody>
271 <tr>
272 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
273 <td> The object implementing this interface
274 </td>
275 </tr>
276 <tr>
277 <td><p><span class="term"><em class="parameter"><code>in_Handler</code></em> :</span></p></td>
278 <td> const gchar * (FIXME, generate documentation)
279 </td>
280 </tr>
281 <tr>
282 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
283 <td> Used to return values or throw an error
284 </td>
285 </tr>
286 </tbody>
287 </table></div>
288 </div>
289 <hr>
290 <div class="refsect2" title="tp_svc_channel_dispatch_operation_implement_handle_with ()">
291 <a name="tp-svc-channel-dispatch-operation-implement-handle-with"></a><h3>tp_svc_channel_dispatch_operation_implement_handle_with ()</h3>
292 <pre class="programlisting">void tp_svc_channel_dispatch_operation_implement_handle_with
293 (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass" title="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</a> *klass,
294 <a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl" title="tp_svc_channel_dispatch_operation_handle_with_impl ()">tp_svc_channel_dispatch_operation_handle_with_impl</a> impl);</pre>
295 <p>
296 Register an implementation for the HandleWith method in the vtable
297 of an implementation of this interface. To be called from
298 the interface init function.</p>
299 <p>
300 </p>
301 <div class="variablelist"><table border="0">
302 <col align="left" valign="top">
303 <tbody>
304 <tr>
305 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
306 <td> A class whose instances implement this interface
307 </td>
308 </tr>
309 <tr>
310 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
311 <td> A callback used to implement the HandleWith D-Bus method
312 </td>
313 </tr>
314 </tbody>
315 </table></div>
316 </div>
317 <hr>
318 <div class="refsect2" title="tp_svc_channel_dispatch_operation_emit_channel_lost ()">
319 <a name="tp-svc-channel-dispatch-operation-emit-channel-lost"></a><h3>tp_svc_channel_dispatch_operation_emit_channel_lost ()</h3>
320 <pre class="programlisting">void tp_svc_channel_dispatch_operation_emit_channel_lost
321 (<a
322 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
323 >gpointer</a> instance,
324 const <a
325 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
326 >gchar</a> *arg_Channel,
327 const <a
328 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
329 >gchar</a> *arg_Error,
330 const <a
331 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
332 >gchar</a> *arg_Message);</pre>
333 <p>
334 Type-safe wrapper around g_signal_emit to emit the
335 ChannelLost signal on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</p>
336 <p>
337 </p>
338 <div class="variablelist"><table border="0">
339 <col align="left" valign="top">
340 <tbody>
341 <tr>
342 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
343 <td> The object implementing this interface
344 </td>
345 </tr>
346 <tr>
347 <td><p><span class="term"><em class="parameter"><code>arg_Channel</code></em> :</span></p></td>
348 <td> const gchar * (FIXME, generate documentation)
349 </td>
350 </tr>
351 <tr>
352 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
353 <td> const gchar * (FIXME, generate documentation)
354 </td>
355 </tr>
356 <tr>
357 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
358 <td> const gchar * (FIXME, generate documentation)
359 </td>
360 </tr>
361 </tbody>
362 </table></div>
363 </div>
364 <hr>
365 <div class="refsect2" title="tp_svc_channel_dispatch_operation_emit_finished ()">
366 <a name="tp-svc-channel-dispatch-operation-emit-finished"></a><h3>tp_svc_channel_dispatch_operation_emit_finished ()</h3>
367 <pre class="programlisting">void tp_svc_channel_dispatch_operation_emit_finished
368 (<a
369 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
370 >gpointer</a> instance);</pre>
371 <p>
372 Type-safe wrapper around g_signal_emit to emit the
373 Finished signal on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</p>
374 <p>
375 </p>
376 <div class="variablelist"><table border="0">
377 <col align="left" valign="top">
378 <tbody><tr>
379 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
380 <td> The object implementing this interface
381 </td>
382 </tr></tbody>
383 </table></div>
384 </div>
385 </div>
386 <div class="refsect1" title="Signal Details">
387 <a name="telepathy-glib-svc-channel-dispatch-operation.signal-details"></a><h2>Signal Details</h2>
388 <div class="refsect2" title='The "channel-lost" signal'>
389 <a name="TpSvcChannelDispatchOperation-channel-lost"></a><h3>The <code class="literal">"channel-lost"</code> signal</h3>
390 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *arg_Channel,
391 DBusGObjectPath *arg_Error,
392 <a
393 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
394 >gchar</a> *arg_Message,
395 <a
396 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
397 >gchar</a> *arg3,
398 <a
399 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
400 >gpointer</a> user_data) : Run Last / Has Details</pre>
401 <p>
402 The ChannelLost D-Bus signal is emitted whenever this GObject signal is.</p>
403 <p>
404 </p>
405 <div class="variablelist"><table border="0">
406 <col align="left" valign="top">
407 <tbody>
408 <tr>
409 <td><p><span class="term"><em class="parameter"><code>arg_Channel</code></em> :</span></p></td>
410 <td> const gchar * (FIXME, generate documentation)
411 </td>
412 </tr>
413 <tr>
414 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
415 <td> const gchar * (FIXME, generate documentation)
416 </td>
417 </tr>
418 <tr>
419 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
420 <td> const gchar * (FIXME, generate documentation)
421 </td>
422 </tr>
423 <tr>
424 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
425 <td>user data set when the signal handler was connected.</td>
426 </tr>
427 </tbody>
428 </table></div>
429 </div>
430 <hr>
431 <div class="refsect2" title='The "finished" signal'>
432 <a name="TpSvcChannelDispatchOperation-finished"></a><h3>The <code class="literal">"finished"</code> signal</h3>
433 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</a> *arg0,
434 <a
435 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
436 >gpointer</a> user_data) : Run Last / Has Details</pre>
437 <p>
438 The Finished D-Bus signal is emitted whenever this GObject signal is.</p>
439 <p>
440 </p>
441 <div class="variablelist"><table border="0">
442 <col align="left" valign="top">
443 <tbody><tr>
444 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
445 <td>user data set when the signal handler was connected.</td>
446 </tr></tbody>
447 </table></div>
448 </div>
449 </div>
450 </div>
451 <div class="footer">
452 <hr>
453 Generated by GTK-Doc V1.11</div>
454 </body>
455 </html>
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Channel Dispatcher interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-account.html" title="Service-side Account interfaces">
9 <link rel="next" href="telepathy-glib-svc-channel-dispatch-operation.html" title="Service-side Channel Dispatch Operation interface">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-account.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-svc-channel-dispatch-operation.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-channel-dispatcher.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-channel-dispatcher.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-channel-dispatcher.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-svc-channel-dispatcher.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="Service-side Channel Dispatcher interface">
40 <a name="telepathy-glib-svc-channel-dispatcher"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-channel-dispatcher.top_of_page"></a>Service-side Channel Dispatcher interface</span></h2>
44 <p>Service-side Channel Dispatcher interface — GInterfaces for Telepathy ChannelDispatcher object</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv" title="Synopsis">
49 <a name="telepathy-glib-svc-channel-dispatcher.synopsis"></a><h2>Synopsis</h2>
50 <a name="TpSvcChannelDispatcher"></a><a name="TpSvcChannelDispatcherInterfaceOperationList"></a><pre class="synopsis">
51
52 #include &lt;telepathy-glib/svc-channel-dispatcher.h&gt;
53
54 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher-struct" title="TpSvcChannelDispatcher">TpSvcChannelDispatcher</a>;
55 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass" title="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</a>;
56 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-create-channel" title="tp_svc_channel_dispatcher_return_from_create_channel ()">tp_svc_channel_dispatcher_return_from_create_channel</a>
57 (<a
58 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
59 >DBusGMethodInvocation</a> *context,
60 const <a
61 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
62 >gchar</a> *out_Request);
63 void (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl" title="tp_svc_channel_dispatcher_create_channel_impl ()">*tp_svc_channel_dispatcher_create_channel_impl</a>)
64 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher">TpSvcChannelDispatcher</a> *self,
65 const <a
66 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
67 >gchar</a> *in_Account,
68 <a
69 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
70 >GHashTable</a> *in_Requested_Properties,
71 <a
72 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
73 >gint64</a> in_User_Action_Time,
74 const <a
75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
76 >gchar</a> *in_Preferred_Handler,
77 <a
78 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
79 >DBusGMethodInvocation</a> *context);
80 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-create-channel" title="tp_svc_channel_dispatcher_implement_create_channel ()">tp_svc_channel_dispatcher_implement_create_channel</a>
81 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass" title="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</a> *klass,
82 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl" title="tp_svc_channel_dispatcher_create_channel_impl ()">tp_svc_channel_dispatcher_create_channel_impl</a> impl);
83 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-ensure-channel" title="tp_svc_channel_dispatcher_return_from_ensure_channel ()">tp_svc_channel_dispatcher_return_from_ensure_channel</a>
84 (<a
85 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
86 >DBusGMethodInvocation</a> *context,
87 const <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
89 >gchar</a> *out_Request);
90 void (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl" title="tp_svc_channel_dispatcher_ensure_channel_impl ()">*tp_svc_channel_dispatcher_ensure_channel_impl</a>)
91 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher">TpSvcChannelDispatcher</a> *self,
92 const <a
93 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
94 >gchar</a> *in_Account,
95 <a
96 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
97 >GHashTable</a> *in_Requested_Properties,
98 <a
99 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
100 >gint64</a> in_User_Action_Time,
101 const <a
102 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
103 >gchar</a> *in_Preferred_Handler,
104 <a
105 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
106 >DBusGMethodInvocation</a> *context);
107 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-ensure-channel" title="tp_svc_channel_dispatcher_implement_ensure_channel ()">tp_svc_channel_dispatcher_implement_ensure_channel</a>
108 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass" title="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</a> *klass,
109 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl" title="tp_svc_channel_dispatcher_ensure_channel_impl ()">tp_svc_channel_dispatcher_ensure_channel_impl</a> impl);
110
111 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-struct" title="TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</a>;
112 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationListClass" title="TpSvcChannelDispatcherInterfaceOperationListClass">TpSvcChannelDispatcherInterfaceOperationListClass</a>;
113 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation" title="tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()">tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation</a>
114 (<a
115 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
116 >gpointer</a> instance,
117 const <a
118 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
119 >gchar</a> *arg_Dispatch_Operation,
120 <a
121 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
122 >GHashTable</a> *arg_Properties);
123 void <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished" title="tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()">tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished</a>
124 (<a
125 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
126 >gpointer</a> instance,
127 const <a
128 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
129 >gchar</a> *arg_Dispatch_Operation);
130 </pre>
131 </div>
132 <div class="refsect1" title="Object Hierarchy">
133 <a name="telepathy-glib-svc-channel-dispatcher.object-hierarchy"></a><h2>Object Hierarchy</h2>
134 <pre class="synopsis">
135 GInterface
136 +----TpSvcChannelDispatcher
137 </pre>
138 <pre class="synopsis">
139 GInterface
140 +----TpSvcChannelDispatcherInterfaceOperationList
141 </pre>
142 </div>
143 <div class="refsect1" title="Signals">
144 <a name="telepathy-glib-svc-channel-dispatcher.signals"></a><h2>Signals</h2>
145 <pre class="synopsis">
146 "<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished" title='The "dispatch-operation-finished" signal'>dispatch-operation-finished</a>" : Run Last / Has Details
147 "<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation" title='The "new-dispatch-operation" signal'>new-dispatch-operation</a>" : Run Last / Has Details
148 </pre>
149 </div>
150 <div class="refsect1" title="Description">
151 <a name="telepathy-glib-svc-channel-dispatcher.description"></a><h2>Description</h2>
152 <p>
153 The <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher"><span class="type">TpSvcChannelDispatcher</span></a> interface (auto-generated from the Telepathy
154 spec) makes it easier to export an object implementing the Telepathy
155 ChannelDispatcher interface, with the correct method and signal signatures,
156 and emit signals from that object in a type-safe way.
157 </p>
158 <p>
159 Similarly, <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList"><span class="type">TpSvcChannelDispatcherInterfaceOperationList</span></a> helps to
160 implement the optional OperationList interface.
161 </p>
162 <p>
163 You don't need these interfaces unless you're implementing a
164 Telepathy ChannelDispatcher, such as Mission Control.</p>
165 <p>
166 </p>
167 </div>
168 <div class="refsect1" title="Details">
169 <a name="telepathy-glib-svc-channel-dispatcher.details"></a><h2>Details</h2>
170 <div class="refsect2" title="TpSvcChannelDispatcher">
171 <a name="TpSvcChannelDispatcher-struct"></a><h3>TpSvcChannelDispatcher</h3>
172 <pre class="programlisting">typedef struct _TpSvcChannelDispatcher TpSvcChannelDispatcher;</pre>
173 <p>
174 Dummy typedef representing any implementation of this interface.</p>
175 <p>
176 </p>
177 </div>
178 <hr>
179 <div class="refsect2" title="TpSvcChannelDispatcherClass">
180 <a name="TpSvcChannelDispatcherClass"></a><h3>TpSvcChannelDispatcherClass</h3>
181 <pre class="programlisting">typedef struct _TpSvcChannelDispatcherClass TpSvcChannelDispatcherClass;</pre>
182 <p>
183 The class of TpSvcChannelDispatcher.</p>
184 <p>
185 </p>
186 </div>
187 <hr>
188 <div class="refsect2" title="tp_svc_channel_dispatcher_return_from_create_channel ()">
189 <a name="tp-svc-channel-dispatcher-return-from-create-channel"></a><h3>tp_svc_channel_dispatcher_return_from_create_channel ()</h3>
190 <pre class="programlisting">void tp_svc_channel_dispatcher_return_from_create_channel
191 (<a
192 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
193 >DBusGMethodInvocation</a> *context,
194 const <a
195 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
196 >gchar</a> *out_Request);</pre>
197 <p>
198 Return successfully by calling <a
199 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
200 ><code class="function">dbus_g_method_return()</code></a>.
201 This inline function exists only to provide type-safety.</p>
202 <p>
203 </p>
204 <div class="variablelist"><table border="0">
205 <col align="left" valign="top">
206 <tbody>
207 <tr>
208 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
209 <td> The D-Bus method invocation context
210 </td>
211 </tr>
212 <tr>
213 <td><p><span class="term"><em class="parameter"><code>out_Request</code></em> :</span></p></td>
214 <td> const gchar * (FIXME, generate documentation)
215 </td>
216 </tr>
217 </tbody>
218 </table></div>
219 </div>
220 <hr>
221 <div class="refsect2" title="tp_svc_channel_dispatcher_create_channel_impl ()">
222 <a name="tp-svc-channel-dispatcher-create-channel-impl"></a><h3>tp_svc_channel_dispatcher_create_channel_impl ()</h3>
223 <pre class="programlisting">void (*tp_svc_channel_dispatcher_create_channel_impl)
224 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher">TpSvcChannelDispatcher</a> *self,
225 const <a
226 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
227 >gchar</a> *in_Account,
228 <a
229 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
230 >GHashTable</a> *in_Requested_Properties,
231 <a
232 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
233 >gint64</a> in_User_Action_Time,
234 const <a
235 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
236 >gchar</a> *in_Preferred_Handler,
237 <a
238 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
239 >DBusGMethodInvocation</a> *context);</pre>
240 <p>
241 The signature of an implementation of the D-Bus method
242 CreateChannel on interface org.freedesktop.Telepathy.ChannelDispatcher.</p>
243 <p>
244 </p>
245 <div class="variablelist"><table border="0">
246 <col align="left" valign="top">
247 <tbody>
248 <tr>
249 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
250 <td> The object implementing this interface
251 </td>
252 </tr>
253 <tr>
254 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
255 <td> const gchar * (FIXME, generate documentation)
256 </td>
257 </tr>
258 <tr>
259 <td><p><span class="term"><em class="parameter"><code>in_Requested_Properties</code></em> :</span></p></td>
260 <td> GHashTable * (FIXME, generate documentation)
261 </td>
262 </tr>
263 <tr>
264 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
265 <td> gint64 (FIXME, generate documentation)
266 </td>
267 </tr>
268 <tr>
269 <td><p><span class="term"><em class="parameter"><code>in_Preferred_Handler</code></em> :</span></p></td>
270 <td> const gchar * (FIXME, generate documentation)
271 </td>
272 </tr>
273 <tr>
274 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
275 <td> Used to return values or throw an error
276 </td>
277 </tr>
278 </tbody>
279 </table></div>
280 </div>
281 <hr>
282 <div class="refsect2" title="tp_svc_channel_dispatcher_implement_create_channel ()">
283 <a name="tp-svc-channel-dispatcher-implement-create-channel"></a><h3>tp_svc_channel_dispatcher_implement_create_channel ()</h3>
284 <pre class="programlisting">void tp_svc_channel_dispatcher_implement_create_channel
285 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass" title="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</a> *klass,
286 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl" title="tp_svc_channel_dispatcher_create_channel_impl ()">tp_svc_channel_dispatcher_create_channel_impl</a> impl);</pre>
287 <p>
288 Register an implementation for the CreateChannel method in the vtable
289 of an implementation of this interface. To be called from
290 the interface init function.</p>
291 <p>
292 </p>
293 <div class="variablelist"><table border="0">
294 <col align="left" valign="top">
295 <tbody>
296 <tr>
297 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
298 <td> A class whose instances implement this interface
299 </td>
300 </tr>
301 <tr>
302 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
303 <td> A callback used to implement the CreateChannel D-Bus method
304 </td>
305 </tr>
306 </tbody>
307 </table></div>
308 </div>
309 <hr>
310 <div class="refsect2" title="tp_svc_channel_dispatcher_return_from_ensure_channel ()">
311 <a name="tp-svc-channel-dispatcher-return-from-ensure-channel"></a><h3>tp_svc_channel_dispatcher_return_from_ensure_channel ()</h3>
312 <pre class="programlisting">void tp_svc_channel_dispatcher_return_from_ensure_channel
313 (<a
314 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
315 >DBusGMethodInvocation</a> *context,
316 const <a
317 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
318 >gchar</a> *out_Request);</pre>
319 <p>
320 Return successfully by calling <a
321 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
322 ><code class="function">dbus_g_method_return()</code></a>.
323 This inline function exists only to provide type-safety.</p>
324 <p>
325 </p>
326 <div class="variablelist"><table border="0">
327 <col align="left" valign="top">
328 <tbody>
329 <tr>
330 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
331 <td> The D-Bus method invocation context
332 </td>
333 </tr>
334 <tr>
335 <td><p><span class="term"><em class="parameter"><code>out_Request</code></em> :</span></p></td>
336 <td> const gchar * (FIXME, generate documentation)
337 </td>
338 </tr>
339 </tbody>
340 </table></div>
341 </div>
342 <hr>
343 <div class="refsect2" title="tp_svc_channel_dispatcher_ensure_channel_impl ()">
344 <a name="tp-svc-channel-dispatcher-ensure-channel-impl"></a><h3>tp_svc_channel_dispatcher_ensure_channel_impl ()</h3>
345 <pre class="programlisting">void (*tp_svc_channel_dispatcher_ensure_channel_impl)
346 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher">TpSvcChannelDispatcher</a> *self,
347 const <a
348 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
349 >gchar</a> *in_Account,
350 <a
351 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
352 >GHashTable</a> *in_Requested_Properties,
353 <a
354 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"
355 >gint64</a> in_User_Action_Time,
356 const <a
357 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
358 >gchar</a> *in_Preferred_Handler,
359 <a
360 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
361 >DBusGMethodInvocation</a> *context);</pre>
362 <p>
363 The signature of an implementation of the D-Bus method
364 EnsureChannel on interface org.freedesktop.Telepathy.ChannelDispatcher.</p>
365 <p>
366 </p>
367 <div class="variablelist"><table border="0">
368 <col align="left" valign="top">
369 <tbody>
370 <tr>
371 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
372 <td> The object implementing this interface
373 </td>
374 </tr>
375 <tr>
376 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
377 <td> const gchar * (FIXME, generate documentation)
378 </td>
379 </tr>
380 <tr>
381 <td><p><span class="term"><em class="parameter"><code>in_Requested_Properties</code></em> :</span></p></td>
382 <td> GHashTable * (FIXME, generate documentation)
383 </td>
384 </tr>
385 <tr>
386 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
387 <td> gint64 (FIXME, generate documentation)
388 </td>
389 </tr>
390 <tr>
391 <td><p><span class="term"><em class="parameter"><code>in_Preferred_Handler</code></em> :</span></p></td>
392 <td> const gchar * (FIXME, generate documentation)
393 </td>
394 </tr>
395 <tr>
396 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
397 <td> Used to return values or throw an error
398 </td>
399 </tr>
400 </tbody>
401 </table></div>
402 </div>
403 <hr>
404 <div class="refsect2" title="tp_svc_channel_dispatcher_implement_ensure_channel ()">
405 <a name="tp-svc-channel-dispatcher-implement-ensure-channel"></a><h3>tp_svc_channel_dispatcher_implement_ensure_channel ()</h3>
406 <pre class="programlisting">void tp_svc_channel_dispatcher_implement_ensure_channel
407 (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass" title="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</a> *klass,
408 <a class="link" href="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl" title="tp_svc_channel_dispatcher_ensure_channel_impl ()">tp_svc_channel_dispatcher_ensure_channel_impl</a> impl);</pre>
409 <p>
410 Register an implementation for the EnsureChannel method in the vtable
411 of an implementation of this interface. To be called from
412 the interface init function.</p>
413 <p>
414 </p>
415 <div class="variablelist"><table border="0">
416 <col align="left" valign="top">
417 <tbody>
418 <tr>
419 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
420 <td> A class whose instances implement this interface
421 </td>
422 </tr>
423 <tr>
424 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
425 <td> A callback used to implement the EnsureChannel D-Bus method
426 </td>
427 </tr>
428 </tbody>
429 </table></div>
430 </div>
431 <hr>
432 <div class="refsect2" title="TpSvcChannelDispatcherInterfaceOperationList">
433 <a name="TpSvcChannelDispatcherInterfaceOperationList-struct"></a><h3>TpSvcChannelDispatcherInterfaceOperationList</h3>
434 <pre class="programlisting">typedef struct _TpSvcChannelDispatcherInterfaceOperationList TpSvcChannelDispatcherInterfaceOperationList;</pre>
435 <p>
436 Dummy typedef representing any implementation of this interface.</p>
437 <p>
438 </p>
439 </div>
440 <hr>
441 <div class="refsect2" title="TpSvcChannelDispatcherInterfaceOperationListClass">
442 <a name="TpSvcChannelDispatcherInterfaceOperationListClass"></a><h3>TpSvcChannelDispatcherInterfaceOperationListClass</h3>
443 <pre class="programlisting">typedef struct _TpSvcChannelDispatcherInterfaceOperationListClass TpSvcChannelDispatcherInterfaceOperationListClass;</pre>
444 <p>
445 The class of TpSvcChannelDispatcherInterfaceOperationList.</p>
446 <p>
447 </p>
448 </div>
449 <hr>
450 <div class="refsect2" title="tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()">
451 <a name="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation"></a><h3>tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()</h3>
452 <pre class="programlisting">void tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation
453 (<a
454 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
455 >gpointer</a> instance,
456 const <a
457 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
458 >gchar</a> *arg_Dispatch_Operation,
459 <a
460 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
461 >GHashTable</a> *arg_Properties);</pre>
462 <p>
463 Type-safe wrapper around g_signal_emit to emit the
464 NewDispatchOperation signal on interface org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList.</p>
465 <p>
466 </p>
467 <div class="variablelist"><table border="0">
468 <col align="left" valign="top">
469 <tbody>
470 <tr>
471 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
472 <td> The object implementing this interface
473 </td>
474 </tr>
475 <tr>
476 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
477 <td> const gchar * (FIXME, generate documentation)
478 </td>
479 </tr>
480 <tr>
481 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
482 <td> GHashTable * (FIXME, generate documentation)
483 </td>
484 </tr>
485 </tbody>
486 </table></div>
487 </div>
488 <hr>
489 <div class="refsect2" title="tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()">
490 <a name="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished"></a><h3>tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()</h3>
491 <pre class="programlisting">void tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished
492 (<a
493 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
494 >gpointer</a> instance,
495 const <a
496 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
497 >gchar</a> *arg_Dispatch_Operation);</pre>
498 <p>
499 Type-safe wrapper around g_signal_emit to emit the
500 DispatchOperationFinished signal on interface org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList.</p>
501 <p>
502 </p>
503 <div class="variablelist"><table border="0">
504 <col align="left" valign="top">
505 <tbody>
506 <tr>
507 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
508 <td> The object implementing this interface
509 </td>
510 </tr>
511 <tr>
512 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
513 <td> const gchar * (FIXME, generate documentation)
514 </td>
515 </tr>
516 </tbody>
517 </table></div>
518 </div>
519 </div>
520 <div class="refsect1" title="Signal Details">
521 <a name="telepathy-glib-svc-channel-dispatcher.signal-details"></a><h2>Signal Details</h2>
522 <div class="refsect2" title='The "dispatch-operation-finished" signal'>
523 <a name="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"></a><h3>The <code class="literal">"dispatch-operation-finished"</code> signal</h3>
524 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</a> *arg_Dispatch_Operation,
525 DBusGObjectPath *arg1,
526 <a
527 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
528 >gpointer</a> user_data) : Run Last / Has Details</pre>
529 <p>
530 The DispatchOperationFinished D-Bus signal is emitted whenever this GObject signal is.</p>
531 <p>
532 </p>
533 <div class="variablelist"><table border="0">
534 <col align="left" valign="top">
535 <tbody>
536 <tr>
537 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
538 <td> const gchar * (FIXME, generate documentation)
539 </td>
540 </tr>
541 <tr>
542 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
543 <td>user data set when the signal handler was connected.</td>
544 </tr>
545 </tbody>
546 </table></div>
547 </div>
548 <hr>
549 <div class="refsect2" title='The "new-dispatch-operation" signal'>
550 <a name="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"></a><h3>The <code class="literal">"new-dispatch-operation"</code> signal</h3>
551 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</a> *arg_Dispatch_Operation,
552 DBusGObjectPath *arg_Properties,
553 <a
554 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
555 >gpointer</a> user_data) : Run Last / Has Details</pre>
556 <p>
557 The NewDispatchOperation D-Bus signal is emitted whenever this GObject signal is.</p>
558 <p>
559 </p>
560 <div class="variablelist"><table border="0">
561 <col align="left" valign="top">
562 <tbody>
563 <tr>
564 <td><p><span class="term"><em class="parameter"><code>arg_Dispatch_Operation</code></em> :</span></p></td>
565 <td> const gchar * (FIXME, generate documentation)
566 </td>
567 </tr>
568 <tr>
569 <td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
570 <td> GHashTable * (FIXME, generate documentation)
571 </td>
572 </tr>
573 <tr>
574 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
575 <td>user data set when the signal handler was connected.</td>
576 </tr>
577 </tbody>
578 </table></div>
579 </div>
580 </div>
581 </div>
582 <div class="footer">
583 <hr>
584 Generated by GTK-Doc V1.11</div>
585 </body>
586 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>File Transfer channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-media.html" title="Media channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side Channel Group interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel.html" title="Service-side Channel base interface">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Media channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-text.html" title="Text channels">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Channel Request interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-channel-dispatch-operation.html" title="Service-side Channel Dispatch Operation interface">
9 <link rel="next" href="telepathy-glib-svc-client.html" title="Service-side Client interfaces">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-channel-dispatch-operation.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="telepathy-glib-svc-client.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-channel-request.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-channel-request.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-channel-request.object-hierarchy" class="shortcut">Object Hierarchy</a>
35  | 
36 <a href="#telepathy-glib-svc-channel-request.signals" class="shortcut">Signals</a>
37 </td></tr>
38 </table>
39 <div class="refentry" title="Service-side Channel Request interface">
40 <a name="telepathy-glib-svc-channel-request"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-channel-request.top_of_page"></a>Service-side Channel Request interface</span></h2>
44 <p>Service-side Channel Request interface — GInterface for Telepathy ChannelRequest object</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv" title="Synopsis">
49 <a name="telepathy-glib-svc-channel-request.synopsis"></a><h2>Synopsis</h2>
50 <a name="TpSvcChannelRequest"></a><pre class="synopsis">
51
52 #include &lt;telepathy-glib/svc-channel-request.h&gt;
53
54 <a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-struct" title="TpSvcChannelRequest">TpSvcChannelRequest</a>;
55 <a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass" title="TpSvcChannelRequestClass">TpSvcChannelRequestClass</a>;
56 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-proceed" title="tp_svc_channel_request_return_from_proceed ()">tp_svc_channel_request_return_from_proceed</a>
57 (<a
58 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
59 >DBusGMethodInvocation</a> *context);
60 void (<a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl" title="tp_svc_channel_request_proceed_impl ()">*tp_svc_channel_request_proceed_impl</a>)
61 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *self,
62 <a
63 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
64 >DBusGMethodInvocation</a> *context);
65 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-proceed" title="tp_svc_channel_request_implement_proceed ()">tp_svc_channel_request_implement_proceed</a>
66 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass" title="TpSvcChannelRequestClass">TpSvcChannelRequestClass</a> *klass,
67 <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl" title="tp_svc_channel_request_proceed_impl ()">tp_svc_channel_request_proceed_impl</a> impl);
68 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-cancel" title="tp_svc_channel_request_return_from_cancel ()">tp_svc_channel_request_return_from_cancel</a>
69 (<a
70 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
71 >DBusGMethodInvocation</a> *context);
72 void (<a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl" title="tp_svc_channel_request_cancel_impl ()">*tp_svc_channel_request_cancel_impl</a>)
73 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *self,
74 <a
75 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
76 >DBusGMethodInvocation</a> *context);
77 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-cancel" title="tp_svc_channel_request_implement_cancel ()">tp_svc_channel_request_implement_cancel</a>
78 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass" title="TpSvcChannelRequestClass">TpSvcChannelRequestClass</a> *klass,
79 <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl" title="tp_svc_channel_request_cancel_impl ()">tp_svc_channel_request_cancel_impl</a> impl);
80 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-failed" title="tp_svc_channel_request_emit_failed ()">tp_svc_channel_request_emit_failed</a> (<a
81 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
82 >gpointer</a> instance,
83 const <a
84 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
85 >gchar</a> *arg_Error,
86 const <a
87 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
88 >gchar</a> *arg_Message);
89 void <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-succeeded" title="tp_svc_channel_request_emit_succeeded ()">tp_svc_channel_request_emit_succeeded</a>
90 (<a
91 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
92 >gpointer</a> instance);
93 </pre>
94 </div>
95 <div class="refsect1" title="Object Hierarchy">
96 <a name="telepathy-glib-svc-channel-request.object-hierarchy"></a><h2>Object Hierarchy</h2>
97 <pre class="synopsis">
98 GInterface
99 +----TpSvcChannelRequest
100 </pre>
101 </div>
102 <div class="refsect1" title="Signals">
103 <a name="telepathy-glib-svc-channel-request.signals"></a><h2>Signals</h2>
104 <pre class="synopsis">
105 "<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-failed" title='The "failed" signal'>failed</a>" : Run Last / Has Details
106 "<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-succeeded" title='The "succeeded" signal'>succeeded</a>" : Run Last / Has Details
107 </pre>
108 </div>
109 <div class="refsect1" title="Description">
110 <a name="telepathy-glib-svc-channel-request.description"></a><h2>Description</h2>
111 <p>
112 This interface (auto-generated from the Telepathy
113 spec) makes it easier to export an object implementing the Telepathy
114 ChannelRequest interface, with the correct method and signal
115 signatures, and emit signals from that object in a type-safe way.
116 </p>
117 <p>
118 You don't need these interfaces unless you're implementing a
119 Telepathy ChannelDispatcher, such as Mission Control.</p>
120 <p>
121 </p>
122 </div>
123 <div class="refsect1" title="Details">
124 <a name="telepathy-glib-svc-channel-request.details"></a><h2>Details</h2>
125 <div class="refsect2" title="TpSvcChannelRequest">
126 <a name="TpSvcChannelRequest-struct"></a><h3>TpSvcChannelRequest</h3>
127 <pre class="programlisting">typedef struct _TpSvcChannelRequest TpSvcChannelRequest;</pre>
128 <p>
129 Dummy typedef representing any implementation of this interface.</p>
130 <p>
131 </p>
132 </div>
133 <hr>
134 <div class="refsect2" title="TpSvcChannelRequestClass">
135 <a name="TpSvcChannelRequestClass"></a><h3>TpSvcChannelRequestClass</h3>
136 <pre class="programlisting">typedef struct _TpSvcChannelRequestClass TpSvcChannelRequestClass;</pre>
137 <p>
138 The class of TpSvcChannelRequest.</p>
139 <p>
140 </p>
141 </div>
142 <hr>
143 <div class="refsect2" title="tp_svc_channel_request_return_from_proceed ()">
144 <a name="tp-svc-channel-request-return-from-proceed"></a><h3>tp_svc_channel_request_return_from_proceed ()</h3>
145 <pre class="programlisting">void tp_svc_channel_request_return_from_proceed
146 (<a
147 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
148 >DBusGMethodInvocation</a> *context);</pre>
149 <p>
150 Return successfully by calling <a
151 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
152 ><code class="function">dbus_g_method_return()</code></a>.
153 This inline function exists only to provide type-safety.</p>
154 <p>
155 </p>
156 <div class="variablelist"><table border="0">
157 <col align="left" valign="top">
158 <tbody><tr>
159 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
160 <td> The D-Bus method invocation context
161 </td>
162 </tr></tbody>
163 </table></div>
164 </div>
165 <hr>
166 <div class="refsect2" title="tp_svc_channel_request_proceed_impl ()">
167 <a name="tp-svc-channel-request-proceed-impl"></a><h3>tp_svc_channel_request_proceed_impl ()</h3>
168 <pre class="programlisting">void (*tp_svc_channel_request_proceed_impl)
169 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *self,
170 <a
171 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
172 >DBusGMethodInvocation</a> *context);</pre>
173 <p>
174 The signature of an implementation of the D-Bus method
175 Proceed on interface org.freedesktop.Telepathy.ChannelRequest.</p>
176 <p>
177 </p>
178 <div class="variablelist"><table border="0">
179 <col align="left" valign="top">
180 <tbody>
181 <tr>
182 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
183 <td> The object implementing this interface
184 </td>
185 </tr>
186 <tr>
187 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
188 <td> Used to return values or throw an error
189 </td>
190 </tr>
191 </tbody>
192 </table></div>
193 </div>
194 <hr>
195 <div class="refsect2" title="tp_svc_channel_request_implement_proceed ()">
196 <a name="tp-svc-channel-request-implement-proceed"></a><h3>tp_svc_channel_request_implement_proceed ()</h3>
197 <pre class="programlisting">void tp_svc_channel_request_implement_proceed
198 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass" title="TpSvcChannelRequestClass">TpSvcChannelRequestClass</a> *klass,
199 <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl" title="tp_svc_channel_request_proceed_impl ()">tp_svc_channel_request_proceed_impl</a> impl);</pre>
200 <p>
201 Register an implementation for the Proceed method in the vtable
202 of an implementation of this interface. To be called from
203 the interface init function.</p>
204 <p>
205 </p>
206 <div class="variablelist"><table border="0">
207 <col align="left" valign="top">
208 <tbody>
209 <tr>
210 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
211 <td> A class whose instances implement this interface
212 </td>
213 </tr>
214 <tr>
215 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
216 <td> A callback used to implement the Proceed D-Bus method
217 </td>
218 </tr>
219 </tbody>
220 </table></div>
221 </div>
222 <hr>
223 <div class="refsect2" title="tp_svc_channel_request_return_from_cancel ()">
224 <a name="tp-svc-channel-request-return-from-cancel"></a><h3>tp_svc_channel_request_return_from_cancel ()</h3>
225 <pre class="programlisting">void tp_svc_channel_request_return_from_cancel
226 (<a
227 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
228 >DBusGMethodInvocation</a> *context);</pre>
229 <p>
230 Return successfully by calling <a
231 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
232 ><code class="function">dbus_g_method_return()</code></a>.
233 This inline function exists only to provide type-safety.</p>
234 <p>
235 </p>
236 <div class="variablelist"><table border="0">
237 <col align="left" valign="top">
238 <tbody><tr>
239 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
240 <td> The D-Bus method invocation context
241 </td>
242 </tr></tbody>
243 </table></div>
244 </div>
245 <hr>
246 <div class="refsect2" title="tp_svc_channel_request_cancel_impl ()">
247 <a name="tp-svc-channel-request-cancel-impl"></a><h3>tp_svc_channel_request_cancel_impl ()</h3>
248 <pre class="programlisting">void (*tp_svc_channel_request_cancel_impl)
249 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *self,
250 <a
251 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
252 >DBusGMethodInvocation</a> *context);</pre>
253 <p>
254 The signature of an implementation of the D-Bus method
255 Cancel on interface org.freedesktop.Telepathy.ChannelRequest.</p>
256 <p>
257 </p>
258 <div class="variablelist"><table border="0">
259 <col align="left" valign="top">
260 <tbody>
261 <tr>
262 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
263 <td> The object implementing this interface
264 </td>
265 </tr>
266 <tr>
267 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
268 <td> Used to return values or throw an error
269 </td>
270 </tr>
271 </tbody>
272 </table></div>
273 </div>
274 <hr>
275 <div class="refsect2" title="tp_svc_channel_request_implement_cancel ()">
276 <a name="tp-svc-channel-request-implement-cancel"></a><h3>tp_svc_channel_request_implement_cancel ()</h3>
277 <pre class="programlisting">void tp_svc_channel_request_implement_cancel
278 (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass" title="TpSvcChannelRequestClass">TpSvcChannelRequestClass</a> *klass,
279 <a class="link" href="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl" title="tp_svc_channel_request_cancel_impl ()">tp_svc_channel_request_cancel_impl</a> impl);</pre>
280 <p>
281 Register an implementation for the Cancel method in the vtable
282 of an implementation of this interface. To be called from
283 the interface init function.</p>
284 <p>
285 </p>
286 <div class="variablelist"><table border="0">
287 <col align="left" valign="top">
288 <tbody>
289 <tr>
290 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
291 <td> A class whose instances implement this interface
292 </td>
293 </tr>
294 <tr>
295 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
296 <td> A callback used to implement the Cancel D-Bus method
297 </td>
298 </tr>
299 </tbody>
300 </table></div>
301 </div>
302 <hr>
303 <div class="refsect2" title="tp_svc_channel_request_emit_failed ()">
304 <a name="tp-svc-channel-request-emit-failed"></a><h3>tp_svc_channel_request_emit_failed ()</h3>
305 <pre class="programlisting">void tp_svc_channel_request_emit_failed (<a
306 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
307 >gpointer</a> instance,
308 const <a
309 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
310 >gchar</a> *arg_Error,
311 const <a
312 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
313 >gchar</a> *arg_Message);</pre>
314 <p>
315 Type-safe wrapper around g_signal_emit to emit the
316 Failed signal on interface org.freedesktop.Telepathy.ChannelRequest.</p>
317 <p>
318 </p>
319 <div class="variablelist"><table border="0">
320 <col align="left" valign="top">
321 <tbody>
322 <tr>
323 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
324 <td> The object implementing this interface
325 </td>
326 </tr>
327 <tr>
328 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
329 <td> const gchar * (FIXME, generate documentation)
330 </td>
331 </tr>
332 <tr>
333 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
334 <td> const gchar * (FIXME, generate documentation)
335 </td>
336 </tr>
337 </tbody>
338 </table></div>
339 </div>
340 <hr>
341 <div class="refsect2" title="tp_svc_channel_request_emit_succeeded ()">
342 <a name="tp-svc-channel-request-emit-succeeded"></a><h3>tp_svc_channel_request_emit_succeeded ()</h3>
343 <pre class="programlisting">void tp_svc_channel_request_emit_succeeded
344 (<a
345 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
346 >gpointer</a> instance);</pre>
347 <p>
348 Type-safe wrapper around g_signal_emit to emit the
349 Succeeded signal on interface org.freedesktop.Telepathy.ChannelRequest.</p>
350 <p>
351 </p>
352 <div class="variablelist"><table border="0">
353 <col align="left" valign="top">
354 <tbody><tr>
355 <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
356 <td> The object implementing this interface
357 </td>
358 </tr></tbody>
359 </table></div>
360 </div>
361 </div>
362 <div class="refsect1" title="Signal Details">
363 <a name="telepathy-glib-svc-channel-request.signal-details"></a><h2>Signal Details</h2>
364 <div class="refsect2" title='The "failed" signal'>
365 <a name="TpSvcChannelRequest-failed"></a><h3>The <code class="literal">"failed"</code> signal</h3>
366 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *arg_Error,
367 <a
368 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
369 >gchar</a> *arg_Message,
370 <a
371 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
372 >gchar</a> *arg2,
373 <a
374 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
375 >gpointer</a> user_data) : Run Last / Has Details</pre>
376 <p>
377 The Failed D-Bus signal is emitted whenever this GObject signal is.</p>
378 <p>
379 </p>
380 <div class="variablelist"><table border="0">
381 <col align="left" valign="top">
382 <tbody>
383 <tr>
384 <td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
385 <td> const gchar * (FIXME, generate documentation)
386 </td>
387 </tr>
388 <tr>
389 <td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
390 <td> const gchar * (FIXME, generate documentation)
391 </td>
392 </tr>
393 <tr>
394 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
395 <td>user data set when the signal handler was connected.</td>
396 </tr>
397 </tbody>
398 </table></div>
399 </div>
400 <hr>
401 <div class="refsect2" title='The "succeeded" signal'>
402 <a name="TpSvcChannelRequest-succeeded"></a><h3>The <code class="literal">"succeeded"</code> signal</h3>
403 <pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest">TpSvcChannelRequest</a> *arg0,
404 <a
405 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
406 >gpointer</a> user_data) : Run Last / Has Details</pre>
407 <p>
408 The Succeeded D-Bus signal is emitted whenever this GObject signal is.</p>
409 <p>
410 </p>
411 <div class="variablelist"><table border="0">
412 <col align="left" valign="top">
413 <tbody><tr>
414 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
415 <td>user data set when the signal handler was connected.</td>
416 </tr></tbody>
417 </table></div>
418 </div>
419 </div>
420 </div>
421 <div class="footer">
422 <hr>
423 Generated by GTK-Doc V1.11</div>
424 </body>
425 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Room List channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-tube.html" title="Tube channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Text channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-contactlist.html" title="Contact List channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Tube channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-tubes.html" title="Tubes channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Tubes channels</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-file-transfer.html" title="File Transfer channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side Channel base interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-generic.html" title="Generic service-side interfaces">
0 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1 <html>
2 <head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4 <title>Service-side Client interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
6 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
7 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
8 <link rel="prev" href="telepathy-glib-svc-channel-request.html" title="Service-side Channel Request interface">
9 <link rel="next" href="ch-service-base.html" title="Service-side implementation">
10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
13 <link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
14 <link rel="chapter" href="ch-client.html" title="Client-side proxies">
15 <link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
16 <link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
17 <link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
18 <link rel="chapter" href="ch-utilities.html" title="Utilities">
19 </head>
20 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
21 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22 <tr valign="middle">
23 <td><a accesskey="p" href="telepathy-glib-svc-channel-request.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
24 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
25 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
26 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="ch-service-base.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28 </tr>
29 <tr><td colspan="5" class="shortcuts">
30 <a href="#telepathy-glib-svc-client.synopsis" class="shortcut">Top</a>
31  | 
32 <a href="#telepathy-glib-svc-client.description" class="shortcut">Description</a>
33  | 
34 <a href="#telepathy-glib-svc-client.object-hierarchy" class="shortcut">Object Hierarchy</a>
35 </td></tr>
36 </table>
37 <div class="refentry" title="Service-side Client interfaces">
38 <a name="telepathy-glib-svc-client"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="telepathy-glib-svc-client.top_of_page"></a>Service-side Client interfaces</span></h2>
42 <p>Service-side Client interfaces — interfaces used to be an Observer, Approver and Handler</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv" title="Synopsis">
47 <a name="telepathy-glib-svc-client.synopsis"></a><h2>Synopsis</h2>
48 <a name="TpSvcClient"></a><a name="TpSvcClientApprover"></a><a name="TpSvcClientHandler"></a><a name="TpSvcClientInterfaceRequests"></a><a name="TpSvcClientObserver"></a><pre class="synopsis">
49
50 #include &lt;telepathy-glib/svc-client.h&gt;
51
52 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClient-struct" title="TpSvcClient">TpSvcClient</a>;
53 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientClass" title="TpSvcClientClass">TpSvcClientClass</a>;
54
55 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApprover-struct" title="TpSvcClientApprover">TpSvcClientApprover</a>;
56 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApproverClass" title="TpSvcClientApproverClass">TpSvcClientApproverClass</a>;
57 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-approver-return-from-add-dispatch-operation" title="tp_svc_client_approver_return_from_add_dispatch_operation ()">tp_svc_client_approver_return_from_add_dispatch_operation</a>
58 (<a
59 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
60 >DBusGMethodInvocation</a> *context);
61 void (<a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl" title="tp_svc_client_approver_add_dispatch_operation_impl ()">*tp_svc_client_approver_add_dispatch_operation_impl</a>)
62 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApprover">TpSvcClientApprover</a> *self,
63 const <a
64 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
65 >GPtrArray</a> *in_Channels,
66 const <a
67 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
68 >gchar</a> *in_DispatchOperation,
69 <a
70 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
71 >GHashTable</a> *in_Properties,
72 <a
73 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
74 >DBusGMethodInvocation</a> *context);
75 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-approver-implement-add-dispatch-operation" title="tp_svc_client_approver_implement_add_dispatch_operation ()">tp_svc_client_approver_implement_add_dispatch_operation</a>
76 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApproverClass" title="TpSvcClientApproverClass">TpSvcClientApproverClass</a> *klass,
77 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl" title="tp_svc_client_approver_add_dispatch_operation_impl ()">tp_svc_client_approver_add_dispatch_operation_impl</a> impl);
78
79 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandler-struct" title="TpSvcClientHandler">TpSvcClientHandler</a>;
80 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandlerClass" title="TpSvcClientHandlerClass">TpSvcClientHandlerClass</a>;
81 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-handler-return-from-handle-channels" title="tp_svc_client_handler_return_from_handle_channels ()">tp_svc_client_handler_return_from_handle_channels</a>
82 (<a
83 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
84 >DBusGMethodInvocation</a> *context);
85 void (<a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl" title="tp_svc_client_handler_handle_channels_impl ()">*tp_svc_client_handler_handle_channels_impl</a>)
86 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandler">TpSvcClientHandler</a> *self,
87 const <a
88 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
89 >gchar</a> *in_Account,
90 const <a
91 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
92 >gchar</a> *in_Connection,
93 const <a
94 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
95 >GPtrArray</a> *in_Channels,
96 const <a
97 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
98 >GPtrArray</a> *in_Requests_Satisfied,
99 <a
100 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"
101 >guint64</a> in_User_Action_Time,
102 <a
103 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
104 >GHashTable</a> *in_Handler_Info,
105 <a
106 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
107 >DBusGMethodInvocation</a> *context);
108 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-handler-implement-handle-channels" title="tp_svc_client_handler_implement_handle_channels ()">tp_svc_client_handler_implement_handle_channels</a>
109 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandlerClass" title="TpSvcClientHandlerClass">TpSvcClientHandlerClass</a> *klass,
110 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl" title="tp_svc_client_handler_handle_channels_impl ()">tp_svc_client_handler_handle_channels_impl</a> impl);
111 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests-struct" title="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</a>;
112 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass" title="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</a>;
113 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-add-request" title="tp_svc_client_interface_requests_return_from_add_request ()">tp_svc_client_interface_requests_return_from_add_request</a>
114 (<a
115 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
116 >DBusGMethodInvocation</a> *context);
117 void (<a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl" title="tp_svc_client_interface_requests_add_request_impl ()">*tp_svc_client_interface_requests_add_request_impl</a>)
118 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</a> *self,
119 const <a
120 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
121 >gchar</a> *in_Request,
122 <a
123 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
124 >GHashTable</a> *in_Properties,
125 <a
126 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
127 >DBusGMethodInvocation</a> *context);
128 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-add-request" title="tp_svc_client_interface_requests_implement_add_request ()">tp_svc_client_interface_requests_implement_add_request</a>
129 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass" title="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</a> *klass,
130 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl" title="tp_svc_client_interface_requests_add_request_impl ()">tp_svc_client_interface_requests_add_request_impl</a> impl);
131 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-remove-request" title="tp_svc_client_interface_requests_return_from_remove_request ()">tp_svc_client_interface_requests_return_from_remove_request</a>
132 (<a
133 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
134 >DBusGMethodInvocation</a> *context);
135 void (<a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl" title="tp_svc_client_interface_requests_remove_request_impl ()">*tp_svc_client_interface_requests_remove_request_impl</a>)
136 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</a> *self,
137 const <a
138 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
139 >gchar</a> *in_Request,
140 const <a
141 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
142 >gchar</a> *in_Error,
143 const <a
144 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
145 >gchar</a> *in_Message,
146 <a
147 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
148 >DBusGMethodInvocation</a> *context);
149 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-remove-request" title="tp_svc_client_interface_requests_implement_remove_request ()">tp_svc_client_interface_requests_implement_remove_request</a>
150 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass" title="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</a> *klass,
151 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl" title="tp_svc_client_interface_requests_remove_request_impl ()">tp_svc_client_interface_requests_remove_request_impl</a> impl);
152
153 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserver-struct" title="TpSvcClientObserver">TpSvcClientObserver</a>;
154 <a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserverClass" title="TpSvcClientObserverClass">TpSvcClientObserverClass</a>;
155 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-observer-return-from-observe-channels" title="tp_svc_client_observer_return_from_observe_channels ()">tp_svc_client_observer_return_from_observe_channels</a>
156 (<a
157 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
158 >DBusGMethodInvocation</a> *context);
159 void (<a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl" title="tp_svc_client_observer_observe_channels_impl ()">*tp_svc_client_observer_observe_channels_impl</a>)
160 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserver">TpSvcClientObserver</a> *self,
161 const <a
162 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
163 >gchar</a> *in_Account,
164 const <a
165 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
166 >gchar</a> *in_Connection,
167 const <a
168 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
169 >GPtrArray</a> *in_Channels,
170 const <a
171 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
172 >gchar</a> *in_Dispatch_Operation,
173 const <a
174 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
175 >GPtrArray</a> *in_Requests_Satisfied,
176 <a
177 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
178 >GHashTable</a> *in_Observer_Info,
179 <a
180 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
181 >DBusGMethodInvocation</a> *context);
182 void <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-observer-implement-observe-channels" title="tp_svc_client_observer_implement_observe_channels ()">tp_svc_client_observer_implement_observe_channels</a>
183 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserverClass" title="TpSvcClientObserverClass">TpSvcClientObserverClass</a> *klass,
184 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl" title="tp_svc_client_observer_observe_channels_impl ()">tp_svc_client_observer_observe_channels_impl</a> impl);
185 </pre>
186 </div>
187 <div class="refsect1" title="Object Hierarchy">
188 <a name="telepathy-glib-svc-client.object-hierarchy"></a><h2>Object Hierarchy</h2>
189 <pre class="synopsis">
190 GInterface
191 +----TpSvcClient
192 </pre>
193 <pre class="synopsis">
194 GInterface
195 +----TpSvcClientApprover
196 </pre>
197 <pre class="synopsis">
198 GInterface
199 +----TpSvcClientHandler
200 </pre>
201 <pre class="synopsis">
202 GInterface
203 +----TpSvcClientInterfaceRequests
204 </pre>
205 <pre class="synopsis">
206 GInterface
207 +----TpSvcClientObserver
208 </pre>
209 </div>
210 <div class="refsect1" title="Description">
211 <a name="telepathy-glib-svc-client.description"></a><h2>Description</h2>
212 <p>
213 These interfaces (auto-generated from the telepathy spec) make it easier
214 to export the objects used to implement a Telepathy client.
215 </p>
216 <p>
217 Clients such as loggers, new message notification windows and chat UIs
218 should implement some or all of the Client types (Observer, Approver and/or
219 Handler): see telepathy-spec for details.</p>
220 <p>
221 </p>
222 </div>
223 <div class="refsect1" title="Details">
224 <a name="telepathy-glib-svc-client.details"></a><h2>Details</h2>
225 <div class="refsect2" title="TpSvcClient">
226 <a name="TpSvcClient-struct"></a><h3>TpSvcClient</h3>
227 <pre class="programlisting">typedef struct _TpSvcClient TpSvcClient;</pre>
228 <p>
229 Dummy typedef representing any implementation of this interface.</p>
230 <p>
231 </p>
232 </div>
233 <hr>
234 <div class="refsect2" title="TpSvcClientClass">
235 <a name="TpSvcClientClass"></a><h3>TpSvcClientClass</h3>
236 <pre class="programlisting">typedef struct _TpSvcClientClass TpSvcClientClass;</pre>
237 <p>
238 The class of TpSvcClient.</p>
239 <p>
240 </p>
241 </div>
242 <hr>
243 <div class="refsect2" title="TpSvcClientApprover">
244 <a name="TpSvcClientApprover-struct"></a><h3>TpSvcClientApprover</h3>
245 <pre class="programlisting">typedef struct _TpSvcClientApprover TpSvcClientApprover;</pre>
246 <p>
247 Dummy typedef representing any implementation of this interface.</p>
248 <p>
249 </p>
250 </div>
251 <hr>
252 <div class="refsect2" title="TpSvcClientApproverClass">
253 <a name="TpSvcClientApproverClass"></a><h3>TpSvcClientApproverClass</h3>
254 <pre class="programlisting">typedef struct _TpSvcClientApproverClass TpSvcClientApproverClass;</pre>
255 <p>
256 The class of TpSvcClientApprover.</p>
257 <p>
258 </p>
259 </div>
260 <hr>
261 <div class="refsect2" title="tp_svc_client_approver_return_from_add_dispatch_operation ()">
262 <a name="tp-svc-client-approver-return-from-add-dispatch-operation"></a><h3>tp_svc_client_approver_return_from_add_dispatch_operation ()</h3>
263 <pre class="programlisting">void tp_svc_client_approver_return_from_add_dispatch_operation
264 (<a
265 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
266 >DBusGMethodInvocation</a> *context);</pre>
267 <p>
268 Return successfully by calling <a
269 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
270 ><code class="function">dbus_g_method_return()</code></a>.
271 This inline function exists only to provide type-safety.</p>
272 <p>
273 </p>
274 <div class="variablelist"><table border="0">
275 <col align="left" valign="top">
276 <tbody><tr>
277 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
278 <td> The D-Bus method invocation context
279 </td>
280 </tr></tbody>
281 </table></div>
282 </div>
283 <hr>
284 <div class="refsect2" title="tp_svc_client_approver_add_dispatch_operation_impl ()">
285 <a name="tp-svc-client-approver-add-dispatch-operation-impl"></a><h3>tp_svc_client_approver_add_dispatch_operation_impl ()</h3>
286 <pre class="programlisting">void (*tp_svc_client_approver_add_dispatch_operation_impl)
287 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApprover">TpSvcClientApprover</a> *self,
288 const <a
289 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
290 >GPtrArray</a> *in_Channels,
291 const <a
292 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
293 >gchar</a> *in_DispatchOperation,
294 <a
295 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
296 >GHashTable</a> *in_Properties,
297 <a
298 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
299 >DBusGMethodInvocation</a> *context);</pre>
300 <p>
301 The signature of an implementation of the D-Bus method
302 AddDispatchOperation on interface org.freedesktop.Telepathy.Client.Approver.</p>
303 <p>
304 </p>
305 <div class="variablelist"><table border="0">
306 <col align="left" valign="top">
307 <tbody>
308 <tr>
309 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
310 <td> The object implementing this interface
311 </td>
312 </tr>
313 <tr>
314 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
315 <td> const GPtrArray * (FIXME, generate documentation)
316 </td>
317 </tr>
318 <tr>
319 <td><p><span class="term"><em class="parameter"><code>in_DispatchOperation</code></em> :</span></p></td>
320 <td> const gchar * (FIXME, generate documentation)
321 </td>
322 </tr>
323 <tr>
324 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
325 <td> GHashTable * (FIXME, generate documentation)
326 </td>
327 </tr>
328 <tr>
329 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
330 <td> Used to return values or throw an error
331 </td>
332 </tr>
333 </tbody>
334 </table></div>
335 </div>
336 <hr>
337 <div class="refsect2" title="tp_svc_client_approver_implement_add_dispatch_operation ()">
338 <a name="tp-svc-client-approver-implement-add-dispatch-operation"></a><h3>tp_svc_client_approver_implement_add_dispatch_operation ()</h3>
339 <pre class="programlisting">void tp_svc_client_approver_implement_add_dispatch_operation
340 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientApproverClass" title="TpSvcClientApproverClass">TpSvcClientApproverClass</a> *klass,
341 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl" title="tp_svc_client_approver_add_dispatch_operation_impl ()">tp_svc_client_approver_add_dispatch_operation_impl</a> impl);</pre>
342 <p>
343 Register an implementation for the AddDispatchOperation method in the vtable
344 of an implementation of this interface. To be called from
345 the interface init function.</p>
346 <p>
347 </p>
348 <div class="variablelist"><table border="0">
349 <col align="left" valign="top">
350 <tbody>
351 <tr>
352 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
353 <td> A class whose instances implement this interface
354 </td>
355 </tr>
356 <tr>
357 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
358 <td> A callback used to implement the AddDispatchOperation D-Bus method
359 </td>
360 </tr>
361 </tbody>
362 </table></div>
363 </div>
364 <hr>
365 <div class="refsect2" title="TpSvcClientHandler">
366 <a name="TpSvcClientHandler-struct"></a><h3>TpSvcClientHandler</h3>
367 <pre class="programlisting">typedef struct _TpSvcClientHandler TpSvcClientHandler;</pre>
368 <p>
369 Dummy typedef representing any implementation of this interface.</p>
370 <p>
371 </p>
372 </div>
373 <hr>
374 <div class="refsect2" title="TpSvcClientHandlerClass">
375 <a name="TpSvcClientHandlerClass"></a><h3>TpSvcClientHandlerClass</h3>
376 <pre class="programlisting">typedef struct _TpSvcClientHandlerClass TpSvcClientHandlerClass;</pre>
377 <p>
378 The class of TpSvcClientHandler.</p>
379 <p>
380 </p>
381 </div>
382 <hr>
383 <div class="refsect2" title="tp_svc_client_handler_return_from_handle_channels ()">
384 <a name="tp-svc-client-handler-return-from-handle-channels"></a><h3>tp_svc_client_handler_return_from_handle_channels ()</h3>
385 <pre class="programlisting">void tp_svc_client_handler_return_from_handle_channels
386 (<a
387 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
388 >DBusGMethodInvocation</a> *context);</pre>
389 <p>
390 Return successfully by calling <a
391 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
392 ><code class="function">dbus_g_method_return()</code></a>.
393 This inline function exists only to provide type-safety.</p>
394 <p>
395 </p>
396 <div class="variablelist"><table border="0">
397 <col align="left" valign="top">
398 <tbody><tr>
399 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
400 <td> The D-Bus method invocation context
401 </td>
402 </tr></tbody>
403 </table></div>
404 </div>
405 <hr>
406 <div class="refsect2" title="tp_svc_client_handler_handle_channels_impl ()">
407 <a name="tp-svc-client-handler-handle-channels-impl"></a><h3>tp_svc_client_handler_handle_channels_impl ()</h3>
408 <pre class="programlisting">void (*tp_svc_client_handler_handle_channels_impl)
409 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandler">TpSvcClientHandler</a> *self,
410 const <a
411 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
412 >gchar</a> *in_Account,
413 const <a
414 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
415 >gchar</a> *in_Connection,
416 const <a
417 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
418 >GPtrArray</a> *in_Channels,
419 const <a
420 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
421 >GPtrArray</a> *in_Requests_Satisfied,
422 <a
423 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"
424 >guint64</a> in_User_Action_Time,
425 <a
426 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
427 >GHashTable</a> *in_Handler_Info,
428 <a
429 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
430 >DBusGMethodInvocation</a> *context);</pre>
431 <p>
432 The signature of an implementation of the D-Bus method
433 HandleChannels on interface org.freedesktop.Telepathy.Client.Handler.</p>
434 <p>
435 </p>
436 <div class="variablelist"><table border="0">
437 <col align="left" valign="top">
438 <tbody>
439 <tr>
440 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
441 <td> The object implementing this interface
442 </td>
443 </tr>
444 <tr>
445 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
446 <td> const gchar * (FIXME, generate documentation)
447 </td>
448 </tr>
449 <tr>
450 <td><p><span class="term"><em class="parameter"><code>in_Connection</code></em> :</span></p></td>
451 <td> const gchar * (FIXME, generate documentation)
452 </td>
453 </tr>
454 <tr>
455 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
456 <td> const GPtrArray * (FIXME, generate documentation)
457 </td>
458 </tr>
459 <tr>
460 <td><p><span class="term"><em class="parameter"><code>in_Requests_Satisfied</code></em> :</span></p></td>
461 <td> const GPtrArray * (FIXME, generate documentation)
462 </td>
463 </tr>
464 <tr>
465 <td><p><span class="term"><em class="parameter"><code>in_User_Action_Time</code></em> :</span></p></td>
466 <td> guint64 (FIXME, generate documentation)
467 </td>
468 </tr>
469 <tr>
470 <td><p><span class="term"><em class="parameter"><code>in_Handler_Info</code></em> :</span></p></td>
471 <td> GHashTable * (FIXME, generate documentation)
472 </td>
473 </tr>
474 <tr>
475 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
476 <td> Used to return values or throw an error
477 </td>
478 </tr>
479 </tbody>
480 </table></div>
481 </div>
482 <hr>
483 <div class="refsect2" title="tp_svc_client_handler_implement_handle_channels ()">
484 <a name="tp-svc-client-handler-implement-handle-channels"></a><h3>tp_svc_client_handler_implement_handle_channels ()</h3>
485 <pre class="programlisting">void tp_svc_client_handler_implement_handle_channels
486 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientHandlerClass" title="TpSvcClientHandlerClass">TpSvcClientHandlerClass</a> *klass,
487 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl" title="tp_svc_client_handler_handle_channels_impl ()">tp_svc_client_handler_handle_channels_impl</a> impl);</pre>
488 <p>
489 Register an implementation for the HandleChannels method in the vtable
490 of an implementation of this interface. To be called from
491 the interface init function.</p>
492 <p>
493 </p>
494 <div class="variablelist"><table border="0">
495 <col align="left" valign="top">
496 <tbody>
497 <tr>
498 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
499 <td> A class whose instances implement this interface
500 </td>
501 </tr>
502 <tr>
503 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
504 <td> A callback used to implement the HandleChannels D-Bus method
505 </td>
506 </tr>
507 </tbody>
508 </table></div>
509 </div>
510 <hr>
511 <div class="refsect2" title="TpSvcClientInterfaceRequests">
512 <a name="TpSvcClientInterfaceRequests-struct"></a><h3>TpSvcClientInterfaceRequests</h3>
513 <pre class="programlisting">typedef struct _TpSvcClientInterfaceRequests TpSvcClientInterfaceRequests;</pre>
514 <p>
515 Dummy typedef representing any implementation of this interface.</p>
516 <p>
517 </p>
518 </div>
519 <hr>
520 <div class="refsect2" title="TpSvcClientInterfaceRequestsClass">
521 <a name="TpSvcClientInterfaceRequestsClass"></a><h3>TpSvcClientInterfaceRequestsClass</h3>
522 <pre class="programlisting">typedef struct _TpSvcClientInterfaceRequestsClass TpSvcClientInterfaceRequestsClass;</pre>
523 <p>
524 The class of TpSvcClientInterfaceRequests.</p>
525 <p>
526 </p>
527 </div>
528 <hr>
529 <div class="refsect2" title="tp_svc_client_interface_requests_return_from_add_request ()">
530 <a name="tp-svc-client-interface-requests-return-from-add-request"></a><h3>tp_svc_client_interface_requests_return_from_add_request ()</h3>
531 <pre class="programlisting">void tp_svc_client_interface_requests_return_from_add_request
532 (<a
533 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
534 >DBusGMethodInvocation</a> *context);</pre>
535 <p>
536 Return successfully by calling <a
537 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
538 ><code class="function">dbus_g_method_return()</code></a>.
539 This inline function exists only to provide type-safety.</p>
540 <p>
541 </p>
542 <div class="variablelist"><table border="0">
543 <col align="left" valign="top">
544 <tbody><tr>
545 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
546 <td> The D-Bus method invocation context
547 </td>
548 </tr></tbody>
549 </table></div>
550 </div>
551 <hr>
552 <div class="refsect2" title="tp_svc_client_interface_requests_add_request_impl ()">
553 <a name="tp-svc-client-interface-requests-add-request-impl"></a><h3>tp_svc_client_interface_requests_add_request_impl ()</h3>
554 <pre class="programlisting">void (*tp_svc_client_interface_requests_add_request_impl)
555 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</a> *self,
556 const <a
557 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
558 >gchar</a> *in_Request,
559 <a
560 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
561 >GHashTable</a> *in_Properties,
562 <a
563 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
564 >DBusGMethodInvocation</a> *context);</pre>
565 <p>
566 The signature of an implementation of the D-Bus method
567 AddRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.</p>
568 <p>
569 </p>
570 <div class="variablelist"><table border="0">
571 <col align="left" valign="top">
572 <tbody>
573 <tr>
574 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
575 <td> The object implementing this interface
576 </td>
577 </tr>
578 <tr>
579 <td><p><span class="term"><em class="parameter"><code>in_Request</code></em> :</span></p></td>
580 <td> const gchar * (FIXME, generate documentation)
581 </td>
582 </tr>
583 <tr>
584 <td><p><span class="term"><em class="parameter"><code>in_Properties</code></em> :</span></p></td>
585 <td> GHashTable * (FIXME, generate documentation)
586 </td>
587 </tr>
588 <tr>
589 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
590 <td> Used to return values or throw an error
591 </td>
592 </tr>
593 </tbody>
594 </table></div>
595 </div>
596 <hr>
597 <div class="refsect2" title="tp_svc_client_interface_requests_implement_add_request ()">
598 <a name="tp-svc-client-interface-requests-implement-add-request"></a><h3>tp_svc_client_interface_requests_implement_add_request ()</h3>
599 <pre class="programlisting">void tp_svc_client_interface_requests_implement_add_request
600 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass" title="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</a> *klass,
601 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl" title="tp_svc_client_interface_requests_add_request_impl ()">tp_svc_client_interface_requests_add_request_impl</a> impl);</pre>
602 <p>
603 Register an implementation for the AddRequest method in the vtable
604 of an implementation of this interface. To be called from
605 the interface init function.</p>
606 <p>
607 </p>
608 <div class="variablelist"><table border="0">
609 <col align="left" valign="top">
610 <tbody>
611 <tr>
612 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
613 <td> A class whose instances implement this interface
614 </td>
615 </tr>
616 <tr>
617 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
618 <td> A callback used to implement the AddRequest D-Bus method
619 </td>
620 </tr>
621 </tbody>
622 </table></div>
623 </div>
624 <hr>
625 <div class="refsect2" title="tp_svc_client_interface_requests_return_from_remove_request ()">
626 <a name="tp-svc-client-interface-requests-return-from-remove-request"></a><h3>tp_svc_client_interface_requests_return_from_remove_request ()</h3>
627 <pre class="programlisting">void tp_svc_client_interface_requests_return_from_remove_request
628 (<a
629 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
630 >DBusGMethodInvocation</a> *context);</pre>
631 <p>
632 Return successfully by calling <a
633 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
634 ><code class="function">dbus_g_method_return()</code></a>.
635 This inline function exists only to provide type-safety.</p>
636 <p>
637 </p>
638 <div class="variablelist"><table border="0">
639 <col align="left" valign="top">
640 <tbody><tr>
641 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
642 <td> The D-Bus method invocation context
643 </td>
644 </tr></tbody>
645 </table></div>
646 </div>
647 <hr>
648 <div class="refsect2" title="tp_svc_client_interface_requests_remove_request_impl ()">
649 <a name="tp-svc-client-interface-requests-remove-request-impl"></a><h3>tp_svc_client_interface_requests_remove_request_impl ()</h3>
650 <pre class="programlisting">void (*tp_svc_client_interface_requests_remove_request_impl)
651 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</a> *self,
652 const <a
653 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
654 >gchar</a> *in_Request,
655 const <a
656 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
657 >gchar</a> *in_Error,
658 const <a
659 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
660 >gchar</a> *in_Message,
661 <a
662 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
663 >DBusGMethodInvocation</a> *context);</pre>
664 <p>
665 The signature of an implementation of the D-Bus method
666 RemoveRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.</p>
667 <p>
668 </p>
669 <div class="variablelist"><table border="0">
670 <col align="left" valign="top">
671 <tbody>
672 <tr>
673 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
674 <td> The object implementing this interface
675 </td>
676 </tr>
677 <tr>
678 <td><p><span class="term"><em class="parameter"><code>in_Request</code></em> :</span></p></td>
679 <td> const gchar * (FIXME, generate documentation)
680 </td>
681 </tr>
682 <tr>
683 <td><p><span class="term"><em class="parameter"><code>in_Error</code></em> :</span></p></td>
684 <td> const gchar * (FIXME, generate documentation)
685 </td>
686 </tr>
687 <tr>
688 <td><p><span class="term"><em class="parameter"><code>in_Message</code></em> :</span></p></td>
689 <td> const gchar * (FIXME, generate documentation)
690 </td>
691 </tr>
692 <tr>
693 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
694 <td> Used to return values or throw an error
695 </td>
696 </tr>
697 </tbody>
698 </table></div>
699 </div>
700 <hr>
701 <div class="refsect2" title="tp_svc_client_interface_requests_implement_remove_request ()">
702 <a name="tp-svc-client-interface-requests-implement-remove-request"></a><h3>tp_svc_client_interface_requests_implement_remove_request ()</h3>
703 <pre class="programlisting">void tp_svc_client_interface_requests_implement_remove_request
704 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass" title="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</a> *klass,
705 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl" title="tp_svc_client_interface_requests_remove_request_impl ()">tp_svc_client_interface_requests_remove_request_impl</a> impl);</pre>
706 <p>
707 Register an implementation for the RemoveRequest method in the vtable
708 of an implementation of this interface. To be called from
709 the interface init function.</p>
710 <p>
711 </p>
712 <div class="variablelist"><table border="0">
713 <col align="left" valign="top">
714 <tbody>
715 <tr>
716 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
717 <td> A class whose instances implement this interface
718 </td>
719 </tr>
720 <tr>
721 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
722 <td> A callback used to implement the RemoveRequest D-Bus method
723 </td>
724 </tr>
725 </tbody>
726 </table></div>
727 </div>
728 <hr>
729 <div class="refsect2" title="TpSvcClientObserver">
730 <a name="TpSvcClientObserver-struct"></a><h3>TpSvcClientObserver</h3>
731 <pre class="programlisting">typedef struct _TpSvcClientObserver TpSvcClientObserver;</pre>
732 <p>
733 Dummy typedef representing any implementation of this interface.</p>
734 <p>
735 </p>
736 </div>
737 <hr>
738 <div class="refsect2" title="TpSvcClientObserverClass">
739 <a name="TpSvcClientObserverClass"></a><h3>TpSvcClientObserverClass</h3>
740 <pre class="programlisting">typedef struct _TpSvcClientObserverClass TpSvcClientObserverClass;</pre>
741 <p>
742 The class of TpSvcClientObserver.</p>
743 <p>
744 </p>
745 </div>
746 <hr>
747 <div class="refsect2" title="tp_svc_client_observer_return_from_observe_channels ()">
748 <a name="tp-svc-client-observer-return-from-observe-channels"></a><h3>tp_svc_client_observer_return_from_observe_channels ()</h3>
749 <pre class="programlisting">void tp_svc_client_observer_return_from_observe_channels
750 (<a
751 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
752 >DBusGMethodInvocation</a> *context);</pre>
753 <p>
754 Return successfully by calling <a
755 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#dbus-g-method-return"
756 ><code class="function">dbus_g_method_return()</code></a>.
757 This inline function exists only to provide type-safety.</p>
758 <p>
759 </p>
760 <div class="variablelist"><table border="0">
761 <col align="left" valign="top">
762 <tbody><tr>
763 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
764 <td> The D-Bus method invocation context
765 </td>
766 </tr></tbody>
767 </table></div>
768 </div>
769 <hr>
770 <div class="refsect2" title="tp_svc_client_observer_observe_channels_impl ()">
771 <a name="tp-svc-client-observer-observe-channels-impl"></a><h3>tp_svc_client_observer_observe_channels_impl ()</h3>
772 <pre class="programlisting">void (*tp_svc_client_observer_observe_channels_impl)
773 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserver">TpSvcClientObserver</a> *self,
774 const <a
775 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
776 >gchar</a> *in_Account,
777 const <a
778 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
779 >gchar</a> *in_Connection,
780 const <a
781 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
782 >GPtrArray</a> *in_Channels,
783 const <a
784 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
785 >gchar</a> *in_Dispatch_Operation,
786 const <a
787 href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"
788 >GPtrArray</a> *in_Requests_Satisfied,
789 <a
790 href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
791 >GHashTable</a> *in_Observer_Info,
792 <a
793 href="/usr/share/gtk-doc/html/dbus-glib/dbus-glib-DBusGMethod.html#DBusGMethodInvocation"
794 >DBusGMethodInvocation</a> *context);</pre>
795 <p>
796 The signature of an implementation of the D-Bus method
797 ObserveChannels on interface org.freedesktop.Telepathy.Client.Observer.</p>
798 <p>
799 </p>
800 <div class="variablelist"><table border="0">
801 <col align="left" valign="top">
802 <tbody>
803 <tr>
804 <td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
805 <td> The object implementing this interface
806 </td>
807 </tr>
808 <tr>
809 <td><p><span class="term"><em class="parameter"><code>in_Account</code></em> :</span></p></td>
810 <td> const gchar * (FIXME, generate documentation)
811 </td>
812 </tr>
813 <tr>
814 <td><p><span class="term"><em class="parameter"><code>in_Connection</code></em> :</span></p></td>
815 <td> const gchar * (FIXME, generate documentation)
816 </td>
817 </tr>
818 <tr>
819 <td><p><span class="term"><em class="parameter"><code>in_Channels</code></em> :</span></p></td>
820 <td> const GPtrArray * (FIXME, generate documentation)
821 </td>
822 </tr>
823 <tr>
824 <td><p><span class="term"><em class="parameter"><code>in_Dispatch_Operation</code></em> :</span></p></td>
825 <td> const gchar * (FIXME, generate documentation)
826 </td>
827 </tr>
828 <tr>
829 <td><p><span class="term"><em class="parameter"><code>in_Requests_Satisfied</code></em> :</span></p></td>
830 <td> const GPtrArray * (FIXME, generate documentation)
831 </td>
832 </tr>
833 <tr>
834 <td><p><span class="term"><em class="parameter"><code>in_Observer_Info</code></em> :</span></p></td>
835 <td> GHashTable * (FIXME, generate documentation)
836 </td>
837 </tr>
838 <tr>
839 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
840 <td> Used to return values or throw an error
841 </td>
842 </tr>
843 </tbody>
844 </table></div>
845 </div>
846 <hr>
847 <div class="refsect2" title="tp_svc_client_observer_implement_observe_channels ()">
848 <a name="tp-svc-client-observer-implement-observe-channels"></a><h3>tp_svc_client_observer_implement_observe_channels ()</h3>
849 <pre class="programlisting">void tp_svc_client_observer_implement_observe_channels
850 (<a class="link" href="telepathy-glib-svc-client.html#TpSvcClientObserverClass" title="TpSvcClientObserverClass">TpSvcClientObserverClass</a> *klass,
851 <a class="link" href="telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl" title="tp_svc_client_observer_observe_channels_impl ()">tp_svc_client_observer_observe_channels_impl</a> impl);</pre>
852 <p>
853 Register an implementation for the ObserveChannels method in the vtable
854 of an implementation of this interface. To be called from
855 the interface init function.</p>
856 <p>
857 </p>
858 <div class="variablelist"><table border="0">
859 <col align="left" valign="top">
860 <tbody>
861 <tr>
862 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
863 <td> A class whose instances implement this interface
864 </td>
865 </tr>
866 <tr>
867 <td><p><span class="term"><em class="parameter"><code>impl</code></em> :</span></p></td>
868 <td> A callback used to implement the ObserveChannels D-Bus method
869 </td>
870 </tr>
871 </tbody>
872 </table></div>
873 </div>
874 </div>
875 </div>
876 <div class="footer">
877 <hr>
878 Generated by GTK-Doc V1.11</div>
879 </body>
880 </html>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side Connection Manager interface</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-media-interfaces.html" title="Service-side media streaming helper interfaces">
9 <link rel="next" href="ch-service-base.html" title="Service-side implementation">
9 <link rel="next" href="telepathy-glib-svc-account-manager.html" title="Service-side Account Manager interface">
1010 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
1111 <link rel="stylesheet" href="style.css" type="text/css">
1212 <link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
2424 <td><a accesskey="u" href="ch-service-dbus.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
2525 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
2626 <th width="100%" align="center">telepathy-glib Reference Manual</th>
27 <td><a accesskey="n" href="ch-service-base.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
27 <td><a accesskey="n" href="telepathy-glib-svc-account-manager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
2828 </tr>
2929 <tr><td colspan="5" class="shortcuts">
3030 <a href="#telepathy-glib-svc-connection-manager.synopsis" class="shortcut">Top</a>
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side Connection interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-channel-roomlist.html" title="Room List channels">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Generic service-side interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc.html" title="The TpSvc* interfaces">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Service-side media streaming helper interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="telepathy-glib-svc-connection.html" title="Service-side Connection interfaces">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>The TpSvc* interfaces</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
88 <link rel="prev" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
22 <head>
33 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
44 <title>Utilities</title>
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.0">
5 <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
66 <link rel="home" href="index.html" title="telepathy-glib Reference Manual">
77 <link rel="up" href="ch-utilities.html" title="Utilities">
88 <link rel="prev" href="ch-utilities.html" title="Utilities">
3838 <sub name="Tube channels" link="telepathy-glib-channel-tube.html"/>
3939 <sub name="Room List channels" link="telepathy-glib-channel-roomlist.html"/>
4040 <sub name="TpMediaSessionHandler, TpMediaStreamHandler" link="telepathy-glib-media-interfaces.html"/>
41 <sub name="TpAccountManager" link="telepathy-glib-account-manager.html"/>
42 <sub name="TpAccount" link="telepathy-glib-account.html"/>
43 <sub name="TpChannelDispatcher" link="telepathy-glib-channel-dispatcher.html"/>
44 <sub name="TpChannelDispatchOperation" link="telepathy-glib-channel-dispatch-operation.html"/>
45 <sub name="TpChannelRequest" link="telepathy-glib-channel-request.html"/>
46 <sub name="TpClient" link="telepathy-glib-client.html"/>
4147 </sub>
4248 <sub name="Service-side D-Bus interfaces" link="ch-service-dbus.html">
4349 <sub name="&#10; The TpSvc* interfaces&#10; " link="telepathy-glib-svc.html"/>
5460 <sub name="Service-side Connection interfaces" link="telepathy-glib-svc-connection.html"/>
5561 <sub name="Service-side media streaming helper interfaces" link="telepathy-glib-svc-media-interfaces.html"/>
5662 <sub name="Service-side Connection Manager interface" link="telepathy-glib-svc-connection-manager.html"/>
63 <sub name="Service-side Account Manager interface" link="telepathy-glib-svc-account-manager.html"/>
64 <sub name="Service-side Account interfaces" link="telepathy-glib-svc-account.html"/>
65 <sub name="Service-side Channel Dispatcher interface" link="telepathy-glib-svc-channel-dispatcher.html"/>
66 <sub name="Service-side Channel Dispatch Operation interface" link="telepathy-glib-svc-channel-dispatch-operation.html"/>
67 <sub name="Service-side Channel Request interface" link="telepathy-glib-svc-channel-request.html"/>
68 <sub name="Service-side Client interfaces" link="telepathy-glib-svc-client.html"/>
5769 </sub>
5870 <sub name="Service-side implementation" link="ch-service-base.html">
5971 <sub name="Connection manager life cycle" link="telepathy-glib-run.html"/>
160172 <function name="tp_dbus_daemon_release_name ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-release-name"/>
161173 <function name="tp_dbus_daemon_request_name ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-request-name"/>
162174 <function name="tp_dbus_daemon_watch_name_owner ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-watch-name-owner"/>
175 <function name="tp_dbus_daemon_init_known_interfaces ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-init-known-interfaces"/>
163176 <function name="tp_cli_dbus_daemon_call_add_match ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-add-match"/>
164177 <function name="tp_cli_dbus_daemon_call_get_connection_se_linux_security_context ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-se-linux-security-context"/>
165178 <function name="tp_cli_dbus_daemon_call_get_connection_unix_process_id ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-unix-process-id"/>
266279 <function name="TP_CM_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CM-OBJECT-PATH-BASE--CAPS"/>
267280 <function name="TP_CONN_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CONN-BUS-NAME-BASE--CAPS"/>
268281 <function name="TP_CONN_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CONN-OBJECT-PATH-BASE--CAPS"/>
282 <function name="TP_ACCOUNT_MANAGER_BUS_NAME" link="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-BUS-NAME--CAPS"/>
283 <function name="TP_ACCOUNT_MANAGER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS"/>
284 <function name="TP_ACCOUNT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-ACCOUNT-OBJECT-PATH-BASE--CAPS"/>
285 <function name="TP_CHANNEL_DISPATCHER_BUS_NAME" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS"/>
286 <function name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS"/>
287 <function name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE--CAPS"/>
288 <function name="TP_CLIENT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE--CAPS"/>
269289 <function name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/>
270290 <function name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE--CAPS"/>
271291 <function name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE--CAPS"/>
272292 <function name="tp_handle_type_is_valid ()" link="telepathy-glib-handle.html#tp-handle-type-is-valid"/>
273293 <function name="tp_handle_type_to_string ()" link="telepathy-glib-handle.html#tp-handle-type-to-string"/>
294 <function name="TP_IFACE_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT--CAPS"/>
295 <function name="TP_IFACE_QUARK_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT--CAPS"/>
296 <function name="TP_IFACE_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS"/>
297 <function name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS"/>
298 <function name="TP_IFACE_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER--CAPS"/>
299 <function name="TP_IFACE_QUARK_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS"/>
274300 <function name="TP_IFACE_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON--CAPS"/>
275301 <function name="TP_IFACE_QUARK_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-DBUS-DAEMON--CAPS"/>
276302 <function name="TP_IFACE_DBUS_INTROSPECTABLE" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-INTROSPECTABLE--CAPS"/>
335361 <function name="TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS"/>
336362 <function name="TP_IFACE_CHANNEL_INTERFACE_MESSAGES" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS"/>
337363 <function name="TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS"/>
364 <function name="TP_IFACE_CHANNEL_DISPATCHER" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER--CAPS"/>
365 <function name="TP_IFACE_QUARK_CHANNEL_DISPATCHER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS"/>
366 <function name="TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"/>
367 <function name="TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"/>
368 <function name="TP_IFACE_CHANNEL_DISPATCH_OPERATION" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS"/>
369 <function name="TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS"/>
370 <function name="TP_IFACE_CHANNEL_REQUEST" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-REQUEST--CAPS"/>
371 <function name="TP_IFACE_QUARK_CHANNEL_REQUEST" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS"/>
338372 <function name="TP_IFACE_MEDIA_SESSION_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-SESSION-HANDLER--CAPS"/>
339373 <function name="TP_IFACE_QUARK_MEDIA_SESSION_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS"/>
340374 <function name="TP_IFACE_MEDIA_STREAM_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-STREAM-HANDLER--CAPS"/>
341375 <function name="TP_IFACE_QUARK_MEDIA_STREAM_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS"/>
342376 <function name="TP_IFACE_PROPERTIES_INTERFACE" link="telepathy-glib-interfaces.html#TP-IFACE-PROPERTIES-INTERFACE--CAPS"/>
343377 <function name="TP_IFACE_QUARK_PROPERTIES_INTERFACE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS"/>
378 <function name="TP_IFACE_CLIENT" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT--CAPS"/>
379 <function name="TP_IFACE_QUARK_CLIENT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT--CAPS"/>
380 <function name="TP_IFACE_CLIENT_APPROVER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-APPROVER--CAPS"/>
381 <function name="TP_IFACE_QUARK_CLIENT_APPROVER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-APPROVER--CAPS"/>
382 <function name="TP_IFACE_CLIENT_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-HANDLER--CAPS"/>
383 <function name="TP_IFACE_QUARK_CLIENT_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-HANDLER--CAPS"/>
384 <function name="TP_IFACE_CLIENT_OBSERVER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-OBSERVER--CAPS"/>
385 <function name="TP_IFACE_QUARK_CLIENT_OBSERVER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS"/>
386 <function name="TP_IFACE_CLIENT_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS"/>
387 <function name="TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS"/>
344388 <function name="enum TpHandleType" link="telepathy-glib-enums.html#TpHandleType"/>
345389 <function name="NUM_TP_HANDLE_TYPES" link="telepathy-glib-enums.html#NUM-TP-HANDLE-TYPES--CAPS"/>
346390 <function name="enum TpConnMgrParamFlags" link="telepathy-glib-enums.html#TpConnMgrParamFlags"/>
527571 <function name="TP_HASH_TYPE_CHANNEL_CALL_STATE_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS"/>
528572 <function name="TP_ARRAY_TYPE_ROOM_INFO_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS"/>
529573 <function name="TP_STRUCT_TYPE_ROOM_INFO" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ROOM-INFO--CAPS"/>
574 <function name="TP_STRUCT_TYPE_AVATAR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-AVATAR--CAPS"/>
575 <function name="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"/>
576 <function name="TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"/>
530577 <function name="TpChannelFunc ()" link="TpChannelIface.html#TpChannelFunc"/>
531578 <function name="TpChannelIface" link="TpChannelIface.html#TpChannelIface-struct"/>
532579 <function name="TpChannelIfaceClass" link="TpChannelIface.html#TpChannelIfaceClass"/>
565612 <function name="tp_connection_manager_param_get_default ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-param-get-default"/>
566613 <function name="tp_connection_manager_check_valid_name ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-name"/>
567614 <function name="tp_connection_manager_check_valid_protocol_name ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-protocol-name"/>
615 <function name="tp_connection_manager_init_known_interfaces ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-init-known-interfaces"/>
568616 <function name="tp_cli_connection_manager_callback_for_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-callback-for-get-parameters"/>
569617 <function name="tp_cli_connection_manager_call_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-call-get-parameters"/>
570618 <function name="tp_cli_connection_manager_run_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-run-get-parameters"/>
10461094 <function name="tp_cli_channel_type_room_list_signal_callback_got_rooms ()" link="telepathy-glib-channel-roomlist.html#tp-cli-channel-type-room-list-signal-callback-got-rooms"/>
10471095 <function name="tp_cli_channel_type_room_list_signal_callback_listing_rooms ()" link="telepathy-glib-channel-roomlist.html#tp-cli-channel-type-room-list-signal-callback-listing-rooms"/>
10481096 <function name="tp_media_session_handler_new ()" link="telepathy-glib-media-interfaces.html#tp-media-session-handler-new"/>
1097 <function name="tp_media_session_handler_init_known_interfaces ()" link="telepathy-glib-media-interfaces.html#tp-media-session-handler-init-known-interfaces"/>
10491098 <function name="TpMediaSessionHandler" link="telepathy-glib-media-interfaces.html#TpMediaSessionHandler-struct"/>
10501099 <function name="TpMediaSessionHandlerClass" link="telepathy-glib-media-interfaces.html#TpMediaSessionHandlerClass"/>
10511100 <function name="tp_media_stream_handler_new ()" link="telepathy-glib-media-interfaces.html#tp-media-stream-handler-new"/>
1101 <function name="tp_media_stream_handler_init_known_interfaces ()" link="telepathy-glib-media-interfaces.html#tp-media-stream-handler-init-known-interfaces"/>
10521102 <function name="TpMediaStreamHandler" link="telepathy-glib-media-interfaces.html#TpMediaStreamHandler-struct"/>
10531103 <function name="TpMediaStreamHandlerClass" link="telepathy-glib-media-interfaces.html#TpMediaStreamHandlerClass"/>
10541104 <function name="tp_cli_media_session_handler_callback_for_error ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-session-handler-callback-for-error"/>
11171167 <function name="tp_cli_media_stream_handler_call_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-call-codecs-updated"/>
11181168 <function name="tp_cli_media_stream_handler_callback_for_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-callback-for-codecs-updated"/>
11191169 <function name="tp_cli_media_stream_handler_run_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-run-codecs-updated"/>
1170 <function name="TpAccountManager" link="telepathy-glib-account-manager.html#TpAccountManager-struct"/>
1171 <function name="TpAccountManagerClass" link="telepathy-glib-account-manager.html#TpAccountManagerClass"/>
1172 <function name="tp_account_manager_new ()" link="telepathy-glib-account-manager.html#tp-account-manager-new"/>
1173 <function name="tp_account_manager_init_known_interfaces ()" link="telepathy-glib-account-manager.html#tp-account-manager-init-known-interfaces"/>
1174 <function name="tp_cli_account_manager_callback_for_create_account ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account"/>
1175 <function name="tp_cli_account_manager_call_create_account ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-call-create-account"/>
1176 <function name="tp_cli_account_manager_signal_callback_account_removed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed"/>
1177 <function name="tp_cli_account_manager_connect_to_account_removed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-removed"/>
1178 <function name="tp_cli_account_manager_signal_callback_account_validity_changed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed"/>
1179 <function name="tp_cli_account_manager_connect_to_account_validity_changed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-validity-changed"/>
1180 <function name="TpAccount" link="telepathy-glib-account.html#TpAccount-struct"/>
1181 <function name="TpAccountClass" link="telepathy-glib-account.html#TpAccountClass"/>
1182 <function name="tp_account_new ()" link="telepathy-glib-account.html#tp-account-new"/>
1183 <function name="tp_account_init_known_interfaces ()" link="telepathy-glib-account.html#tp-account-init-known-interfaces"/>
1184 <function name="tp_cli_account_callback_for_reconnect ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect"/>
1185 <function name="tp_cli_account_call_reconnect ()" link="telepathy-glib-account.html#tp-cli-account-call-reconnect"/>
1186 <function name="tp_cli_account_callback_for_remove ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-remove"/>
1187 <function name="tp_cli_account_call_remove ()" link="telepathy-glib-account.html#tp-cli-account-call-remove"/>
1188 <function name="tp_cli_account_callback_for_update_parameters ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters"/>
1189 <function name="tp_cli_account_call_update_parameters ()" link="telepathy-glib-account.html#tp-cli-account-call-update-parameters"/>
1190 <function name="tp_cli_account_signal_callback_account_property_changed ()" link="telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed"/>
1191 <function name="tp_cli_account_connect_to_account_property_changed ()" link="telepathy-glib-account.html#tp-cli-account-connect-to-account-property-changed"/>
1192 <function name="tp_cli_account_signal_callback_removed ()" link="telepathy-glib-account.html#tp-cli-account-signal-callback-removed"/>
1193 <function name="tp_cli_account_connect_to_removed ()" link="telepathy-glib-account.html#tp-cli-account-connect-to-removed"/>
1194 <function name="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()" link="telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed"/>
1195 <function name="tp_cli_account_interface_avatar_connect_to_avatar_changed ()" link="telepathy-glib-account.html#tp-cli-account-interface-avatar-connect-to-avatar-changed"/>
1196 <function name="TpChannelDispatcher" link="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher-struct"/>
1197 <function name="TpChannelDispatcherClass" link="telepathy-glib-channel-dispatcher.html#TpChannelDispatcherClass"/>
1198 <function name="tp_channel_dispatcher_new ()" link="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-new"/>
1199 <function name="tp_channel_dispatcher_init_known_interfaces ()" link="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-init-known-interfaces"/>
1200 <function name="tp_cli_channel_dispatcher_callback_for_create_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel"/>
1201 <function name="tp_cli_channel_dispatcher_call_create_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-create-channel"/>
1202 <function name="tp_cli_channel_dispatcher_callback_for_ensure_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel"/>
1203 <function name="tp_cli_channel_dispatcher_call_ensure_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-ensure-channel"/>
1204 <function name="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished"/>
1205 <function name="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"/>
1206 <function name="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation"/>
1207 <function name="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"/>
1208 <function name="struct TpChannelDispatchOperation" link="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-struct"/>
1209 <function name="struct TpChannelDispatchOperationClass" link="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperationClass"/>
1210 <function name="tp_channel_dispatch_operation_new ()" link="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-new"/>
1211 <function name="tp_channel_dispatch_operation_init_known_interfaces ()" link="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-init-known-interfaces"/>
1212 <function name="tp_cli_channel_dispatch_operation_callback_for_claim ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim"/>
1213 <function name="tp_cli_channel_dispatch_operation_call_claim ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim"/>
1214 <function name="tp_cli_channel_dispatch_operation_callback_for_handle_with ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with"/>
1215 <function name="tp_cli_channel_dispatch_operation_call_handle_with ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with"/>
1216 <function name="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost"/>
1217 <function name="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost"/>
1218 <function name="tp_cli_channel_dispatch_operation_signal_callback_finished ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished"/>
1219 <function name="tp_cli_channel_dispatch_operation_connect_to_finished ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished"/>
1220 <function name="TpChannelRequest" link="telepathy-glib-channel-request.html#TpChannelRequest-struct"/>
1221 <function name="TpChannelRequestClass" link="telepathy-glib-channel-request.html#TpChannelRequestClass"/>
1222 <function name="tp_channel_request_new ()" link="telepathy-glib-channel-request.html#tp-channel-request-new"/>
1223 <function name="tp_channel_request_init_known_interfaces ()" link="telepathy-glib-channel-request.html#tp-channel-request-init-known-interfaces"/>
1224 <function name="tp_cli_channel_request_callback_for_cancel ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel"/>
1225 <function name="tp_cli_channel_request_call_cancel ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-call-cancel"/>
1226 <function name="tp_cli_channel_request_callback_for_proceed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed"/>
1227 <function name="tp_cli_channel_request_call_proceed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-call-proceed"/>
1228 <function name="tp_cli_channel_request_signal_callback_failed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed"/>
1229 <function name="tp_cli_channel_request_connect_to_failed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-failed"/>
1230 <function name="tp_cli_channel_request_signal_callback_succeeded ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded"/>
1231 <function name="tp_cli_channel_request_connect_to_succeeded ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-succeeded"/>
1232 <function name="The &quot;succeeded&quot; signal" link="telepathy-glib-channel-request.html#TpChannelRequest-succeeded"/>
1233 <function name="TpClient" link="telepathy-glib-client.html#TpClient-struct"/>
1234 <function name="TpClientClass" link="telepathy-glib-client.html#TpClientClass"/>
1235 <function name="tp_client_init_known_interfaces ()" link="telepathy-glib-client.html#tp-client-init-known-interfaces"/>
1236 <function name="tp_cli_client_observer_callback_for_observe_channels ()" link="telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels"/>
1237 <function name="tp_cli_client_observer_call_observe_channels ()" link="telepathy-glib-client.html#tp-cli-client-observer-call-observe-channels"/>
1238 <function name="tp_cli_client_handler_callback_for_handle_channels ()" link="telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels"/>
1239 <function name="tp_cli_client_handler_call_handle_channels ()" link="telepathy-glib-client.html#tp-cli-client-handler-call-handle-channels"/>
1240 <function name="tp_cli_client_interface_requests_callback_for_add_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-add-request"/>
1241 <function name="tp_cli_client_interface_requests_call_add_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-call-add-request"/>
1242 <function name="tp_cli_client_interface_requests_callback_for_remove_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request"/>
1243 <function name="tp_cli_client_interface_requests_call_remove_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-call-remove-request"/>
1244 <function name="tp_cli_client_approver_callback_for_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation"/>
1245 <function name="tp_cli_client_approver_call_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-call-add-dispatch-operation"/>
11201246 <function name="TpSvcDBusIntrospectable" link="telepathy-glib-svc-generic.html#TpSvcDBusIntrospectable-struct"/>
11211247 <function name="TpSvcDBusIntrospectableClass" link="telepathy-glib-svc-generic.html#TpSvcDBusIntrospectableClass"/>
11221248 <function name="TpSvcDBusProperties" link="telepathy-glib-svc-generic.html#TpSvcDBusProperties-struct"/>
16531779 <function name="tp_svc_connection_manager_return_from_request_connection ()" link="telepathy-glib-svc-connection-manager.html#tp-svc-connection-manager-return-from-request-connection"/>
16541780 <function name="tp_svc_connection_manager_emit_new_connection ()" link="telepathy-glib-svc-connection-manager.html#tp-svc-connection-manager-emit-new-connection"/>
16551781 <function name="The &quot;new-connection&quot; signal" link="telepathy-glib-svc-connection-manager.html#TpSvcConnectionManager-new-connection"/>
1782 <function name="TpSvcAccountManager" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-struct"/>
1783 <function name="TpSvcAccountManagerClass" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass"/>
1784 <function name="tp_svc_account_manager_emit_account_removed ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-removed"/>
1785 <function name="tp_svc_account_manager_emit_account_validity_changed ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-validity-changed"/>
1786 <function name="tp_svc_account_manager_create_account_impl ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl"/>
1787 <function name="tp_svc_account_manager_return_from_create_account ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-return-from-create-account"/>
1788 <function name="tp_svc_account_manager_implement_create_account ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-implement-create-account"/>
1789 <function name="The &quot;account-removed&quot; signal" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-removed"/>
1790 <function name="The &quot;account-validity-changed&quot; signal" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-validity-changed"/>
1791 <function name="TpSvcAccount" link="telepathy-glib-svc-account.html#TpSvcAccount-struct"/>
1792 <function name="TpSvcAccountClass" link="telepathy-glib-svc-account.html#TpSvcAccountClass"/>
1793 <function name="tp_svc_account_emit_account_property_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-emit-account-property-changed"/>
1794 <function name="tp_svc_account_emit_removed ()" link="telepathy-glib-svc-account.html#tp-svc-account-emit-removed"/>
1795 <function name="tp_svc_account_reconnect_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl"/>
1796 <function name="tp_svc_account_return_from_reconnect ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-reconnect"/>
1797 <function name="tp_svc_account_implement_reconnect ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-reconnect"/>
1798 <function name="tp_svc_account_remove_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-remove-impl"/>
1799 <function name="tp_svc_account_return_from_remove ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-remove"/>
1800 <function name="tp_svc_account_implement_remove ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-remove"/>
1801 <function name="tp_svc_account_update_parameters_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl"/>
1802 <function name="tp_svc_account_return_from_update_parameters ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-update-parameters"/>
1803 <function name="tp_svc_account_implement_update_parameters ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-update-parameters"/>
1804 <function name="TpSvcAccountInterfaceAvatar" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct"/>
1805 <function name="TpSvcAccountInterfaceAvatarClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass"/>
1806 <function name="tp_svc_account_interface_avatar_emit_avatar_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed"/>
1807 <function name="The &quot;account-property-changed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed"/>
1808 <function name="The &quot;removed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccount-removed"/>
1809 <function name="The &quot;avatar-changed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed"/>
1810 <function name="TpSvcChannelDispatcher" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher-struct"/>
1811 <function name="TpSvcChannelDispatcherClass" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass"/>
1812 <function name="tp_svc_channel_dispatcher_return_from_create_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-create-channel"/>
1813 <function name="tp_svc_channel_dispatcher_create_channel_impl ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl"/>
1814 <function name="tp_svc_channel_dispatcher_implement_create_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-create-channel"/>
1815 <function name="tp_svc_channel_dispatcher_return_from_ensure_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-ensure-channel"/>
1816 <function name="tp_svc_channel_dispatcher_ensure_channel_impl ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl"/>
1817 <function name="tp_svc_channel_dispatcher_implement_ensure_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-ensure-channel"/>
1818 <function name="TpSvcChannelDispatcherInterfaceOperationList" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-struct"/>
1819 <function name="TpSvcChannelDispatcherInterfaceOperationListClass" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationListClass"/>
1820 <function name="tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation"/>
1821 <function name="tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished"/>
1822 <function name="The &quot;dispatch-operation-finished&quot; signal" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"/>
1823 <function name="The &quot;new-dispatch-operation&quot; signal" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"/>
1824 <function name="TpSvcChannelDispatchOperation" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-struct"/>
1825 <function name="TpSvcChannelDispatchOperationClass" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass"/>
1826 <function name="tp_svc_channel_dispatch_operation_return_from_claim ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-claim"/>
1827 <function name="tp_svc_channel_dispatch_operation_claim_impl ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl"/>
1828 <function name="tp_svc_channel_dispatch_operation_implement_claim ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-claim"/>
1829 <function name="tp_svc_channel_dispatch_operation_return_from_handle_with ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-handle-with"/>
1830 <function name="tp_svc_channel_dispatch_operation_handle_with_impl ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl"/>
1831 <function name="tp_svc_channel_dispatch_operation_implement_handle_with ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-handle-with"/>
1832 <function name="tp_svc_channel_dispatch_operation_emit_channel_lost ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-channel-lost"/>
1833 <function name="tp_svc_channel_dispatch_operation_emit_finished ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-finished"/>
1834 <function name="The &quot;channel-lost&quot; signal" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-channel-lost"/>
1835 <function name="The &quot;finished&quot; signal" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-finished"/>
1836 <function name="TpSvcChannelRequest" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-struct"/>
1837 <function name="TpSvcChannelRequestClass" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass"/>
1838 <function name="tp_svc_channel_request_return_from_proceed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-proceed"/>
1839 <function name="tp_svc_channel_request_proceed_impl ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl"/>
1840 <function name="tp_svc_channel_request_implement_proceed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-proceed"/>
1841 <function name="tp_svc_channel_request_return_from_cancel ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-cancel"/>
1842 <function name="tp_svc_channel_request_cancel_impl ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl"/>
1843 <function name="tp_svc_channel_request_implement_cancel ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-cancel"/>
1844 <function name="tp_svc_channel_request_emit_failed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-failed"/>
1845 <function name="tp_svc_channel_request_emit_succeeded ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-succeeded"/>
1846 <function name="The &quot;failed&quot; signal" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-failed"/>
1847 <function name="The &quot;succeeded&quot; signal" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-succeeded"/>
1848 <function name="TpSvcClient" link="telepathy-glib-svc-client.html#TpSvcClient-struct"/>
1849 <function name="TpSvcClientClass" link="telepathy-glib-svc-client.html#TpSvcClientClass"/>
1850 <function name="TpSvcClientApprover" link="telepathy-glib-svc-client.html#TpSvcClientApprover-struct"/>
1851 <function name="TpSvcClientApproverClass" link="telepathy-glib-svc-client.html#TpSvcClientApproverClass"/>
1852 <function name="tp_svc_client_approver_return_from_add_dispatch_operation ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-return-from-add-dispatch-operation"/>
1853 <function name="tp_svc_client_approver_add_dispatch_operation_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl"/>
1854 <function name="tp_svc_client_approver_implement_add_dispatch_operation ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-implement-add-dispatch-operation"/>
1855 <function name="TpSvcClientHandler" link="telepathy-glib-svc-client.html#TpSvcClientHandler-struct"/>
1856 <function name="TpSvcClientHandlerClass" link="telepathy-glib-svc-client.html#TpSvcClientHandlerClass"/>
1857 <function name="tp_svc_client_handler_return_from_handle_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-return-from-handle-channels"/>
1858 <function name="tp_svc_client_handler_handle_channels_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl"/>
1859 <function name="tp_svc_client_handler_implement_handle_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-implement-handle-channels"/>
1860 <function name="TpSvcClientInterfaceRequests" link="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests-struct"/>
1861 <function name="TpSvcClientInterfaceRequestsClass" link="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass"/>
1862 <function name="tp_svc_client_interface_requests_return_from_add_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-add-request"/>
1863 <function name="tp_svc_client_interface_requests_add_request_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl"/>
1864 <function name="tp_svc_client_interface_requests_implement_add_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-add-request"/>
1865 <function name="tp_svc_client_interface_requests_return_from_remove_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-remove-request"/>
1866 <function name="tp_svc_client_interface_requests_remove_request_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl"/>
1867 <function name="tp_svc_client_interface_requests_implement_remove_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-remove-request"/>
1868 <function name="TpSvcClientObserver" link="telepathy-glib-svc-client.html#TpSvcClientObserver-struct"/>
1869 <function name="TpSvcClientObserverClass" link="telepathy-glib-svc-client.html#TpSvcClientObserverClass"/>
1870 <function name="tp_svc_client_observer_return_from_observe_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-return-from-observe-channels"/>
1871 <function name="tp_svc_client_observer_observe_channels_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl"/>
1872 <function name="tp_svc_client_observer_implement_observe_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-implement-observe-channels"/>
16561873 <function name="tp_run_connection_manager ()" link="telepathy-glib-run.html#tp-run-connection-manager"/>
16571874 <function name="TpCMParamFilter ()" link="TpBaseConnectionManager.html#TpCMParamFilter"/>
16581875 <function name="tp_cm_param_filter_string_nonempty ()" link="TpBaseConnectionManager.html#tp-cm-param-filter-string-nonempty"/>
3838 <sub name="Tube channels" link="telepathy-glib-channel-tube.html"/>
3939 <sub name="Room List channels" link="telepathy-glib-channel-roomlist.html"/>
4040 <sub name="TpMediaSessionHandler, TpMediaStreamHandler" link="telepathy-glib-media-interfaces.html"/>
41 <sub name="TpAccountManager" link="telepathy-glib-account-manager.html"/>
42 <sub name="TpAccount" link="telepathy-glib-account.html"/>
43 <sub name="TpChannelDispatcher" link="telepathy-glib-channel-dispatcher.html"/>
44 <sub name="TpChannelDispatchOperation" link="telepathy-glib-channel-dispatch-operation.html"/>
45 <sub name="TpChannelRequest" link="telepathy-glib-channel-request.html"/>
46 <sub name="TpClient" link="telepathy-glib-client.html"/>
4147 </sub>
4248 <sub name="Service-side D-Bus interfaces" link="ch-service-dbus.html">
4349 <sub name="&#10; The TpSvc* interfaces&#10; " link="telepathy-glib-svc.html"/>
5460 <sub name="Service-side Connection interfaces" link="telepathy-glib-svc-connection.html"/>
5561 <sub name="Service-side media streaming helper interfaces" link="telepathy-glib-svc-media-interfaces.html"/>
5662 <sub name="Service-side Connection Manager interface" link="telepathy-glib-svc-connection-manager.html"/>
63 <sub name="Service-side Account Manager interface" link="telepathy-glib-svc-account-manager.html"/>
64 <sub name="Service-side Account interfaces" link="telepathy-glib-svc-account.html"/>
65 <sub name="Service-side Channel Dispatcher interface" link="telepathy-glib-svc-channel-dispatcher.html"/>
66 <sub name="Service-side Channel Dispatch Operation interface" link="telepathy-glib-svc-channel-dispatch-operation.html"/>
67 <sub name="Service-side Channel Request interface" link="telepathy-glib-svc-channel-request.html"/>
68 <sub name="Service-side Client interfaces" link="telepathy-glib-svc-client.html"/>
5769 </sub>
5870 <sub name="Service-side implementation" link="ch-service-base.html">
5971 <sub name="Connection manager life cycle" link="telepathy-glib-run.html"/>
160172 <keyword type="function" name="tp_dbus_daemon_release_name ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-release-name" since="0.7.30"/>
161173 <keyword type="function" name="tp_dbus_daemon_request_name ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-request-name" since="0.7.30"/>
162174 <keyword type="function" name="tp_dbus_daemon_watch_name_owner ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-watch-name-owner" since="0.7.1"/>
175 <keyword type="function" name="tp_dbus_daemon_init_known_interfaces ()" link="telepathy-glib-dbus.html#tp-dbus-daemon-init-known-interfaces" since="0.7.UNRELEASED"/>
163176 <keyword type="function" name="tp_cli_dbus_daemon_call_add_match ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-add-match"/>
164177 <keyword type="function" name="tp_cli_dbus_daemon_call_get_connection_se_linux_security_context ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-se-linux-security-context"/>
165178 <keyword type="function" name="tp_cli_dbus_daemon_call_get_connection_unix_process_id ()" link="telepathy-glib-dbus.html#tp-cli-dbus-daemon-call-get-connection-unix-process-id"/>
266279 <keyword type="macro" name="TP_CM_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CM-OBJECT-PATH-BASE--CAPS"/>
267280 <keyword type="macro" name="TP_CONN_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CONN-BUS-NAME-BASE--CAPS"/>
268281 <keyword type="macro" name="TP_CONN_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CONN-OBJECT-PATH-BASE--CAPS"/>
282 <keyword type="macro" name="TP_ACCOUNT_MANAGER_BUS_NAME" link="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-BUS-NAME--CAPS"/>
283 <keyword type="macro" name="TP_ACCOUNT_MANAGER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS"/>
284 <keyword type="macro" name="TP_ACCOUNT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-ACCOUNT-OBJECT-PATH-BASE--CAPS"/>
285 <keyword type="macro" name="TP_CHANNEL_DISPATCHER_BUS_NAME" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS"/>
286 <keyword type="macro" name="TP_CHANNEL_DISPATCHER_OBJECT_PATH" link="telepathy-glib-defs.html#TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS"/>
287 <keyword type="macro" name="TP_CLIENT_BUS_NAME_BASE" link="telepathy-glib-defs.html#TP-CLIENT-BUS-NAME-BASE--CAPS"/>
288 <keyword type="macro" name="TP_CLIENT_OBJECT_PATH_BASE" link="telepathy-glib-defs.html#TP-CLIENT-OBJECT-PATH-BASE--CAPS"/>
269289 <keyword type="typedef" name="TpHandle" link="telepathy-glib-handle.html#TpHandle"/>
270290 <keyword type="macro" name="TP_TYPE_HANDLE" link="telepathy-glib-handle.html#TP-TYPE-HANDLE--CAPS"/>
271291 <keyword type="macro" name="TP_UNKNOWN_HANDLE_TYPE" link="telepathy-glib-handle.html#TP-UNKNOWN-HANDLE-TYPE--CAPS" since="0.7.0"/>
272292 <keyword type="function" name="tp_handle_type_is_valid ()" link="telepathy-glib-handle.html#tp-handle-type-is-valid"/>
273293 <keyword type="function" name="tp_handle_type_to_string ()" link="telepathy-glib-handle.html#tp-handle-type-to-string"/>
294 <keyword type="macro" name="TP_IFACE_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT--CAPS"/>
295 <keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT--CAPS"/>
296 <keyword type="macro" name="TP_IFACE_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS"/>
297 <keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS"/>
298 <keyword type="macro" name="TP_IFACE_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-ACCOUNT-MANAGER--CAPS"/>
299 <keyword type="macro" name="TP_IFACE_QUARK_ACCOUNT_MANAGER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS"/>
274300 <keyword type="macro" name="TP_IFACE_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-DAEMON--CAPS"/>
275301 <keyword type="macro" name="TP_IFACE_QUARK_DBUS_DAEMON" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-DBUS-DAEMON--CAPS"/>
276302 <keyword type="macro" name="TP_IFACE_DBUS_INTROSPECTABLE" link="telepathy-glib-interfaces.html#TP-IFACE-DBUS-INTROSPECTABLE--CAPS"/>
335361 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS"/>
336362 <keyword type="macro" name="TP_IFACE_CHANNEL_INTERFACE_MESSAGES" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS"/>
337363 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS"/>
364 <keyword type="macro" name="TP_IFACE_CHANNEL_DISPATCHER" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER--CAPS"/>
365 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_DISPATCHER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS"/>
366 <keyword type="macro" name="TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"/>
367 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"/>
368 <keyword type="macro" name="TP_IFACE_CHANNEL_DISPATCH_OPERATION" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS"/>
369 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS"/>
370 <keyword type="macro" name="TP_IFACE_CHANNEL_REQUEST" link="telepathy-glib-interfaces.html#TP-IFACE-CHANNEL-REQUEST--CAPS"/>
371 <keyword type="macro" name="TP_IFACE_QUARK_CHANNEL_REQUEST" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS"/>
338372 <keyword type="macro" name="TP_IFACE_MEDIA_SESSION_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-SESSION-HANDLER--CAPS"/>
339373 <keyword type="macro" name="TP_IFACE_QUARK_MEDIA_SESSION_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS"/>
340374 <keyword type="macro" name="TP_IFACE_MEDIA_STREAM_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-MEDIA-STREAM-HANDLER--CAPS"/>
341375 <keyword type="macro" name="TP_IFACE_QUARK_MEDIA_STREAM_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS"/>
342376 <keyword type="macro" name="TP_IFACE_PROPERTIES_INTERFACE" link="telepathy-glib-interfaces.html#TP-IFACE-PROPERTIES-INTERFACE--CAPS"/>
343377 <keyword type="macro" name="TP_IFACE_QUARK_PROPERTIES_INTERFACE" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS"/>
378 <keyword type="macro" name="TP_IFACE_CLIENT" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT--CAPS"/>
379 <keyword type="macro" name="TP_IFACE_QUARK_CLIENT" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT--CAPS"/>
380 <keyword type="macro" name="TP_IFACE_CLIENT_APPROVER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-APPROVER--CAPS"/>
381 <keyword type="macro" name="TP_IFACE_QUARK_CLIENT_APPROVER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-APPROVER--CAPS"/>
382 <keyword type="macro" name="TP_IFACE_CLIENT_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-HANDLER--CAPS"/>
383 <keyword type="macro" name="TP_IFACE_QUARK_CLIENT_HANDLER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-HANDLER--CAPS"/>
384 <keyword type="macro" name="TP_IFACE_CLIENT_OBSERVER" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-OBSERVER--CAPS"/>
385 <keyword type="macro" name="TP_IFACE_QUARK_CLIENT_OBSERVER" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS"/>
386 <keyword type="macro" name="TP_IFACE_CLIENT_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS"/>
387 <keyword type="macro" name="TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS" link="telepathy-glib-interfaces.html#TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS"/>
344388 <keyword type="enum" name="enum TpHandleType" link="telepathy-glib-enums.html#TpHandleType"/>
345389 <keyword type="macro" name="NUM_TP_HANDLE_TYPES" link="telepathy-glib-enums.html#NUM-TP-HANDLE-TYPES--CAPS"/>
346390 <keyword type="enum" name="enum TpConnMgrParamFlags" link="telepathy-glib-enums.html#TpConnMgrParamFlags"/>
527571 <keyword type="macro" name="TP_HASH_TYPE_CHANNEL_CALL_STATE_MAP" link="telepathy-glib-gtypes.html#TP-HASH-TYPE-CHANNEL-CALL-STATE-MAP--CAPS"/>
528572 <keyword type="macro" name="TP_ARRAY_TYPE_ROOM_INFO_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS"/>
529573 <keyword type="macro" name="TP_STRUCT_TYPE_ROOM_INFO" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-ROOM-INFO--CAPS"/>
574 <keyword type="macro" name="TP_STRUCT_TYPE_AVATAR" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-AVATAR--CAPS"/>
575 <keyword type="macro" name="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS" link="telepathy-glib-gtypes.html#TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"/>
576 <keyword type="macro" name="TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST" link="telepathy-glib-gtypes.html#TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"/>
530577 <keyword type="function" name="TpChannelFunc ()" link="TpChannelIface.html#TpChannelFunc"/>
531578 <keyword type="struct" name="TpChannelIface" link="TpChannelIface.html#TpChannelIface-struct"/>
532579 <keyword type="struct" name="TpChannelIfaceClass" link="TpChannelIface.html#TpChannelIfaceClass"/>
565612 <keyword type="function" name="tp_connection_manager_param_get_default ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-param-get-default" since="0.7.26"/>
566613 <keyword type="function" name="tp_connection_manager_check_valid_name ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-name" since="0.7.1"/>
567614 <keyword type="function" name="tp_connection_manager_check_valid_protocol_name ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-check-valid-protocol-name" since="0.7.1"/>
615 <keyword type="function" name="tp_connection_manager_init_known_interfaces ()" link="telepathy-glib-connection-manager.html#tp-connection-manager-init-known-interfaces" since="0.7.UNRELEASED"/>
568616 <keyword type="function" name="tp_cli_connection_manager_callback_for_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-callback-for-get-parameters"/>
569617 <keyword type="function" name="tp_cli_connection_manager_call_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-call-get-parameters"/>
570618 <keyword type="function" name="tp_cli_connection_manager_run_get_parameters ()" link="telepathy-glib-connection-manager.html#tp-cli-connection-manager-run-get-parameters"/>
10461094 <keyword type="function" name="tp_cli_channel_type_room_list_signal_callback_got_rooms ()" link="telepathy-glib-channel-roomlist.html#tp-cli-channel-type-room-list-signal-callback-got-rooms"/>
10471095 <keyword type="function" name="tp_cli_channel_type_room_list_signal_callback_listing_rooms ()" link="telepathy-glib-channel-roomlist.html#tp-cli-channel-type-room-list-signal-callback-listing-rooms"/>
10481096 <keyword type="function" name="tp_media_session_handler_new ()" link="telepathy-glib-media-interfaces.html#tp-media-session-handler-new" since="0.7.1"/>
1097 <keyword type="function" name="tp_media_session_handler_init_known_interfaces ()" link="telepathy-glib-media-interfaces.html#tp-media-session-handler-init-known-interfaces" since="0.7.UNRELEASED"/>
10491098 <keyword type="struct" name="TpMediaSessionHandler" link="telepathy-glib-media-interfaces.html#TpMediaSessionHandler-struct"/>
10501099 <keyword type="struct" name="TpMediaSessionHandlerClass" link="telepathy-glib-media-interfaces.html#TpMediaSessionHandlerClass" since="0.7.1"/>
10511100 <keyword type="function" name="tp_media_stream_handler_new ()" link="telepathy-glib-media-interfaces.html#tp-media-stream-handler-new" since="0.7.1"/>
1101 <keyword type="function" name="tp_media_stream_handler_init_known_interfaces ()" link="telepathy-glib-media-interfaces.html#tp-media-stream-handler-init-known-interfaces" since="0.7.UNRELEASED"/>
10521102 <keyword type="struct" name="TpMediaStreamHandler" link="telepathy-glib-media-interfaces.html#TpMediaStreamHandler-struct"/>
10531103 <keyword type="struct" name="TpMediaStreamHandlerClass" link="telepathy-glib-media-interfaces.html#TpMediaStreamHandlerClass" since="0.7.1"/>
10541104 <keyword type="function" name="tp_cli_media_session_handler_callback_for_error ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-session-handler-callback-for-error"/>
11171167 <keyword type="function" name="tp_cli_media_stream_handler_call_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-call-codecs-updated"/>
11181168 <keyword type="function" name="tp_cli_media_stream_handler_callback_for_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-callback-for-codecs-updated"/>
11191169 <keyword type="function" name="tp_cli_media_stream_handler_run_codecs_updated ()" link="telepathy-glib-media-interfaces.html#tp-cli-media-stream-handler-run-codecs-updated"/>
1170 <keyword type="struct" name="TpAccountManager" link="telepathy-glib-account-manager.html#TpAccountManager-struct"/>
1171 <keyword type="struct" name="TpAccountManagerClass" link="telepathy-glib-account-manager.html#TpAccountManagerClass"/>
1172 <keyword type="function" name="tp_account_manager_new ()" link="telepathy-glib-account-manager.html#tp-account-manager-new"/>
1173 <keyword type="function" name="tp_account_manager_init_known_interfaces ()" link="telepathy-glib-account-manager.html#tp-account-manager-init-known-interfaces" since="0.7.UNRELEASED"/>
1174 <keyword type="function" name="tp_cli_account_manager_callback_for_create_account ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-callback-for-create-account"/>
1175 <keyword type="function" name="tp_cli_account_manager_call_create_account ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-call-create-account"/>
1176 <keyword type="function" name="tp_cli_account_manager_signal_callback_account_removed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-removed"/>
1177 <keyword type="function" name="tp_cli_account_manager_connect_to_account_removed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-removed"/>
1178 <keyword type="function" name="tp_cli_account_manager_signal_callback_account_validity_changed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-signal-callback-account-validity-changed"/>
1179 <keyword type="function" name="tp_cli_account_manager_connect_to_account_validity_changed ()" link="telepathy-glib-account-manager.html#tp-cli-account-manager-connect-to-account-validity-changed"/>
1180 <keyword type="struct" name="TpAccount" link="telepathy-glib-account.html#TpAccount-struct"/>
1181 <keyword type="struct" name="TpAccountClass" link="telepathy-glib-account.html#TpAccountClass"/>
1182 <keyword type="function" name="tp_account_new ()" link="telepathy-glib-account.html#tp-account-new"/>
1183 <keyword type="function" name="tp_account_init_known_interfaces ()" link="telepathy-glib-account.html#tp-account-init-known-interfaces" since="0.7.UNRELEASED"/>
1184 <keyword type="function" name="tp_cli_account_callback_for_reconnect ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect"/>
1185 <keyword type="function" name="tp_cli_account_call_reconnect ()" link="telepathy-glib-account.html#tp-cli-account-call-reconnect"/>
1186 <keyword type="function" name="tp_cli_account_callback_for_remove ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-remove"/>
1187 <keyword type="function" name="tp_cli_account_call_remove ()" link="telepathy-glib-account.html#tp-cli-account-call-remove"/>
1188 <keyword type="function" name="tp_cli_account_callback_for_update_parameters ()" link="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters"/>
1189 <keyword type="function" name="tp_cli_account_call_update_parameters ()" link="telepathy-glib-account.html#tp-cli-account-call-update-parameters"/>
1190 <keyword type="function" name="tp_cli_account_signal_callback_account_property_changed ()" link="telepathy-glib-account.html#tp-cli-account-signal-callback-account-property-changed"/>
1191 <keyword type="function" name="tp_cli_account_connect_to_account_property_changed ()" link="telepathy-glib-account.html#tp-cli-account-connect-to-account-property-changed"/>
1192 <keyword type="function" name="tp_cli_account_signal_callback_removed ()" link="telepathy-glib-account.html#tp-cli-account-signal-callback-removed"/>
1193 <keyword type="function" name="tp_cli_account_connect_to_removed ()" link="telepathy-glib-account.html#tp-cli-account-connect-to-removed"/>
1194 <keyword type="function" name="tp_cli_account_interface_avatar_signal_callback_avatar_changed ()" link="telepathy-glib-account.html#tp-cli-account-interface-avatar-signal-callback-avatar-changed"/>
1195 <keyword type="function" name="tp_cli_account_interface_avatar_connect_to_avatar_changed ()" link="telepathy-glib-account.html#tp-cli-account-interface-avatar-connect-to-avatar-changed"/>
1196 <keyword type="struct" name="TpChannelDispatcher" link="telepathy-glib-channel-dispatcher.html#TpChannelDispatcher-struct"/>
1197 <keyword type="struct" name="TpChannelDispatcherClass" link="telepathy-glib-channel-dispatcher.html#TpChannelDispatcherClass"/>
1198 <keyword type="function" name="tp_channel_dispatcher_new ()" link="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-new"/>
1199 <keyword type="function" name="tp_channel_dispatcher_init_known_interfaces ()" link="telepathy-glib-channel-dispatcher.html#tp-channel-dispatcher-init-known-interfaces" since="0.7.UNRELEASED"/>
1200 <keyword type="function" name="tp_cli_channel_dispatcher_callback_for_create_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-create-channel"/>
1201 <keyword type="function" name="tp_cli_channel_dispatcher_call_create_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-create-channel"/>
1202 <keyword type="function" name="tp_cli_channel_dispatcher_callback_for_ensure_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-callback-for-ensure-channel"/>
1203 <keyword type="function" name="tp_cli_channel_dispatcher_call_ensure_channel ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-call-ensure-channel"/>
1204 <keyword type="function" name="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished"/>
1205 <keyword type="function" name="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"/>
1206 <keyword type="function" name="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation"/>
1207 <keyword type="function" name="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()" link="telepathy-glib-channel-dispatcher.html#tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"/>
1208 <keyword type="struct" name="struct TpChannelDispatchOperation" link="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-struct"/>
1209 <keyword type="struct" name="struct TpChannelDispatchOperationClass" link="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperationClass"/>
1210 <keyword type="function" name="tp_channel_dispatch_operation_new ()" link="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-new"/>
1211 <keyword type="function" name="tp_channel_dispatch_operation_init_known_interfaces ()" link="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-init-known-interfaces" since="0.7.UNRELEASED"/>
1212 <keyword type="function" name="tp_cli_channel_dispatch_operation_callback_for_claim ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim"/>
1213 <keyword type="function" name="tp_cli_channel_dispatch_operation_call_claim ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim"/>
1214 <keyword type="function" name="tp_cli_channel_dispatch_operation_callback_for_handle_with ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with"/>
1215 <keyword type="function" name="tp_cli_channel_dispatch_operation_call_handle_with ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with"/>
1216 <keyword type="function" name="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost"/>
1217 <keyword type="function" name="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost"/>
1218 <keyword type="function" name="tp_cli_channel_dispatch_operation_signal_callback_finished ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished"/>
1219 <keyword type="function" name="tp_cli_channel_dispatch_operation_connect_to_finished ()" link="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished"/>
1220 <keyword type="struct" name="TpChannelRequest" link="telepathy-glib-channel-request.html#TpChannelRequest-struct"/>
1221 <keyword type="struct" name="TpChannelRequestClass" link="telepathy-glib-channel-request.html#TpChannelRequestClass"/>
1222 <keyword type="function" name="tp_channel_request_new ()" link="telepathy-glib-channel-request.html#tp-channel-request-new"/>
1223 <keyword type="function" name="tp_channel_request_init_known_interfaces ()" link="telepathy-glib-channel-request.html#tp-channel-request-init-known-interfaces" since="0.7.UNRELEASED"/>
1224 <keyword type="function" name="tp_cli_channel_request_callback_for_cancel ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-cancel"/>
1225 <keyword type="function" name="tp_cli_channel_request_call_cancel ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-call-cancel"/>
1226 <keyword type="function" name="tp_cli_channel_request_callback_for_proceed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-callback-for-proceed"/>
1227 <keyword type="function" name="tp_cli_channel_request_call_proceed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-call-proceed"/>
1228 <keyword type="function" name="tp_cli_channel_request_signal_callback_failed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-failed"/>
1229 <keyword type="function" name="tp_cli_channel_request_connect_to_failed ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-failed"/>
1230 <keyword type="function" name="tp_cli_channel_request_signal_callback_succeeded ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-signal-callback-succeeded"/>
1231 <keyword type="function" name="tp_cli_channel_request_connect_to_succeeded ()" link="telepathy-glib-channel-request.html#tp-cli-channel-request-connect-to-succeeded"/>
1232 <keyword type="signal" name="The &quot;succeeded&quot; signal" link="telepathy-glib-channel-request.html#TpChannelRequest-succeeded"/>
1233 <keyword type="struct" name="TpClient" link="telepathy-glib-client.html#TpClient-struct"/>
1234 <keyword type="struct" name="TpClientClass" link="telepathy-glib-client.html#TpClientClass"/>
1235 <keyword type="function" name="tp_client_init_known_interfaces ()" link="telepathy-glib-client.html#tp-client-init-known-interfaces" since="0.7.UNRELEASED"/>
1236 <keyword type="function" name="tp_cli_client_observer_callback_for_observe_channels ()" link="telepathy-glib-client.html#tp-cli-client-observer-callback-for-observe-channels"/>
1237 <keyword type="function" name="tp_cli_client_observer_call_observe_channels ()" link="telepathy-glib-client.html#tp-cli-client-observer-call-observe-channels"/>
1238 <keyword type="function" name="tp_cli_client_handler_callback_for_handle_channels ()" link="telepathy-glib-client.html#tp-cli-client-handler-callback-for-handle-channels"/>
1239 <keyword type="function" name="tp_cli_client_handler_call_handle_channels ()" link="telepathy-glib-client.html#tp-cli-client-handler-call-handle-channels"/>
1240 <keyword type="function" name="tp_cli_client_interface_requests_callback_for_add_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-add-request"/>
1241 <keyword type="function" name="tp_cli_client_interface_requests_call_add_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-call-add-request"/>
1242 <keyword type="function" name="tp_cli_client_interface_requests_callback_for_remove_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-callback-for-remove-request"/>
1243 <keyword type="function" name="tp_cli_client_interface_requests_call_remove_request ()" link="telepathy-glib-client.html#tp-cli-client-interface-requests-call-remove-request"/>
1244 <keyword type="function" name="tp_cli_client_approver_callback_for_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-callback-for-add-dispatch-operation"/>
1245 <keyword type="function" name="tp_cli_client_approver_call_add_dispatch_operation ()" link="telepathy-glib-client.html#tp-cli-client-approver-call-add-dispatch-operation"/>
11201246 <keyword type="struct" name="TpSvcDBusIntrospectable" link="telepathy-glib-svc-generic.html#TpSvcDBusIntrospectable-struct"/>
11211247 <keyword type="struct" name="TpSvcDBusIntrospectableClass" link="telepathy-glib-svc-generic.html#TpSvcDBusIntrospectableClass"/>
11221248 <keyword type="struct" name="TpSvcDBusProperties" link="telepathy-glib-svc-generic.html#TpSvcDBusProperties-struct"/>
16531779 <keyword type="function" name="tp_svc_connection_manager_return_from_request_connection ()" link="telepathy-glib-svc-connection-manager.html#tp-svc-connection-manager-return-from-request-connection"/>
16541780 <keyword type="function" name="tp_svc_connection_manager_emit_new_connection ()" link="telepathy-glib-svc-connection-manager.html#tp-svc-connection-manager-emit-new-connection"/>
16551781 <keyword type="signal" name="The &quot;new-connection&quot; signal" link="telepathy-glib-svc-connection-manager.html#TpSvcConnectionManager-new-connection"/>
1782 <keyword type="struct" name="TpSvcAccountManager" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-struct"/>
1783 <keyword type="struct" name="TpSvcAccountManagerClass" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManagerClass"/>
1784 <keyword type="function" name="tp_svc_account_manager_emit_account_removed ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-removed"/>
1785 <keyword type="function" name="tp_svc_account_manager_emit_account_validity_changed ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-emit-account-validity-changed"/>
1786 <keyword type="function" name="tp_svc_account_manager_create_account_impl ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-create-account-impl"/>
1787 <keyword type="function" name="tp_svc_account_manager_return_from_create_account ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-return-from-create-account"/>
1788 <keyword type="function" name="tp_svc_account_manager_implement_create_account ()" link="telepathy-glib-svc-account-manager.html#tp-svc-account-manager-implement-create-account"/>
1789 <keyword type="signal" name="The &quot;account-removed&quot; signal" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-removed"/>
1790 <keyword type="signal" name="The &quot;account-validity-changed&quot; signal" link="telepathy-glib-svc-account-manager.html#TpSvcAccountManager-account-validity-changed"/>
1791 <keyword type="struct" name="TpSvcAccount" link="telepathy-glib-svc-account.html#TpSvcAccount-struct"/>
1792 <keyword type="struct" name="TpSvcAccountClass" link="telepathy-glib-svc-account.html#TpSvcAccountClass"/>
1793 <keyword type="function" name="tp_svc_account_emit_account_property_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-emit-account-property-changed"/>
1794 <keyword type="function" name="tp_svc_account_emit_removed ()" link="telepathy-glib-svc-account.html#tp-svc-account-emit-removed"/>
1795 <keyword type="function" name="tp_svc_account_reconnect_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-reconnect-impl"/>
1796 <keyword type="function" name="tp_svc_account_return_from_reconnect ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-reconnect"/>
1797 <keyword type="function" name="tp_svc_account_implement_reconnect ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-reconnect"/>
1798 <keyword type="function" name="tp_svc_account_remove_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-remove-impl"/>
1799 <keyword type="function" name="tp_svc_account_return_from_remove ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-remove"/>
1800 <keyword type="function" name="tp_svc_account_implement_remove ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-remove"/>
1801 <keyword type="function" name="tp_svc_account_update_parameters_impl ()" link="telepathy-glib-svc-account.html#tp-svc-account-update-parameters-impl"/>
1802 <keyword type="function" name="tp_svc_account_return_from_update_parameters ()" link="telepathy-glib-svc-account.html#tp-svc-account-return-from-update-parameters"/>
1803 <keyword type="function" name="tp_svc_account_implement_update_parameters ()" link="telepathy-glib-svc-account.html#tp-svc-account-implement-update-parameters"/>
1804 <keyword type="struct" name="TpSvcAccountInterfaceAvatar" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-struct"/>
1805 <keyword type="struct" name="TpSvcAccountInterfaceAvatarClass" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatarClass"/>
1806 <keyword type="function" name="tp_svc_account_interface_avatar_emit_avatar_changed ()" link="telepathy-glib-svc-account.html#tp-svc-account-interface-avatar-emit-avatar-changed"/>
1807 <keyword type="signal" name="The &quot;account-property-changed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccount-account-property-changed"/>
1808 <keyword type="signal" name="The &quot;removed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccount-removed"/>
1809 <keyword type="signal" name="The &quot;avatar-changed&quot; signal" link="telepathy-glib-svc-account.html#TpSvcAccountInterfaceAvatar-avatar-changed"/>
1810 <keyword type="struct" name="TpSvcChannelDispatcher" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcher-struct"/>
1811 <keyword type="struct" name="TpSvcChannelDispatcherClass" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherClass"/>
1812 <keyword type="function" name="tp_svc_channel_dispatcher_return_from_create_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-create-channel"/>
1813 <keyword type="function" name="tp_svc_channel_dispatcher_create_channel_impl ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-create-channel-impl"/>
1814 <keyword type="function" name="tp_svc_channel_dispatcher_implement_create_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-create-channel"/>
1815 <keyword type="function" name="tp_svc_channel_dispatcher_return_from_ensure_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-return-from-ensure-channel"/>
1816 <keyword type="function" name="tp_svc_channel_dispatcher_ensure_channel_impl ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-ensure-channel-impl"/>
1817 <keyword type="function" name="tp_svc_channel_dispatcher_implement_ensure_channel ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-implement-ensure-channel"/>
1818 <keyword type="struct" name="TpSvcChannelDispatcherInterfaceOperationList" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-struct"/>
1819 <keyword type="struct" name="TpSvcChannelDispatcherInterfaceOperationListClass" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationListClass"/>
1820 <keyword type="function" name="tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation"/>
1821 <keyword type="function" name="tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()" link="telepathy-glib-svc-channel-dispatcher.html#tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished"/>
1822 <keyword type="signal" name="The &quot;dispatch-operation-finished&quot; signal" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"/>
1823 <keyword type="signal" name="The &quot;new-dispatch-operation&quot; signal" link="telepathy-glib-svc-channel-dispatcher.html#TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"/>
1824 <keyword type="struct" name="TpSvcChannelDispatchOperation" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-struct"/>
1825 <keyword type="struct" name="TpSvcChannelDispatchOperationClass" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperationClass"/>
1826 <keyword type="function" name="tp_svc_channel_dispatch_operation_return_from_claim ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-claim"/>
1827 <keyword type="function" name="tp_svc_channel_dispatch_operation_claim_impl ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-claim-impl"/>
1828 <keyword type="function" name="tp_svc_channel_dispatch_operation_implement_claim ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-claim"/>
1829 <keyword type="function" name="tp_svc_channel_dispatch_operation_return_from_handle_with ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-return-from-handle-with"/>
1830 <keyword type="function" name="tp_svc_channel_dispatch_operation_handle_with_impl ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-handle-with-impl"/>
1831 <keyword type="function" name="tp_svc_channel_dispatch_operation_implement_handle_with ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-implement-handle-with"/>
1832 <keyword type="function" name="tp_svc_channel_dispatch_operation_emit_channel_lost ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-channel-lost"/>
1833 <keyword type="function" name="tp_svc_channel_dispatch_operation_emit_finished ()" link="telepathy-glib-svc-channel-dispatch-operation.html#tp-svc-channel-dispatch-operation-emit-finished"/>
1834 <keyword type="signal" name="The &quot;channel-lost&quot; signal" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-channel-lost"/>
1835 <keyword type="signal" name="The &quot;finished&quot; signal" link="telepathy-glib-svc-channel-dispatch-operation.html#TpSvcChannelDispatchOperation-finished"/>
1836 <keyword type="struct" name="TpSvcChannelRequest" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-struct"/>
1837 <keyword type="struct" name="TpSvcChannelRequestClass" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequestClass"/>
1838 <keyword type="function" name="tp_svc_channel_request_return_from_proceed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-proceed"/>
1839 <keyword type="function" name="tp_svc_channel_request_proceed_impl ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-proceed-impl"/>
1840 <keyword type="function" name="tp_svc_channel_request_implement_proceed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-proceed"/>
1841 <keyword type="function" name="tp_svc_channel_request_return_from_cancel ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-return-from-cancel"/>
1842 <keyword type="function" name="tp_svc_channel_request_cancel_impl ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-cancel-impl"/>
1843 <keyword type="function" name="tp_svc_channel_request_implement_cancel ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-implement-cancel"/>
1844 <keyword type="function" name="tp_svc_channel_request_emit_failed ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-failed"/>
1845 <keyword type="function" name="tp_svc_channel_request_emit_succeeded ()" link="telepathy-glib-svc-channel-request.html#tp-svc-channel-request-emit-succeeded"/>
1846 <keyword type="signal" name="The &quot;failed&quot; signal" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-failed"/>
1847 <keyword type="signal" name="The &quot;succeeded&quot; signal" link="telepathy-glib-svc-channel-request.html#TpSvcChannelRequest-succeeded"/>
1848 <keyword type="struct" name="TpSvcClient" link="telepathy-glib-svc-client.html#TpSvcClient-struct"/>
1849 <keyword type="struct" name="TpSvcClientClass" link="telepathy-glib-svc-client.html#TpSvcClientClass"/>
1850 <keyword type="struct" name="TpSvcClientApprover" link="telepathy-glib-svc-client.html#TpSvcClientApprover-struct"/>
1851 <keyword type="struct" name="TpSvcClientApproverClass" link="telepathy-glib-svc-client.html#TpSvcClientApproverClass"/>
1852 <keyword type="function" name="tp_svc_client_approver_return_from_add_dispatch_operation ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-return-from-add-dispatch-operation"/>
1853 <keyword type="function" name="tp_svc_client_approver_add_dispatch_operation_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-add-dispatch-operation-impl"/>
1854 <keyword type="function" name="tp_svc_client_approver_implement_add_dispatch_operation ()" link="telepathy-glib-svc-client.html#tp-svc-client-approver-implement-add-dispatch-operation"/>
1855 <keyword type="struct" name="TpSvcClientHandler" link="telepathy-glib-svc-client.html#TpSvcClientHandler-struct"/>
1856 <keyword type="struct" name="TpSvcClientHandlerClass" link="telepathy-glib-svc-client.html#TpSvcClientHandlerClass"/>
1857 <keyword type="function" name="tp_svc_client_handler_return_from_handle_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-return-from-handle-channels"/>
1858 <keyword type="function" name="tp_svc_client_handler_handle_channels_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-handle-channels-impl"/>
1859 <keyword type="function" name="tp_svc_client_handler_implement_handle_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-handler-implement-handle-channels"/>
1860 <keyword type="struct" name="TpSvcClientInterfaceRequests" link="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequests-struct"/>
1861 <keyword type="struct" name="TpSvcClientInterfaceRequestsClass" link="telepathy-glib-svc-client.html#TpSvcClientInterfaceRequestsClass"/>
1862 <keyword type="function" name="tp_svc_client_interface_requests_return_from_add_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-add-request"/>
1863 <keyword type="function" name="tp_svc_client_interface_requests_add_request_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-add-request-impl"/>
1864 <keyword type="function" name="tp_svc_client_interface_requests_implement_add_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-add-request"/>
1865 <keyword type="function" name="tp_svc_client_interface_requests_return_from_remove_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-return-from-remove-request"/>
1866 <keyword type="function" name="tp_svc_client_interface_requests_remove_request_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-remove-request-impl"/>
1867 <keyword type="function" name="tp_svc_client_interface_requests_implement_remove_request ()" link="telepathy-glib-svc-client.html#tp-svc-client-interface-requests-implement-remove-request"/>
1868 <keyword type="struct" name="TpSvcClientObserver" link="telepathy-glib-svc-client.html#TpSvcClientObserver-struct"/>
1869 <keyword type="struct" name="TpSvcClientObserverClass" link="telepathy-glib-svc-client.html#TpSvcClientObserverClass"/>
1870 <keyword type="function" name="tp_svc_client_observer_return_from_observe_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-return-from-observe-channels"/>
1871 <keyword type="function" name="tp_svc_client_observer_observe_channels_impl ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-observe-channels-impl"/>
1872 <keyword type="function" name="tp_svc_client_observer_implement_observe_channels ()" link="telepathy-glib-svc-client.html#tp-svc-client-observer-implement-observe-channels"/>
16561873 <keyword type="function" name="tp_run_connection_manager ()" link="telepathy-glib-run.html#tp-run-connection-manager"/>
16571874 <keyword type="function" name="TpCMParamFilter ()" link="TpBaseConnectionManager.html#TpCMParamFilter"/>
16581875 <keyword type="function" name="tp_cm_param_filter_string_nonempty ()" link="TpBaseConnectionManager.html#tp-cm-param-filter-string-nonempty"/>
4545 <xi:include href="xml/channel-tube.xml"/>
4646 <xi:include href="xml/channel-roomlist.xml"/>
4747 <xi:include href="xml/media-interfaces.xml"/>
48 <xi:include href="xml/account-manager.xml"/>
49 <xi:include href="xml/account.xml"/>
50 <xi:include href="xml/channel-dispatcher.xml"/>
51 <xi:include href="xml/channel-dispatch-operation.xml"/>
52 <xi:include href="xml/channel-request.xml"/>
53 <xi:include href="xml/client.xml"/>
4854 </chapter>
4955
5056 <chapter id="ch-service-dbus">
6369 <xi:include href="xml/svc-connection.xml"/>
6470 <xi:include href="xml/svc-media-interfaces.xml"/>
6571 <xi:include href="xml/svc-connection-manager.xml"/>
72 <xi:include href="xml/svc-account-manager.xml"/>
73 <xi:include href="xml/svc-account.xml"/>
74 <xi:include href="xml/svc-channel-dispatcher.xml"/>
75 <xi:include href="xml/svc-channel-dispatch-operation.xml"/>
76 <xi:include href="xml/svc-channel-request.xml"/>
77 <xi:include href="xml/svc-client.xml"/>
6678 </chapter>
6779 <chapter id="ch-service-base">
6880 <title>Service-side implementation</title>
2121 TP_CM_OBJECT_PATH_BASE
2222 TP_CONN_BUS_NAME_BASE
2323 TP_CONN_OBJECT_PATH_BASE
24 TP_ACCOUNT_MANAGER_BUS_NAME
25 TP_ACCOUNT_MANAGER_OBJECT_PATH
26 TP_ACCOUNT_OBJECT_PATH_BASE
27 TP_CHANNEL_DISPATCHER_BUS_NAME
28 TP_CHANNEL_DISPATCHER_OBJECT_PATH
29 TP_CLIENT_BUS_NAME_BASE
30 TP_CLIENT_OBJECT_PATH_BASE
2431 </SECTION>
2532
2633 <SECTION>
11591166 # Channel - Room List
11601167 TP_ARRAY_TYPE_ROOM_INFO_LIST
11611168 TP_STRUCT_TYPE_ROOM_INFO
1169 <SUBSECTION>
1170 # Account and AM
1171 TP_STRUCT_TYPE_AVATAR
1172 <SUBSECTION>
1173 # CD, CDO and CR
1174 TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS
1175 TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST
11621176 <SUBSECTION Private>
11631177 tp_type_dbus_array_a_7bsv_7das
11641178 tp_type_dbus_array_oa_7bsv_7d
11961210 tp_type_dbus_hash_uu
11971211 tp_type_dbus_hash_uv
11981212 tp_type_dbus_struct_a_7bsv_7das
1213 tp_type_dbus_struct_ays
11991214 tp_type_dbus_struct_oa_7bsv_7d
12001215 tp_type_dbus_struct_os
12011216 tp_type_dbus_struct_osuu
15451560 tp_dbus_daemon_release_name
15461561 tp_dbus_daemon_request_name
15471562 tp_dbus_daemon_watch_name_owner
1563 tp_dbus_daemon_init_known_interfaces
15481564 <SUBSECTION>
15491565 tp_cli_dbus_daemon_call_add_match
15501566 tp_cli_dbus_daemon_call_get_connection_se_linux_security_context
18521868 <FILE>interfaces</FILE>
18531869 <TITLE>interfaces</TITLE>
18541870 <INCLUDE>telepathy-glib/interfaces.h</INCLUDE>
1871 TP_IFACE_ACCOUNT
1872 TP_IFACE_QUARK_ACCOUNT
1873 TP_IFACE_ACCOUNT_INTERFACE_AVATAR
1874 TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR
1875 TP_IFACE_ACCOUNT_MANAGER
1876 TP_IFACE_QUARK_ACCOUNT_MANAGER
18551877 TP_IFACE_DBUS_DAEMON
18561878 TP_IFACE_QUARK_DBUS_DAEMON
18571879 TP_IFACE_DBUS_INTROSPECTABLE
19161938 TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING
19171939 TP_IFACE_CHANNEL_INTERFACE_MESSAGES
19181940 TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES
1941 TP_IFACE_CHANNEL_DISPATCHER
1942 TP_IFACE_QUARK_CHANNEL_DISPATCHER
1943 TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST
1944 TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST
1945 TP_IFACE_CHANNEL_DISPATCH_OPERATION
1946 TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION
1947 TP_IFACE_CHANNEL_REQUEST
1948 TP_IFACE_QUARK_CHANNEL_REQUEST
19191949 TP_IFACE_MEDIA_SESSION_HANDLER
19201950 TP_IFACE_QUARK_MEDIA_SESSION_HANDLER
19211951 TP_IFACE_MEDIA_STREAM_HANDLER
19221952 TP_IFACE_QUARK_MEDIA_STREAM_HANDLER
19231953 TP_IFACE_PROPERTIES_INTERFACE
19241954 TP_IFACE_QUARK_PROPERTIES_INTERFACE
1955 TP_IFACE_CLIENT
1956 TP_IFACE_QUARK_CLIENT
1957 TP_IFACE_CLIENT_APPROVER
1958 TP_IFACE_QUARK_CLIENT_APPROVER
1959 TP_IFACE_CLIENT_HANDLER
1960 TP_IFACE_QUARK_CLIENT_HANDLER
1961 TP_IFACE_CLIENT_OBSERVER
1962 TP_IFACE_QUARK_CLIENT_OBSERVER
1963 TP_IFACE_CLIENT_INTERFACE_REQUESTS
1964 TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS
19251965 <SUBSECTION Private>
1966 tp_iface_quark_account
1967 tp_iface_quark_account_interface_avatar
1968 tp_iface_quark_account_manager
19261969 tp_iface_quark_dbus_introspectable
19271970 tp_iface_quark_dbus_peer
19281971 tp_iface_quark_dbus_properties
19441987 tp_iface_quark_channel_interface_tube
19451988 tp_iface_quark_channel_type_dbus_tube
19461989 tp_iface_quark_channel_type_stream_tube
1990 tp_iface_quark_channel_dispatcher
1991 tp_iface_quark_channel_dispatcher_interface_operation_list
1992 tp_iface_quark_channel_dispatch_operation
1993 tp_iface_quark_channel_request
1994 tp_iface_quark_client
1995 tp_iface_quark_client_approver
1996 tp_iface_quark_client_handler
1997 tp_iface_quark_client_interface_requests
1998 tp_iface_quark_client_observer
19471999 tp_iface_quark_connection
19482000 tp_iface_quark_connection_interface_aliasing
19492001 tp_iface_quark_connection_interface_avatars
26432695 tp_connection_manager_param_get_default
26442696 tp_connection_manager_check_valid_name
26452697 tp_connection_manager_check_valid_protocol_name
2698 tp_connection_manager_init_known_interfaces
26462699 <SUBSECTION Standard>
26472700 tp_connection_manager_get_type
26482701 TP_TYPE_CONNECTION_MANAGER
26892742 TpMediaStreamHandlerPrivate
26902743 <SUBSECTION>
26912744 tp_media_session_handler_new
2745 tp_media_session_handler_init_known_interfaces
26922746 TpMediaSessionHandler
26932747 TpMediaSessionHandlerClass
26942748 <SUBSECTION>
26952749 tp_media_stream_handler_new
2750 tp_media_stream_handler_init_known_interfaces
26962751 TpMediaStreamHandler
26972752 TpMediaStreamHandlerClass
26982753 <SUBSECTION>
27972852 TpContactClass
27982853 TpContactPrivate
27992854 </SECTION>
2855
2856 <SECTION>
2857 <FILE>svc-account</FILE>
2858 <INCLUDE>telepathy-glib/svc-account.h</INCLUDE>
2859 <TITLE>svc-account</TITLE>
2860 TpSvcAccount
2861 TpSvcAccountClass
2862 tp_svc_account_emit_account_property_changed
2863 tp_svc_account_emit_removed
2864 tp_svc_account_reconnect_impl
2865 tp_svc_account_return_from_reconnect
2866 tp_svc_account_implement_reconnect
2867 tp_svc_account_remove_impl
2868 tp_svc_account_return_from_remove
2869 tp_svc_account_implement_remove
2870 tp_svc_account_update_parameters_impl
2871 tp_svc_account_return_from_update_parameters
2872 tp_svc_account_implement_update_parameters
2873 <SUBSECTION Standard>
2874 TP_SVC_ACCOUNT
2875 TP_IS_SVC_ACCOUNT
2876 TP_TYPE_SVC_ACCOUNT
2877 tp_svc_account_get_type
2878 TP_SVC_ACCOUNT_GET_CLASS
2879 <SUBSECTION>
2880 TpSvcAccountInterfaceAvatar
2881 TpSvcAccountInterfaceAvatarClass
2882 tp_svc_account_interface_avatar_emit_avatar_changed
2883 <SUBSECTION Standard>
2884 TP_SVC_ACCOUNT_INTERFACE_AVATAR
2885 TP_IS_SVC_ACCOUNT_INTERFACE_AVATAR
2886 TP_TYPE_SVC_ACCOUNT_INTERFACE_AVATAR
2887 tp_svc_account_interface_avatar_get_type
2888 TP_SVC_ACCOUNT_INTERFACE_AVATAR_GET_CLASS
2889 </SECTION>
2890
2891 <SECTION>
2892 <FILE>svc-account-manager</FILE>
2893 <INCLUDE>telepathy-glib/svc-account-manager.h</INCLUDE>
2894 <TITLE>svc-account-manager</TITLE>
2895 TpSvcAccountManager
2896 TpSvcAccountManagerClass
2897 tp_svc_account_manager_emit_account_removed
2898 tp_svc_account_manager_emit_account_validity_changed
2899 tp_svc_account_manager_create_account_impl
2900 tp_svc_account_manager_return_from_create_account
2901 tp_svc_account_manager_implement_create_account
2902 <SUBSECTION Standard>
2903 TP_SVC_ACCOUNT_MANAGER
2904 TP_IS_SVC_ACCOUNT_MANAGER
2905 TP_TYPE_SVC_ACCOUNT_MANAGER
2906 tp_svc_account_manager_get_type
2907 TP_SVC_ACCOUNT_MANAGER_GET_CLASS
2908 </SECTION>
2909
2910 <SECTION>
2911 <FILE>account</FILE>
2912 <INCLUDE>telepathy-glib/account.h</INCLUDE>
2913 <TITLE>account</TITLE>
2914 TpAccount
2915 TpAccountClass
2916 tp_account_new
2917 tp_account_init_known_interfaces
2918 <SUBSECTION>
2919 tp_cli_account_callback_for_reconnect
2920 tp_cli_account_call_reconnect
2921 tp_cli_account_callback_for_remove
2922 tp_cli_account_call_remove
2923 tp_cli_account_callback_for_update_parameters
2924 tp_cli_account_call_update_parameters
2925 tp_cli_account_signal_callback_account_property_changed
2926 tp_cli_account_connect_to_account_property_changed
2927 tp_cli_account_signal_callback_removed
2928 tp_cli_account_connect_to_removed
2929 <SUBSECTION>
2930 tp_cli_account_interface_avatar_signal_callback_avatar_changed
2931 tp_cli_account_interface_avatar_connect_to_avatar_changed
2932 <SUBSECTION Standard>
2933 TP_ACCOUNT
2934 TP_IS_ACCOUNT
2935 TP_IS_ACCOUNT_CLASS
2936 TP_TYPE_ACCOUNT
2937 tp_account_get_type
2938 TP_ACCOUNT_CLASS
2939 TP_ACCOUNT_GET_CLASS
2940 TpAccountPrivate
2941 TpAccountClassPrivate
2942 </SECTION>
2943
2944 <SECTION>
2945 <FILE>account-manager</FILE>
2946 <INCLUDE>telepathy-glib/account-manager.h</INCLUDE>
2947 <TITLE>account-manager</TITLE>
2948 TpAccountManager
2949 TpAccountManagerClass
2950 tp_account_manager_new
2951 tp_account_manager_init_known_interfaces
2952 <SUBSECTION>
2953 tp_cli_account_manager_callback_for_create_account
2954 tp_cli_account_manager_call_create_account
2955 tp_cli_account_manager_signal_callback_account_removed
2956 tp_cli_account_manager_connect_to_account_removed
2957 tp_cli_account_manager_signal_callback_account_validity_changed
2958 tp_cli_account_manager_connect_to_account_validity_changed
2959 <SUBSECTION Standard>
2960 TP_ACCOUNT_MANAGER
2961 TP_IS_ACCOUNT_MANAGER
2962 TP_IS_ACCOUNT_MANAGER_CLASS
2963 TP_TYPE_ACCOUNT_MANAGER
2964 tp_account_manager_get_type
2965 TP_ACCOUNT_MANAGER_CLASS
2966 TP_ACCOUNT_MANAGER_GET_CLASS
2967 TpAccountManagerPrivate
2968 TpAccountManagerClassPrivate
2969 </SECTION>
2970
2971 <SECTION>
2972 <FILE>channel-dispatcher</FILE>
2973 <INCLUDE>telepathy-glib/channel-dispatcher.h</INCLUDE>
2974 <TITLE>channel-dispatcher</TITLE>
2975 TpChannelDispatcher
2976 TpChannelDispatcherClass
2977 tp_channel_dispatcher_new
2978 tp_channel_dispatcher_init_known_interfaces
2979 <SUBSECTION>
2980 tp_cli_channel_dispatcher_callback_for_create_channel
2981 tp_cli_channel_dispatcher_call_create_channel
2982 tp_cli_channel_dispatcher_callback_for_ensure_channel
2983 tp_cli_channel_dispatcher_call_ensure_channel
2984 <SUBSECTION>
2985 tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished
2986 tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished
2987 tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation
2988 tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation
2989 <SUBSECTION Standard>
2990 TP_CHANNEL_DISPATCHER
2991 TP_IS_CHANNEL_DISPATCHER
2992 TP_IS_CHANNEL_DISPATCHER_CLASS
2993 TP_TYPE_CHANNEL_DISPATCHER
2994 tp_channel_dispatcher_get_type
2995 TP_CHANNEL_DISPATCHER_CLASS
2996 TP_CHANNEL_DISPATCHER_GET_CLASS
2997 TpChannelDispatcherPrivate
2998 TpChannelDispatcherClassPrivate
2999 </SECTION>
3000
3001 <SECTION>
3002 <FILE>svc-channel-dispatcher</FILE>
3003 <INCLUDE>telepathy-glib/svc-channel-dispatcher.h</INCLUDE>
3004 <TITLE>svc-channel-dispatcher</TITLE>
3005 TpSvcChannelDispatcher
3006 TpSvcChannelDispatcherClass
3007 tp_svc_channel_dispatcher_return_from_create_channel
3008 tp_svc_channel_dispatcher_create_channel_impl
3009 tp_svc_channel_dispatcher_implement_create_channel
3010 tp_svc_channel_dispatcher_return_from_ensure_channel
3011 tp_svc_channel_dispatcher_ensure_channel_impl
3012 tp_svc_channel_dispatcher_implement_ensure_channel
3013 <SUBSECTION>
3014 TpSvcChannelDispatcherInterfaceOperationList
3015 TpSvcChannelDispatcherInterfaceOperationListClass
3016 tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation
3017 tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished
3018 <SUBSECTION Standard>
3019 TP_SVC_CHANNEL_DISPATCHER
3020 TP_SVC_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST
3021 TP_IS_SVC_CHANNEL_DISPATCHER
3022 TP_IS_SVC_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST
3023 TP_TYPE_SVC_CHANNEL_DISPATCHER
3024 TP_TYPE_SVC_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST
3025 tp_svc_channel_dispatcher_get_type
3026 tp_svc_channel_dispatcher_interface_operation_list_get_type
3027 TP_SVC_CHANNEL_DISPATCHER_GET_CLASS
3028 TP_SVC_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST_GET_CLASS
3029 </SECTION>
3030
3031 <SECTION>
3032 <FILE>channel-dispatch-operation</FILE>
3033 <INCLUDE>telepathy-glib/channel-dispatch-operation.h</INCLUDE>
3034 <TITLE>channel-dispatch-operation</TITLE>
3035 TpChannelDispatchOperation
3036 TpChannelDispatchOperationClass
3037 tp_channel_dispatch_operation_new
3038 tp_channel_dispatch_operation_init_known_interfaces
3039 <SUBSECTION>
3040 tp_cli_channel_dispatch_operation_callback_for_claim
3041 tp_cli_channel_dispatch_operation_call_claim
3042 tp_cli_channel_dispatch_operation_callback_for_handle_with
3043 tp_cli_channel_dispatch_operation_call_handle_with
3044 tp_cli_channel_dispatch_operation_signal_callback_channel_lost
3045 tp_cli_channel_dispatch_operation_connect_to_channel_lost
3046 tp_cli_channel_dispatch_operation_signal_callback_finished
3047 tp_cli_channel_dispatch_operation_connect_to_finished
3048 <SUBSECTION Standard>
3049 TP_CHANNEL_DISPATCH_OPERATION
3050 TP_CHANNEL_DISPATCH_OPERATION_CLASS
3051 TP_CHANNEL_DISPATCH_OPERATION_GET_CLASS
3052 TP_IS_CHANNEL_DISPATCH_OPERATION
3053 TP_IS_CHANNEL_DISPATCH_OPERATION_CLASS
3054 TP_TYPE_CHANNEL_DISPATCH_OPERATION
3055 tp_channel_dispatch_operation_get_type
3056 </SECTION>
3057
3058 <SECTION>
3059 <FILE>channel-request</FILE>
3060 <INCLUDE>telepathy-glib/channel-request.h</INCLUDE>
3061 <TITLE>channel-request</TITLE>
3062 TpChannelRequest
3063 TpChannelRequestClass
3064 tp_channel_request_new
3065 tp_channel_request_init_known_interfaces
3066 <SUBSECTION>
3067 tp_cli_channel_request_callback_for_cancel
3068 tp_cli_channel_request_call_cancel
3069 tp_cli_channel_request_callback_for_proceed
3070 tp_cli_channel_request_call_proceed
3071 tp_cli_channel_request_signal_callback_failed
3072 tp_cli_channel_request_connect_to_failed
3073 tp_cli_channel_request_signal_callback_succeeded
3074 tp_cli_channel_request_connect_to_succeeded
3075 <SUBSECTION Standard>
3076 TP_CHANNEL_REQUEST
3077 TP_CHANNEL_REQUEST_CLASS
3078 TP_CHANNEL_REQUEST_GET_CLASS
3079 TP_IS_CHANNEL_REQUEST
3080 TP_IS_CHANNEL_REQUEST_CLASS
3081 TP_TYPE_CHANNEL_REQUEST
3082 TpChannelRequestClassPrivate
3083 TpChannelRequestPrivate
3084 tp_channel_request_get_type
3085 </SECTION>
3086
3087 <SECTION>
3088 <FILE>svc-channel-dispatch-operation</FILE>
3089 <INCLUDE>telepathy-glib/svc-channel-dispatch-operation.h</INCLUDE>
3090 <TITLE>svc-channel-dispatch-operation</TITLE>
3091 TpSvcChannelDispatchOperation
3092 TpSvcChannelDispatchOperationClass
3093 tp_svc_channel_dispatch_operation_return_from_claim
3094 tp_svc_channel_dispatch_operation_claim_impl
3095 tp_svc_channel_dispatch_operation_implement_claim
3096 tp_svc_channel_dispatch_operation_return_from_handle_with
3097 tp_svc_channel_dispatch_operation_handle_with_impl
3098 tp_svc_channel_dispatch_operation_implement_handle_with
3099 tp_svc_channel_dispatch_operation_emit_channel_lost
3100 tp_svc_channel_dispatch_operation_emit_finished
3101 <SUBSECTION Standard>
3102 tp_svc_channel_dispatch_operation_get_type
3103 TP_IS_SVC_CHANNEL_DISPATCH_OPERATION
3104 TP_SVC_CHANNEL_DISPATCH_OPERATION
3105 TP_SVC_CHANNEL_DISPATCH_OPERATION_GET_CLASS
3106 TP_TYPE_SVC_CHANNEL_DISPATCH_OPERATION
3107 </SECTION>
3108
3109 <SECTION>
3110 <FILE>svc-channel-request</FILE>
3111 <INCLUDE>telepathy-glib/svc-channel-request.h</INCLUDE>
3112 <TITLE>svc-channel-request</TITLE>
3113 TpSvcChannelRequest
3114 TpSvcChannelRequestClass
3115 tp_svc_channel_request_return_from_proceed
3116 tp_svc_channel_request_proceed_impl
3117 tp_svc_channel_request_implement_proceed
3118 tp_svc_channel_request_return_from_cancel
3119 tp_svc_channel_request_cancel_impl
3120 tp_svc_channel_request_implement_cancel
3121 tp_svc_channel_request_emit_failed
3122 tp_svc_channel_request_emit_succeeded
3123 <SUBSECTION Standard>
3124 tp_svc_channel_request_get_type
3125 TP_IS_SVC_CHANNEL_REQUEST
3126 TP_SVC_CHANNEL_REQUEST
3127 TP_SVC_CHANNEL_REQUEST_GET_CLASS
3128 TP_TYPE_SVC_CHANNEL_REQUEST
3129 </SECTION>
3130
3131 <SECTION>
3132 <FILE>client</FILE>
3133 <INCLUDE>telepathy-glib/client.h</INCLUDE>
3134 <TITLE>client</TITLE>
3135 TpClient
3136 TpClientClass
3137 tp_client_init_known_interfaces
3138 <SUBSECTION>
3139 tp_cli_client_observer_callback_for_observe_channels
3140 tp_cli_client_observer_call_observe_channels
3141 <SUBSECTION>
3142 tp_cli_client_handler_callback_for_handle_channels
3143 tp_cli_client_handler_call_handle_channels
3144 tp_cli_client_interface_requests_callback_for_add_request
3145 tp_cli_client_interface_requests_call_add_request
3146 tp_cli_client_interface_requests_callback_for_remove_request
3147 tp_cli_client_interface_requests_call_remove_request
3148 <SUBSECTION>
3149 tp_cli_client_approver_callback_for_add_dispatch_operation
3150 tp_cli_client_approver_call_add_dispatch_operation
3151 <SUBSECTION Standard>
3152 tp_client_get_type
3153 TP_CLIENT
3154 TP_CLIENT_CLASS
3155 TP_CLIENT_GET_CLASS
3156 TP_IS_CLIENT
3157 TP_IS_CLIENT_CLASS
3158 TP_TYPE_CLIENT
3159 TpClientClassPrivate
3160 TpClientPrivate
3161 </SECTION>
3162
3163 <SECTION>
3164 <FILE>svc-client</FILE>
3165 <INCLUDE>telepathy-glib/svc-client.h</INCLUDE>
3166 <TITLE>svc-client</TITLE>
3167 TpSvcClient
3168 TpSvcClientClass
3169 <SUBSECTION>
3170 TpSvcClientApprover
3171 TpSvcClientApproverClass
3172 tp_svc_client_approver_return_from_add_dispatch_operation
3173 tp_svc_client_approver_add_dispatch_operation_impl
3174 tp_svc_client_approver_implement_add_dispatch_operation
3175 <SUBSECTION>
3176 TpSvcClientHandler
3177 TpSvcClientHandlerClass
3178 tp_svc_client_handler_return_from_handle_channels
3179 tp_svc_client_handler_handle_channels_impl
3180 tp_svc_client_handler_implement_handle_channels
3181 TpSvcClientInterfaceRequests
3182 TpSvcClientInterfaceRequestsClass
3183 tp_svc_client_interface_requests_return_from_add_request
3184 tp_svc_client_interface_requests_add_request_impl
3185 tp_svc_client_interface_requests_implement_add_request
3186 tp_svc_client_interface_requests_return_from_remove_request
3187 tp_svc_client_interface_requests_remove_request_impl
3188 tp_svc_client_interface_requests_implement_remove_request
3189 <SUBSECTION>
3190 TpSvcClientObserver
3191 TpSvcClientObserverClass
3192 tp_svc_client_observer_return_from_observe_channels
3193 tp_svc_client_observer_observe_channels_impl
3194 tp_svc_client_observer_implement_observe_channels
3195 <SUBSECTION Standard>
3196 tp_svc_client_get_type
3197 tp_svc_client_approver_get_type
3198 tp_svc_client_handler_get_type
3199 tp_svc_client_interface_requests_get_type
3200 tp_svc_client_observer_get_type
3201 TP_IS_SVC_CLIENT
3202 TP_IS_SVC_CLIENT_APPROVER
3203 TP_IS_SVC_CLIENT_HANDLER
3204 TP_IS_SVC_CLIENT_INTERFACE_REQUESTS
3205 TP_IS_SVC_CLIENT_OBSERVER
3206 TP_SVC_CLIENT
3207 TP_SVC_CLIENT_APPROVER
3208 TP_SVC_CLIENT_APPROVER_GET_CLASS
3209 TP_SVC_CLIENT_GET_CLASS
3210 TP_SVC_CLIENT_HANDLER
3211 TP_SVC_CLIENT_HANDLER_GET_CLASS
3212 TP_SVC_CLIENT_INTERFACE_REQUESTS
3213 TP_SVC_CLIENT_INTERFACE_REQUESTS_GET_CLASS
3214 TP_SVC_CLIENT_OBSERVER
3215 TP_SVC_CLIENT_OBSERVER_GET_CLASS
3216 TP_TYPE_SVC_CLIENT
3217 TP_TYPE_SVC_CLIENT_APPROVER
3218 TP_TYPE_SVC_CLIENT_HANDLER
3219 TP_TYPE_SVC_CLIENT_INTERFACE_REQUESTS
3220 TP_TYPE_SVC_CLIENT_OBSERVER
3221 </SECTION>
0 #include <telepathy-glib/account.h>
1 #include <telepathy-glib/account-manager.h>
02 #include <telepathy-glib/base-connection.h>
13 #include <telepathy-glib/base-connection-manager.h>
24 #include <telepathy-glib/channel-factory-iface.h>
35 #include <telepathy-glib/channel.h>
6 #include <telepathy-glib/channel-dispatcher.h>
7 #include <telepathy-glib/channel-dispatch-operation.h>
48 #include <telepathy-glib/channel-iface.h>
59 #include <telepathy-glib/channel-manager.h>
10 #include <telepathy-glib/channel-request.h>
11 #include <telepathy-glib/client.h>
612 #include <telepathy-glib/connection.h>
713 #include <telepathy-glib/connection-manager.h>
814 #include <telepathy-glib/contact.h>
1218 #include <telepathy-glib/handle-repo-static.h>
1319 #include <telepathy-glib/media-interfaces.h>
1420 #include <telepathy-glib/proxy.h>
21 #include <telepathy-glib/svc-account.h>
22 #include <telepathy-glib/svc-account-manager.h>
1523 #include <telepathy-glib/svc-channel.h>
24 #include <telepathy-glib/svc-channel-dispatcher.h>
25 #include <telepathy-glib/svc-channel-dispatch-operation.h>
26 #include <telepathy-glib/svc-channel-request.h>
27 #include <telepathy-glib/svc-client.h>
1628 #include <telepathy-glib/svc-connection.h>
1729 #include <telepathy-glib/svc-connection-manager.h>
1830 #include <telepathy-glib/svc-generic.h>
1931 #include <telepathy-glib/svc-media-interfaces.h>
2032 #include <telepathy-glib/svc-properties-interface.h>
2133
34 tp_account_get_type
35 tp_account_manager_get_type
2236 tp_base_connection_get_type
2337 tp_base_connection_manager_get_type
2438 tp_channel_factory_iface_get_type
2539 tp_channel_get_type
40 tp_channel_dispatcher_get_type
41 tp_channel_dispatch_operation_get_type
2642 tp_channel_iface_get_type
2743 tp_channel_manager_get_type
44 tp_channel_request_get_type
45 tp_client_get_type
2846 tp_connection_get_type
2947 tp_connection_manager_get_type
3048 tp_contact_get_type
3654 tp_media_session_handler_get_type
3755 tp_media_stream_handler_get_type
3856 tp_proxy_get_type
57 tp_svc_account_get_type
58 tp_svc_account_interface_avatar_get_type
59 tp_svc_account_manager_get_type
3960 tp_svc_channel_get_type
61 tp_svc_channel_dispatcher_get_type
62 tp_svc_channel_dispatcher_interface_operation_list_get_type
63 tp_svc_channel_dispatch_operation_get_type
4064 tp_svc_channel_interface_call_state_get_type
4165 tp_svc_channel_interface_chat_state_get_type
4266 tp_svc_channel_interface_dtmf_get_type
4468 tp_svc_channel_interface_hold_get_type
4569 tp_svc_channel_interface_media_signalling_get_type
4670 tp_svc_channel_interface_password_get_type
71 tp_svc_channel_request_get_type
4772 tp_svc_channel_type_contact_list_get_type
4873 tp_svc_channel_type_room_list_get_type
4974 tp_svc_channel_type_streamed_media_get_type
5075 tp_svc_channel_type_text_get_type
5176 tp_svc_channel_type_tubes_get_type
77 tp_svc_client_approver_get_type
78 tp_svc_client_get_type
79 tp_svc_client_handler_get_type
80 tp_svc_client_interface_requests_get_type
81 tp_svc_client_observer_get_type
5282 tp_svc_connection_get_type
5383 tp_svc_connection_interface_aliasing_get_type
5484 tp_svc_connection_interface_avatars_get_type
0 <!-- ##### SECTION Title ##### -->
1 account-manager
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpAccountManager ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpAccountManagerClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_account_manager_new ##### -->
32 <para>
33
34 </para>
35
36 @bus_daemon:
37 @Returns:
38
39
40 <!-- ##### FUNCTION tp_account_manager_init_known_interfaces ##### -->
41 <para>
42
43 </para>
44
45
46
47 <!-- ##### USER_FUNCTION tp_cli_account_manager_callback_for_create_account ##### -->
48 <para>
49
50 </para>
51
52 @proxy:
53 @out_Account:
54 @error:
55 @user_data:
56 @weak_object:
57
58
59 <!-- ##### FUNCTION tp_cli_account_manager_call_create_account ##### -->
60 <para>
61
62 </para>
63
64 @proxy:
65 @timeout_ms:
66 @in_Connection_Manager:
67 @in_Protocol:
68 @in_Display_Name:
69 @in_Parameters:
70 @in_Properties:
71 @callback:
72 @user_data:
73 @destroy:
74 @weak_object:
75 @Returns:
76
77
78 <!-- ##### USER_FUNCTION tp_cli_account_manager_signal_callback_account_removed ##### -->
79 <para>
80
81 </para>
82
83 @proxy:
84 @arg_Account:
85 @user_data:
86 @weak_object:
87
88
89 <!-- ##### FUNCTION tp_cli_account_manager_connect_to_account_removed ##### -->
90 <para>
91
92 </para>
93
94 @proxy:
95 @callback:
96 @user_data:
97 @destroy:
98 @weak_object:
99 @error:
100 @Returns:
101
102
103 <!-- ##### USER_FUNCTION tp_cli_account_manager_signal_callback_account_validity_changed ##### -->
104 <para>
105
106 </para>
107
108 @proxy:
109 @arg_Account:
110 @arg_Valid:
111 @user_data:
112 @weak_object:
113
114
115 <!-- ##### FUNCTION tp_cli_account_manager_connect_to_account_validity_changed ##### -->
116 <para>
117
118 </para>
119
120 @proxy:
121 @callback:
122 @user_data:
123 @destroy:
124 @weak_object:
125 @error:
126 @Returns:
127
128
0 <!-- ##### SECTION Title ##### -->
1 account
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpAccount ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpAccountClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_account_new ##### -->
32 <para>
33
34 </para>
35
36 @bus_daemon:
37 @object_path:
38 @error:
39 @Returns:
40
41
42 <!-- ##### FUNCTION tp_account_init_known_interfaces ##### -->
43 <para>
44
45 </para>
46
47
48
49 <!-- ##### USER_FUNCTION tp_cli_account_callback_for_reconnect ##### -->
50 <para>
51
52 </para>
53
54 @proxy:
55 @error:
56 @user_data:
57 @weak_object:
58
59
60 <!-- ##### FUNCTION tp_cli_account_call_reconnect ##### -->
61 <para>
62
63 </para>
64
65 @proxy:
66 @timeout_ms:
67 @callback:
68 @user_data:
69 @destroy:
70 @weak_object:
71 @Returns:
72
73
74 <!-- ##### USER_FUNCTION tp_cli_account_callback_for_remove ##### -->
75 <para>
76
77 </para>
78
79 @proxy:
80 @error:
81 @user_data:
82 @weak_object:
83
84
85 <!-- ##### FUNCTION tp_cli_account_call_remove ##### -->
86 <para>
87
88 </para>
89
90 @proxy:
91 @timeout_ms:
92 @callback:
93 @user_data:
94 @destroy:
95 @weak_object:
96 @Returns:
97
98
99 <!-- ##### USER_FUNCTION tp_cli_account_callback_for_update_parameters ##### -->
100 <para>
101
102 </para>
103
104 @proxy:
105 @out_Reconnect_Required:
106 @error:
107 @user_data:
108 @weak_object:
109
110
111 <!-- ##### FUNCTION tp_cli_account_call_update_parameters ##### -->
112 <para>
113
114 </para>
115
116 @proxy:
117 @timeout_ms:
118 @in_Set:
119 @in_Unset:
120 @callback:
121 @user_data:
122 @destroy:
123 @weak_object:
124 @Returns:
125
126
127 <!-- ##### USER_FUNCTION tp_cli_account_signal_callback_account_property_changed ##### -->
128 <para>
129
130 </para>
131
132 @proxy:
133 @arg_Properties:
134 @user_data:
135 @weak_object:
136
137
138 <!-- ##### FUNCTION tp_cli_account_connect_to_account_property_changed ##### -->
139 <para>
140
141 </para>
142
143 @proxy:
144 @callback:
145 @user_data:
146 @destroy:
147 @weak_object:
148 @error:
149 @Returns:
150
151
152 <!-- ##### USER_FUNCTION tp_cli_account_signal_callback_removed ##### -->
153 <para>
154
155 </para>
156
157 @proxy:
158 @user_data:
159 @weak_object:
160
161
162 <!-- ##### FUNCTION tp_cli_account_connect_to_removed ##### -->
163 <para>
164
165 </para>
166
167 @proxy:
168 @callback:
169 @user_data:
170 @destroy:
171 @weak_object:
172 @error:
173 @Returns:
174
175
176 <!-- ##### USER_FUNCTION tp_cli_account_interface_avatar_signal_callback_avatar_changed ##### -->
177 <para>
178
179 </para>
180
181 @proxy:
182 @user_data:
183 @weak_object:
184
185
186 <!-- ##### FUNCTION tp_cli_account_interface_avatar_connect_to_avatar_changed ##### -->
187 <para>
188
189 </para>
190
191 @proxy:
192 @callback:
193 @user_data:
194 @destroy:
195 @weak_object:
196 @error:
197 @Returns:
198
199
0 <!-- ##### SECTION Title ##### -->
1 channel-dispatch-operation
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpChannelDispatchOperation ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpChannelDispatchOperationClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_channel_dispatch_operation_new ##### -->
32 <para>
33
34 </para>
35
36 @bus_daemon:
37 @object_path:
38 @immutable_properties:
39 @error:
40 @Returns:
41
42
43 <!-- ##### FUNCTION tp_channel_dispatch_operation_init_known_interfaces ##### -->
44 <para>
45
46 </para>
47
48
49
50 <!-- ##### USER_FUNCTION tp_cli_channel_dispatch_operation_callback_for_claim ##### -->
51 <para>
52
53 </para>
54
55 @proxy:
56 @error:
57 @user_data:
58 @weak_object:
59
60
61 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_call_claim ##### -->
62 <para>
63
64 </para>
65
66 @proxy:
67 @timeout_ms:
68 @callback:
69 @user_data:
70 @destroy:
71 @weak_object:
72 @Returns:
73
74
75 <!-- ##### USER_FUNCTION tp_cli_channel_dispatch_operation_callback_for_handle_with ##### -->
76 <para>
77
78 </para>
79
80 @proxy:
81 @error:
82 @user_data:
83 @weak_object:
84
85
86 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_call_handle_with ##### -->
87 <para>
88
89 </para>
90
91 @proxy:
92 @timeout_ms:
93 @in_Handler:
94 @callback:
95 @user_data:
96 @destroy:
97 @weak_object:
98 @Returns:
99
100
101 <!-- ##### USER_FUNCTION tp_cli_channel_dispatch_operation_signal_callback_channel_lost ##### -->
102 <para>
103
104 </para>
105
106 @proxy:
107 @arg_Channel:
108 @arg_Error:
109 @arg_Message:
110 @user_data:
111 @weak_object:
112
113
114 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_connect_to_channel_lost ##### -->
115 <para>
116
117 </para>
118
119 @proxy:
120 @callback:
121 @user_data:
122 @destroy:
123 @weak_object:
124 @error:
125 @Returns:
126
127
128 <!-- ##### USER_FUNCTION tp_cli_channel_dispatch_operation_signal_callback_finished ##### -->
129 <para>
130
131 </para>
132
133 @proxy:
134 @user_data:
135 @weak_object:
136
137
138 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_connect_to_finished ##### -->
139 <para>
140
141 </para>
142
143 @proxy:
144 @callback:
145 @user_data:
146 @destroy:
147 @weak_object:
148 @error:
149 @Returns:
150
151
0 <!-- ##### SECTION Title ##### -->
1 channel-dispatcher
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpChannelDispatcher ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpChannelDispatcherClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_channel_dispatcher_new ##### -->
32 <para>
33
34 </para>
35
36 @bus_daemon:
37 @Returns:
38
39
40 <!-- ##### FUNCTION tp_channel_dispatcher_init_known_interfaces ##### -->
41 <para>
42
43 </para>
44
45
46
47 <!-- ##### USER_FUNCTION tp_cli_channel_dispatcher_callback_for_create_channel ##### -->
48 <para>
49
50 </para>
51
52 @proxy:
53 @out_Request:
54 @error:
55 @user_data:
56 @weak_object:
57
58
59 <!-- ##### FUNCTION tp_cli_channel_dispatcher_call_create_channel ##### -->
60 <para>
61
62 </para>
63
64 @proxy:
65 @timeout_ms:
66 @in_Account:
67 @in_Requested_Properties:
68 @in_User_Action_Time:
69 @in_Preferred_Handler:
70 @callback:
71 @user_data:
72 @destroy:
73 @weak_object:
74 @Returns:
75
76
77 <!-- ##### USER_FUNCTION tp_cli_channel_dispatcher_callback_for_ensure_channel ##### -->
78 <para>
79
80 </para>
81
82 @proxy:
83 @out_Request:
84 @error:
85 @user_data:
86 @weak_object:
87
88
89 <!-- ##### FUNCTION tp_cli_channel_dispatcher_call_ensure_channel ##### -->
90 <para>
91
92 </para>
93
94 @proxy:
95 @timeout_ms:
96 @in_Account:
97 @in_Requested_Properties:
98 @in_User_Action_Time:
99 @in_Preferred_Handler:
100 @callback:
101 @user_data:
102 @destroy:
103 @weak_object:
104 @Returns:
105
106
107 <!-- ##### USER_FUNCTION tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ##### -->
108 <para>
109
110 </para>
111
112 @proxy:
113 @arg_Dispatch_Operation:
114 @user_data:
115 @weak_object:
116
117
118 <!-- ##### FUNCTION tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ##### -->
119 <para>
120
121 </para>
122
123 @proxy:
124 @callback:
125 @user_data:
126 @destroy:
127 @weak_object:
128 @error:
129 @Returns:
130
131
132 <!-- ##### USER_FUNCTION tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ##### -->
133 <para>
134
135 </para>
136
137 @proxy:
138 @arg_Dispatch_Operation:
139 @arg_Properties:
140 @user_data:
141 @weak_object:
142
143
144 <!-- ##### FUNCTION tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ##### -->
145 <para>
146
147 </para>
148
149 @proxy:
150 @callback:
151 @user_data:
152 @destroy:
153 @weak_object:
154 @error:
155 @Returns:
156
157
0 <!-- ##### SECTION Title ##### -->
1 channel-request
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpChannelRequest ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### SIGNAL TpChannelRequest::succeeded ##### -->
26 <para>
27
28 </para>
29
30 @tpchannelrequest: the object which received the signal.
31
32 <!-- ##### STRUCT TpChannelRequestClass ##### -->
33 <para>
34
35 </para>
36
37
38 <!-- ##### FUNCTION tp_channel_request_new ##### -->
39 <para>
40
41 </para>
42
43 @bus_daemon:
44 @object_path:
45 @immutable_properties:
46 @error:
47 @Returns:
48
49
50 <!-- ##### FUNCTION tp_channel_request_init_known_interfaces ##### -->
51 <para>
52
53 </para>
54
55
56
57 <!-- ##### USER_FUNCTION tp_cli_channel_request_callback_for_cancel ##### -->
58 <para>
59
60 </para>
61
62 @proxy:
63 @error:
64 @user_data:
65 @weak_object:
66
67
68 <!-- ##### FUNCTION tp_cli_channel_request_call_cancel ##### -->
69 <para>
70
71 </para>
72
73 @proxy:
74 @timeout_ms:
75 @callback:
76 @user_data:
77 @destroy:
78 @weak_object:
79 @Returns:
80
81
82 <!-- ##### USER_FUNCTION tp_cli_channel_request_callback_for_proceed ##### -->
83 <para>
84
85 </para>
86
87 @proxy:
88 @error:
89 @user_data:
90 @weak_object:
91
92
93 <!-- ##### FUNCTION tp_cli_channel_request_call_proceed ##### -->
94 <para>
95
96 </para>
97
98 @proxy:
99 @timeout_ms:
100 @callback:
101 @user_data:
102 @destroy:
103 @weak_object:
104 @Returns:
105
106
107 <!-- ##### USER_FUNCTION tp_cli_channel_request_signal_callback_failed ##### -->
108 <para>
109
110 </para>
111
112 @proxy:
113 @arg_Error:
114 @arg_Message:
115 @user_data:
116 @weak_object:
117
118
119 <!-- ##### FUNCTION tp_cli_channel_request_connect_to_failed ##### -->
120 <para>
121
122 </para>
123
124 @proxy:
125 @callback:
126 @user_data:
127 @destroy:
128 @weak_object:
129 @error:
130 @Returns:
131
132
133 <!-- ##### USER_FUNCTION tp_cli_channel_request_signal_callback_succeeded ##### -->
134 <para>
135
136 </para>
137
138 @proxy:
139 @user_data:
140 @weak_object:
141
142
143 <!-- ##### FUNCTION tp_cli_channel_request_connect_to_succeeded ##### -->
144 <para>
145
146 </para>
147
148 @proxy:
149 @callback:
150 @user_data:
151 @destroy:
152 @weak_object:
153 @error:
154 @Returns:
155
156
0 <!-- ##### SECTION Title ##### -->
1 client
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpClient ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpClientClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_client_init_known_interfaces ##### -->
32 <para>
33
34 </para>
35
36
37
38 <!-- ##### USER_FUNCTION tp_cli_client_observer_callback_for_observe_channels ##### -->
39 <para>
40
41 </para>
42
43 @proxy:
44 @error:
45 @user_data:
46 @weak_object:
47
48
49 <!-- ##### FUNCTION tp_cli_client_observer_call_observe_channels ##### -->
50 <para>
51
52 </para>
53
54 @proxy:
55 @timeout_ms:
56 @in_Account:
57 @in_Connection:
58 @in_Channels:
59 @in_Dispatch_Operation:
60 @in_Requests_Satisfied:
61 @in_Observer_Info:
62 @callback:
63 @user_data:
64 @destroy:
65 @weak_object:
66 @Returns:
67
68
69 <!-- ##### USER_FUNCTION tp_cli_client_handler_callback_for_handle_channels ##### -->
70 <para>
71
72 </para>
73
74 @proxy:
75 @error:
76 @user_data:
77 @weak_object:
78
79
80 <!-- ##### FUNCTION tp_cli_client_handler_call_handle_channels ##### -->
81 <para>
82
83 </para>
84
85 @proxy:
86 @timeout_ms:
87 @in_Account:
88 @in_Connection:
89 @in_Channels:
90 @in_Requests_Satisfied:
91 @in_User_Action_Time:
92 @in_Handler_Info:
93 @callback:
94 @user_data:
95 @destroy:
96 @weak_object:
97 @Returns:
98
99
100 <!-- ##### USER_FUNCTION tp_cli_client_interface_requests_callback_for_add_request ##### -->
101 <para>
102
103 </para>
104
105 @proxy:
106 @error:
107 @user_data:
108 @weak_object:
109
110
111 <!-- ##### FUNCTION tp_cli_client_interface_requests_call_add_request ##### -->
112 <para>
113
114 </para>
115
116 @proxy:
117 @timeout_ms:
118 @in_Request:
119 @in_Properties:
120 @callback:
121 @user_data:
122 @destroy:
123 @weak_object:
124 @Returns:
125
126
127 <!-- ##### USER_FUNCTION tp_cli_client_interface_requests_callback_for_remove_request ##### -->
128 <para>
129
130 </para>
131
132 @proxy:
133 @error:
134 @user_data:
135 @weak_object:
136
137
138 <!-- ##### FUNCTION tp_cli_client_interface_requests_call_remove_request ##### -->
139 <para>
140
141 </para>
142
143 @proxy:
144 @timeout_ms:
145 @in_Request:
146 @in_Error:
147 @in_Message:
148 @callback:
149 @user_data:
150 @destroy:
151 @weak_object:
152 @Returns:
153
154
155 <!-- ##### USER_FUNCTION tp_cli_client_approver_callback_for_add_dispatch_operation ##### -->
156 <para>
157
158 </para>
159
160 @proxy:
161 @error:
162 @user_data:
163 @weak_object:
164
165
166 <!-- ##### FUNCTION tp_cli_client_approver_call_add_dispatch_operation ##### -->
167 <para>
168
169 </para>
170
171 @proxy:
172 @timeout_ms:
173 @in_Channels:
174 @in_DispatchOperation:
175 @in_Properties:
176 @callback:
177 @user_data:
178 @destroy:
179 @weak_object:
180 @Returns:
181
182
361361 @Returns:
362362
363363
364 <!-- ##### FUNCTION tp_connection_manager_init_known_interfaces ##### -->
365 <para>
366
367 </para>
368
369
370
364371 <!-- ##### USER_FUNCTION tp_cli_connection_manager_callback_for_get_parameters ##### -->
365372 <para>
366373
226226 @destroy:
227227
228228
229 <!-- ##### FUNCTION tp_dbus_daemon_init_known_interfaces ##### -->
230 <para>
231
232 </para>
233
234
235
229236 <!-- ##### FUNCTION tp_cli_dbus_daemon_call_add_match ##### -->
230237 <para>
231238
4444
4545
4646
47 <!-- ##### MACRO TP_ACCOUNT_MANAGER_BUS_NAME ##### -->
48 <para>
49
50 </para>
51
52
53
54 <!-- ##### MACRO TP_ACCOUNT_MANAGER_OBJECT_PATH ##### -->
55 <para>
56
57 </para>
58
59
60
61 <!-- ##### MACRO TP_ACCOUNT_OBJECT_PATH_BASE ##### -->
62 <para>
63
64 </para>
65
66
67
68 <!-- ##### MACRO TP_CHANNEL_DISPATCHER_BUS_NAME ##### -->
69 <para>
70
71 </para>
72
73
74
75 <!-- ##### MACRO TP_CHANNEL_DISPATCHER_OBJECT_PATH ##### -->
76 <para>
77
78 </para>
79
80
81
82 <!-- ##### MACRO TP_CLIENT_BUS_NAME_BASE ##### -->
83 <para>
84
85 </para>
86
87
88
89 <!-- ##### MACRO TP_CLIENT_OBJECT_PATH_BASE ##### -->
90 <para>
91
92 </para>
93
94
95
571571
572572
573573
574 <!-- ##### MACRO TP_STRUCT_TYPE_AVATAR ##### -->
575 <para>
576
577 </para>
578
579
580
581 <!-- ##### MACRO TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS ##### -->
582 <para>
583
584 </para>
585
586
587
588 <!-- ##### MACRO TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST ##### -->
589 <para>
590
591 </para>
592
593
594
1616 <!-- ##### SECTION Stability_Level ##### -->
1717
1818
19 <!-- ##### MACRO TP_IFACE_ACCOUNT ##### -->
20 <para>
21
22 </para>
23
24
25
26 <!-- ##### MACRO TP_IFACE_QUARK_ACCOUNT ##### -->
27 <para>
28
29 </para>
30
31
32
33 <!-- ##### MACRO TP_IFACE_ACCOUNT_INTERFACE_AVATAR ##### -->
34 <para>
35
36 </para>
37
38
39
40 <!-- ##### MACRO TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR ##### -->
41 <para>
42
43 </para>
44
45
46
47 <!-- ##### MACRO TP_IFACE_ACCOUNT_MANAGER ##### -->
48 <para>
49
50 </para>
51
52
53
54 <!-- ##### MACRO TP_IFACE_QUARK_ACCOUNT_MANAGER ##### -->
55 <para>
56
57 </para>
58
59
60
1961 <!-- ##### MACRO TP_IFACE_DBUS_DAEMON ##### -->
2062 <para>
2163
464506
465507
466508
509 <!-- ##### MACRO TP_IFACE_CHANNEL_DISPATCHER ##### -->
510 <para>
511
512 </para>
513
514
515
516 <!-- ##### MACRO TP_IFACE_QUARK_CHANNEL_DISPATCHER ##### -->
517 <para>
518
519 </para>
520
521
522
523 <!-- ##### MACRO TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST ##### -->
524 <para>
525
526 </para>
527
528
529
530 <!-- ##### MACRO TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST ##### -->
531 <para>
532
533 </para>
534
535
536
537 <!-- ##### MACRO TP_IFACE_CHANNEL_DISPATCH_OPERATION ##### -->
538 <para>
539
540 </para>
541
542
543
544 <!-- ##### MACRO TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION ##### -->
545 <para>
546
547 </para>
548
549
550
551 <!-- ##### MACRO TP_IFACE_CHANNEL_REQUEST ##### -->
552 <para>
553
554 </para>
555
556
557
558 <!-- ##### MACRO TP_IFACE_QUARK_CHANNEL_REQUEST ##### -->
559 <para>
560
561 </para>
562
563
564
467565 <!-- ##### MACRO TP_IFACE_MEDIA_SESSION_HANDLER ##### -->
468566 <para>
469567
506604
507605
508606
607 <!-- ##### MACRO TP_IFACE_CLIENT ##### -->
608 <para>
609
610 </para>
611
612
613
614 <!-- ##### MACRO TP_IFACE_QUARK_CLIENT ##### -->
615 <para>
616
617 </para>
618
619
620
621 <!-- ##### MACRO TP_IFACE_CLIENT_APPROVER ##### -->
622 <para>
623
624 </para>
625
626
627
628 <!-- ##### MACRO TP_IFACE_QUARK_CLIENT_APPROVER ##### -->
629 <para>
630
631 </para>
632
633
634
635 <!-- ##### MACRO TP_IFACE_CLIENT_HANDLER ##### -->
636 <para>
637
638 </para>
639
640
641
642 <!-- ##### MACRO TP_IFACE_QUARK_CLIENT_HANDLER ##### -->
643 <para>
644
645 </para>
646
647
648
649 <!-- ##### MACRO TP_IFACE_CLIENT_OBSERVER ##### -->
650 <para>
651
652 </para>
653
654
655
656 <!-- ##### MACRO TP_IFACE_QUARK_CLIENT_OBSERVER ##### -->
657 <para>
658
659 </para>
660
661
662
663 <!-- ##### MACRO TP_IFACE_CLIENT_INTERFACE_REQUESTS ##### -->
664 <para>
665
666 </para>
667
668
669
670 <!-- ##### MACRO TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS ##### -->
671 <para>
672
673 </para>
674
675
676
2828 @Returns:
2929
3030
31 <!-- ##### FUNCTION tp_media_session_handler_init_known_interfaces ##### -->
32 <para>
33
34 </para>
35
36
37
3138 <!-- ##### STRUCT TpMediaSessionHandler ##### -->
3239 <para>
3340
5057 @object_path:
5158 @error:
5259 @Returns:
60
61
62 <!-- ##### FUNCTION tp_media_stream_handler_init_known_interfaces ##### -->
63 <para>
64
65 </para>
66
5367
5468
5569 <!-- ##### STRUCT TpMediaStreamHandler ##### -->
0 <!-- ##### SECTION Title ##### -->
1 svc-account-manager
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcAccountManager ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### SIGNAL TpSvcAccountManager::account-removed ##### -->
26 <para>
27
28 </para>
29
30 @tpsvcaccountmanager: the object which received the signal.
31 @arg1:
32
33 <!-- ##### SIGNAL TpSvcAccountManager::account-validity-changed ##### -->
34 <para>
35
36 </para>
37
38 @tpsvcaccountmanager: the object which received the signal.
39 @arg1:
40 @arg2:
41
42 <!-- ##### STRUCT TpSvcAccountManagerClass ##### -->
43 <para>
44
45 </para>
46
47
48 <!-- ##### FUNCTION tp_svc_account_manager_emit_account_removed ##### -->
49 <para>
50
51 </para>
52
53 @instance:
54 @arg_Account:
55
56
57 <!-- ##### FUNCTION tp_svc_account_manager_emit_account_validity_changed ##### -->
58 <para>
59
60 </para>
61
62 @instance:
63 @arg_Account:
64 @arg_Valid:
65
66
67 <!-- ##### USER_FUNCTION tp_svc_account_manager_create_account_impl ##### -->
68 <para>
69
70 </para>
71
72 @self:
73 @in_Connection_Manager:
74 @in_Protocol:
75 @in_Display_Name:
76 @in_Parameters:
77 @in_Properties:
78 @context:
79
80
81 <!-- ##### FUNCTION tp_svc_account_manager_return_from_create_account ##### -->
82 <para>
83
84 </para>
85
86 @context:
87 @out_Account:
88
89
90 <!-- ##### FUNCTION tp_svc_account_manager_implement_create_account ##### -->
91 <para>
92
93 </para>
94
95 @klass:
96 @impl:
97
98
0 <!-- ##### SECTION Title ##### -->
1 svc-account
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcAccount ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### SIGNAL TpSvcAccount::account-property-changed ##### -->
26 <para>
27
28 </para>
29
30 @tpsvcaccount: the object which received the signal.
31
32 <!-- ##### SIGNAL TpSvcAccount::removed ##### -->
33 <para>
34
35 </para>
36
37 @tpsvcaccount: the object which received the signal.
38
39 <!-- ##### STRUCT TpSvcAccountClass ##### -->
40 <para>
41
42 </para>
43
44
45 <!-- ##### FUNCTION tp_svc_account_emit_account_property_changed ##### -->
46 <para>
47
48 </para>
49
50 @instance:
51 @arg_Properties:
52
53
54 <!-- ##### FUNCTION tp_svc_account_emit_removed ##### -->
55 <para>
56
57 </para>
58
59 @instance:
60
61
62 <!-- ##### USER_FUNCTION tp_svc_account_reconnect_impl ##### -->
63 <para>
64
65 </para>
66
67 @self:
68 @context:
69
70
71 <!-- ##### FUNCTION tp_svc_account_return_from_reconnect ##### -->
72 <para>
73
74 </para>
75
76 @context:
77
78
79 <!-- ##### FUNCTION tp_svc_account_implement_reconnect ##### -->
80 <para>
81
82 </para>
83
84 @klass:
85 @impl:
86
87
88 <!-- ##### USER_FUNCTION tp_svc_account_remove_impl ##### -->
89 <para>
90
91 </para>
92
93 @self:
94 @context:
95
96
97 <!-- ##### FUNCTION tp_svc_account_return_from_remove ##### -->
98 <para>
99
100 </para>
101
102 @context:
103
104
105 <!-- ##### FUNCTION tp_svc_account_implement_remove ##### -->
106 <para>
107
108 </para>
109
110 @klass:
111 @impl:
112
113
114 <!-- ##### USER_FUNCTION tp_svc_account_update_parameters_impl ##### -->
115 <para>
116
117 </para>
118
119 @self:
120 @in_Set:
121 @in_Unset:
122 @context:
123
124
125 <!-- ##### FUNCTION tp_svc_account_return_from_update_parameters ##### -->
126 <para>
127
128 </para>
129
130 @context:
131 @out_Reconnect_Required:
132
133
134 <!-- ##### FUNCTION tp_svc_account_implement_update_parameters ##### -->
135 <para>
136
137 </para>
138
139 @klass:
140 @impl:
141
142
143 <!-- ##### STRUCT TpSvcAccountInterfaceAvatar ##### -->
144 <para>
145
146 </para>
147
148
149 <!-- ##### SIGNAL TpSvcAccountInterfaceAvatar::avatar-changed ##### -->
150 <para>
151
152 </para>
153
154 @tpsvcaccountinterfaceavatar: the object which received the signal.
155
156 <!-- ##### STRUCT TpSvcAccountInterfaceAvatarClass ##### -->
157 <para>
158
159 </para>
160
161
162 <!-- ##### FUNCTION tp_svc_account_interface_avatar_emit_avatar_changed ##### -->
163 <para>
164
165 </para>
166
167 @instance:
168
169
0 <!-- ##### SECTION Title ##### -->
1 svc-channel-dispatch-operation
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcChannelDispatchOperation ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### SIGNAL TpSvcChannelDispatchOperation::channel-lost ##### -->
26 <para>
27
28 </para>
29
30 @tpsvcchanneldispatchoperation: the object which received the signal.
31 @arg1:
32 @arg2:
33 @arg3:
34
35 <!-- ##### SIGNAL TpSvcChannelDispatchOperation::finished ##### -->
36 <para>
37
38 </para>
39
40 @tpsvcchanneldispatchoperation: the object which received the signal.
41
42 <!-- ##### STRUCT TpSvcChannelDispatchOperationClass ##### -->
43 <para>
44
45 </para>
46
47
48 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_return_from_claim ##### -->
49 <para>
50
51 </para>
52
53 @context:
54
55
56 <!-- ##### USER_FUNCTION tp_svc_channel_dispatch_operation_claim_impl ##### -->
57 <para>
58
59 </para>
60
61 @self:
62 @context:
63
64
65 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_implement_claim ##### -->
66 <para>
67
68 </para>
69
70 @klass:
71 @impl:
72
73
74 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_return_from_handle_with ##### -->
75 <para>
76
77 </para>
78
79 @context:
80
81
82 <!-- ##### USER_FUNCTION tp_svc_channel_dispatch_operation_handle_with_impl ##### -->
83 <para>
84
85 </para>
86
87 @self:
88 @in_Handler:
89 @context:
90
91
92 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_implement_handle_with ##### -->
93 <para>
94
95 </para>
96
97 @klass:
98 @impl:
99
100
101 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_emit_channel_lost ##### -->
102 <para>
103
104 </para>
105
106 @instance:
107 @arg_Channel:
108 @arg_Error:
109 @arg_Message:
110
111
112 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_emit_finished ##### -->
113 <para>
114
115 </para>
116
117 @instance:
118
119
0 <!-- ##### SECTION Title ##### -->
1 svc-channel-dispatcher
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcChannelDispatcher ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpSvcChannelDispatcherClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### FUNCTION tp_svc_channel_dispatcher_return_from_create_channel ##### -->
32 <para>
33
34 </para>
35
36 @context:
37 @out_Request:
38
39
40 <!-- ##### USER_FUNCTION tp_svc_channel_dispatcher_create_channel_impl ##### -->
41 <para>
42
43 </para>
44
45 @self:
46 @in_Account:
47 @in_Requested_Properties:
48 @in_User_Action_Time:
49 @in_Preferred_Handler:
50 @context:
51
52
53 <!-- ##### FUNCTION tp_svc_channel_dispatcher_implement_create_channel ##### -->
54 <para>
55
56 </para>
57
58 @klass:
59 @impl:
60
61
62 <!-- ##### FUNCTION tp_svc_channel_dispatcher_return_from_ensure_channel ##### -->
63 <para>
64
65 </para>
66
67 @context:
68 @out_Request:
69
70
71 <!-- ##### USER_FUNCTION tp_svc_channel_dispatcher_ensure_channel_impl ##### -->
72 <para>
73
74 </para>
75
76 @self:
77 @in_Account:
78 @in_Requested_Properties:
79 @in_User_Action_Time:
80 @in_Preferred_Handler:
81 @context:
82
83
84 <!-- ##### FUNCTION tp_svc_channel_dispatcher_implement_ensure_channel ##### -->
85 <para>
86
87 </para>
88
89 @klass:
90 @impl:
91
92
93 <!-- ##### STRUCT TpSvcChannelDispatcherInterfaceOperationList ##### -->
94 <para>
95
96 </para>
97
98
99 <!-- ##### SIGNAL TpSvcChannelDispatcherInterfaceOperationList::dispatch-operation-finished ##### -->
100 <para>
101
102 </para>
103
104 @tpsvcchanneldispatcherinterfaceoperationlist: the object which received the signal.
105 @arg1:
106
107 <!-- ##### SIGNAL TpSvcChannelDispatcherInterfaceOperationList::new-dispatch-operation ##### -->
108 <para>
109
110 </para>
111
112 @tpsvcchanneldispatcherinterfaceoperationlist: the object which received the signal.
113 @arg1:
114
115 <!-- ##### STRUCT TpSvcChannelDispatcherInterfaceOperationListClass ##### -->
116 <para>
117
118 </para>
119
120
121 <!-- ##### FUNCTION tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ##### -->
122 <para>
123
124 </para>
125
126 @instance:
127 @arg_Dispatch_Operation:
128 @arg_Properties:
129
130
131 <!-- ##### FUNCTION tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ##### -->
132 <para>
133
134 </para>
135
136 @instance:
137 @arg_Dispatch_Operation:
138
139
0 <!-- ##### SECTION Title ##### -->
1 svc-channel-request
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcChannelRequest ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### SIGNAL TpSvcChannelRequest::failed ##### -->
26 <para>
27
28 </para>
29
30 @tpsvcchannelrequest: the object which received the signal.
31 @arg1:
32 @arg2:
33
34 <!-- ##### SIGNAL TpSvcChannelRequest::succeeded ##### -->
35 <para>
36
37 </para>
38
39 @tpsvcchannelrequest: the object which received the signal.
40
41 <!-- ##### STRUCT TpSvcChannelRequestClass ##### -->
42 <para>
43
44 </para>
45
46
47 <!-- ##### FUNCTION tp_svc_channel_request_return_from_proceed ##### -->
48 <para>
49
50 </para>
51
52 @context:
53
54
55 <!-- ##### USER_FUNCTION tp_svc_channel_request_proceed_impl ##### -->
56 <para>
57
58 </para>
59
60 @self:
61 @context:
62
63
64 <!-- ##### FUNCTION tp_svc_channel_request_implement_proceed ##### -->
65 <para>
66
67 </para>
68
69 @klass:
70 @impl:
71
72
73 <!-- ##### FUNCTION tp_svc_channel_request_return_from_cancel ##### -->
74 <para>
75
76 </para>
77
78 @context:
79
80
81 <!-- ##### USER_FUNCTION tp_svc_channel_request_cancel_impl ##### -->
82 <para>
83
84 </para>
85
86 @self:
87 @context:
88
89
90 <!-- ##### FUNCTION tp_svc_channel_request_implement_cancel ##### -->
91 <para>
92
93 </para>
94
95 @klass:
96 @impl:
97
98
99 <!-- ##### FUNCTION tp_svc_channel_request_emit_failed ##### -->
100 <para>
101
102 </para>
103
104 @instance:
105 @arg_Error:
106 @arg_Message:
107
108
109 <!-- ##### FUNCTION tp_svc_channel_request_emit_succeeded ##### -->
110 <para>
111
112 </para>
113
114 @instance:
115
116
0 <!-- ##### SECTION Title ##### -->
1 svc-client
2
3 <!-- ##### SECTION Short_Description ##### -->
4
5
6 <!-- ##### SECTION Long_Description ##### -->
7 <para>
8
9 </para>
10
11 <!-- ##### SECTION See_Also ##### -->
12 <para>
13
14 </para>
15
16 <!-- ##### SECTION Stability_Level ##### -->
17
18
19 <!-- ##### STRUCT TpSvcClient ##### -->
20 <para>
21
22 </para>
23
24
25 <!-- ##### STRUCT TpSvcClientClass ##### -->
26 <para>
27
28 </para>
29
30
31 <!-- ##### STRUCT TpSvcClientApprover ##### -->
32 <para>
33
34 </para>
35
36
37 <!-- ##### STRUCT TpSvcClientApproverClass ##### -->
38 <para>
39
40 </para>
41
42
43 <!-- ##### FUNCTION tp_svc_client_approver_return_from_add_dispatch_operation ##### -->
44 <para>
45
46 </para>
47
48 @context:
49
50
51 <!-- ##### USER_FUNCTION tp_svc_client_approver_add_dispatch_operation_impl ##### -->
52 <para>
53
54 </para>
55
56 @self:
57 @in_Channels:
58 @in_DispatchOperation:
59 @in_Properties:
60 @context:
61
62
63 <!-- ##### FUNCTION tp_svc_client_approver_implement_add_dispatch_operation ##### -->
64 <para>
65
66 </para>
67
68 @klass:
69 @impl:
70
71
72 <!-- ##### STRUCT TpSvcClientHandler ##### -->
73 <para>
74
75 </para>
76
77
78 <!-- ##### STRUCT TpSvcClientHandlerClass ##### -->
79 <para>
80
81 </para>
82
83
84 <!-- ##### FUNCTION tp_svc_client_handler_return_from_handle_channels ##### -->
85 <para>
86
87 </para>
88
89 @context:
90
91
92 <!-- ##### USER_FUNCTION tp_svc_client_handler_handle_channels_impl ##### -->
93 <para>
94
95 </para>
96
97 @self:
98 @in_Account:
99 @in_Connection:
100 @in_Channels:
101 @in_Requests_Satisfied:
102 @in_User_Action_Time:
103 @in_Handler_Info:
104 @context:
105
106
107 <!-- ##### FUNCTION tp_svc_client_handler_implement_handle_channels ##### -->
108 <para>
109
110 </para>
111
112 @klass:
113 @impl:
114
115
116 <!-- ##### STRUCT TpSvcClientInterfaceRequests ##### -->
117 <para>
118
119 </para>
120
121
122 <!-- ##### STRUCT TpSvcClientInterfaceRequestsClass ##### -->
123 <para>
124
125 </para>
126
127
128 <!-- ##### FUNCTION tp_svc_client_interface_requests_return_from_add_request ##### -->
129 <para>
130
131 </para>
132
133 @context:
134
135
136 <!-- ##### USER_FUNCTION tp_svc_client_interface_requests_add_request_impl ##### -->
137 <para>
138
139 </para>
140
141 @self:
142 @in_Request:
143 @in_Properties:
144 @context:
145
146
147 <!-- ##### FUNCTION tp_svc_client_interface_requests_implement_add_request ##### -->
148 <para>
149
150 </para>
151
152 @klass:
153 @impl:
154
155
156 <!-- ##### FUNCTION tp_svc_client_interface_requests_return_from_remove_request ##### -->
157 <para>
158
159 </para>
160
161 @context:
162
163
164 <!-- ##### USER_FUNCTION tp_svc_client_interface_requests_remove_request_impl ##### -->
165 <para>
166
167 </para>
168
169 @self:
170 @in_Request:
171 @in_Error:
172 @in_Message:
173 @context:
174
175
176 <!-- ##### FUNCTION tp_svc_client_interface_requests_implement_remove_request ##### -->
177 <para>
178
179 </para>
180
181 @klass:
182 @impl:
183
184
185 <!-- ##### STRUCT TpSvcClientObserver ##### -->
186 <para>
187
188 </para>
189
190
191 <!-- ##### STRUCT TpSvcClientObserverClass ##### -->
192 <para>
193
194 </para>
195
196
197 <!-- ##### FUNCTION tp_svc_client_observer_return_from_observe_channels ##### -->
198 <para>
199
200 </para>
201
202 @context:
203
204
205 <!-- ##### USER_FUNCTION tp_svc_client_observer_observe_channels_impl ##### -->
206 <para>
207
208 </para>
209
210 @self:
211 @in_Account:
212 @in_Connection:
213 @in_Channels:
214 @in_Dispatch_Operation:
215 @in_Requests_Satisfied:
216 @in_Observer_Info:
217 @context:
218
219
220 <!-- ##### FUNCTION tp_svc_client_observer_implement_observe_channels ##### -->
221 <para>
222
223 </para>
224
225 @klass:
226 @impl:
227
228
0 <!-- ##### ARG TpConnection:alias-flags ##### -->
1 <para>
2
3 </para>
4
5
6 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_run_claim ##### -->
7 <para>
8
9 </para>
10
11 @proxy:
12 @timeout_ms:
13 @error:
14 @loop:
15 @Returns:
16
17 <!-- ##### FUNCTION tp_cli_channel_dispatch_operation_run_handle_with ##### -->
18 <para>
19
20 </para>
21
22 @proxy:
23 @timeout_ms:
24 @in_Handler:
25 @error:
26 @loop:
27 @Returns:
28
29 <!-- ##### FUNCTION tp_cli_channel_request_run_cancel ##### -->
30 <para>
31
32 </para>
33
34 @proxy:
35 @timeout_ms:
36 @error:
37 @loop:
38 @Returns:
39
40 <!-- ##### FUNCTION tp_cli_channel_request_run_proceed ##### -->
41 <para>
42
43 </para>
44
45 @proxy:
46 @timeout_ms:
47 @error:
48 @loop:
49 @Returns:
50
51 <!-- ##### FUNCTION tp_client_get_type ##### -->
52 <para>
53
54 </para>
55
56 @Returns:
57
58 <!-- ##### FUNCTION tp_connection_get_alias_flags ##### -->
59 <para>
60
61 </para>
62
63 @self:
64 @Returns:
65
066 <!-- ##### FUNCTION tp_contact_get_type ##### -->
167 <para>
268
35101
36102 @obj_cls:
37103
104 <!-- ##### FUNCTION tp_svc_channel_dispatch_operation_get_type ##### -->
105 <para>
106
107 </para>
108
109 @Returns:
110
111 <!-- ##### FUNCTION tp_svc_channel_request_get_type ##### -->
112 <para>
113
114 </para>
115
116 @Returns:
117
38118 <!-- ##### FUNCTION tp_svc_channel_type_file_transfer_get_type ##### -->
39119 <para>
40120
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-account-manager">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-account-manager.top_of_page">TpAccountManager</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpAccountManager</refname>
12 <refpurpose>proxy object for the Telepathy account manager</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-account-manager.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpAccountManager"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/account-manager.h&gt;
21
22 <link linkend="TpAccountManager-struct">TpAccountManager</link>;
23 <link linkend="TpAccountManagerClass">TpAccountManagerClass</link>;
24 <link linkend="TpAccountManager">TpAccountManager</link> * <link linkend="tp-account-manager-new">tp_account_manager_new</link> (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon);
25 <link linkend="void">void</link> <link linkend="tp-account-manager-init-known-interfaces">tp_account_manager_init_known_interfaces</link>
26 (void);
27
28 <link linkend="void">void</link> (<link linkend="tp-cli-account-manager-callback-for-create-account">*tp_cli_account_manager_callback_for_create_account</link>)
29 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
30 const <link linkend="gchar">gchar</link> *out_Account,
31 const <link linkend="GError">GError</link> *error,
32 <link linkend="gpointer">gpointer</link> user_data,
33 <link linkend="GObject">GObject</link> *weak_object);
34 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-account-manager-call-create-account">tp_cli_account_manager_call_create_account</link>
35 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
36 <link linkend="gint">gint</link> timeout_ms,
37 const <link linkend="gchar">gchar</link> *in_Connection_Manager,
38 const <link linkend="gchar">gchar</link> *in_Protocol,
39 const <link linkend="gchar">gchar</link> *in_Display_Name,
40 <link linkend="GHashTable">GHashTable</link> *in_Parameters,
41 <link linkend="GHashTable">GHashTable</link> *in_Properties,
42 <link linkend="tp-cli-account-manager-callback-for-create-account">tp_cli_account_manager_callback_for_create_account</link> callback,
43 <link linkend="gpointer">gpointer</link> user_data,
44 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
45 <link linkend="GObject">GObject</link> *weak_object);
46 <link linkend="void">void</link> (<link linkend="tp-cli-account-manager-signal-callback-account-removed">*tp_cli_account_manager_signal_callback_account_removed</link>)
47 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
48 const <link linkend="gchar">gchar</link> *arg_Account,
49 <link linkend="gpointer">gpointer</link> user_data,
50 <link linkend="GObject">GObject</link> *weak_object);
51 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-account-manager-connect-to-account-removed">tp_cli_account_manager_connect_to_account_removed</link>
52 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
53 <link linkend="tp-cli-account-manager-signal-callback-account-removed">tp_cli_account_manager_signal_callback_account_removed</link> callback,
54 <link linkend="gpointer">gpointer</link> user_data,
55 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
56 <link linkend="GObject">GObject</link> *weak_object,
57 <link linkend="GError">GError</link> **error);
58 <link linkend="void">void</link> (<link linkend="tp-cli-account-manager-signal-callback-account-validity-changed">*tp_cli_account_manager_signal_callback_account_validity_changed</link>)
59 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
60 const <link linkend="gchar">gchar</link> *arg_Account,
61 <link linkend="gboolean">gboolean</link> arg_Valid,
62 <link linkend="gpointer">gpointer</link> user_data,
63 <link linkend="GObject">GObject</link> *weak_object);
64 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-account-manager-connect-to-account-validity-changed">tp_cli_account_manager_connect_to_account_validity_changed</link>
65 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
66 <link linkend="tp-cli-account-manager-signal-callback-account-validity-changed">tp_cli_account_manager_signal_callback_account_validity_changed</link> callback,
67 <link linkend="gpointer">gpointer</link> user_data,
68 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
69 <link linkend="GObject">GObject</link> *weak_object,
70 <link linkend="GError">GError</link> **error);
71 </synopsis>
72 </refsynopsisdiv>
73
74 <refsect1 id="telepathy-glib-account-manager.object-hierarchy" role="object_hierarchy">
75 <title role="object_hierarchy.title">Object Hierarchy</title>
76 <synopsis>
77 <link linkend="GObject">GObject</link>
78 +----<link linkend="TpProxy">TpProxy</link>
79 +----TpAccountManager
80 </synopsis>
81 </refsect1>
82
83
84
85
86
87
88
89
90 <refsect1 id="telepathy-glib-account-manager.description" role="desc">
91 <title role="desc.title">Description</title>
92 <para>
93 The <link linkend="TpAccountManager"><type>TpAccountManager</type></link> object is used to communicate with the Telepathy
94 AccountManager service.</para>
95 <para>
96 </para>
97 </refsect1>
98
99 <refsect1 id="telepathy-glib-account-manager.details" role="details">
100 <title role="details.title">Details</title>
101 <refsect2 id="TpAccountManager-struct" role="struct">
102 <title>TpAccountManager</title>
103 <indexterm zone="TpAccountManager-struct" role="0.7.UNRELEASED"><primary sortas="TpAccountManager">TpAccountManager</primary></indexterm><programlisting>typedef struct _TpAccountManager TpAccountManager;</programlisting>
104 <para>
105 The Telepathy Account Manager stores real-time communication accounts and
106 their configuration, places accounts online on request, and manipulates
107 accounts' presence, nicknames and avatars.
108 </para>
109 <para>
110 This proxy is usable but incomplete: GObject signals and accessors for the
111 D-Bus properties will be added in a later version of telepathy-glib, along
112 with a mechanism similar to <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.
113 </para>
114 <para>
115 Until suitable convenience methods are implemented, the generic
116 <link linkend="tp-cli-dbus-properties-call-get-all"><function>tp_cli_dbus_properties_call_get_all()</function></link> method can be used to get the D-Bus
117 properties.</para>
118 <para>
119 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
120 <refsect2 id="TpAccountManagerClass" role="struct">
121 <title>TpAccountManagerClass</title>
122 <indexterm zone="TpAccountManagerClass"><primary sortas="TpAccountManagerClass">TpAccountManagerClass</primary></indexterm><programlisting>typedef struct {
123 } TpAccountManagerClass;
124 </programlisting>
125 <para>
126 The class of a <link linkend="TpAccount"><type>TpAccount</type></link>.</para>
127 <para>
128 </para></refsect2>
129 <refsect2 id="tp-account-manager-new" role="function">
130 <title>tp_account_manager_new ()</title>
131 <indexterm zone="tp-account-manager-new"><primary sortas="tp_account_manager_new">tp_account_manager_new</primary></indexterm><programlisting><link linkend="TpAccountManager">TpAccountManager</link> * tp_account_manager_new (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon);</programlisting>
132 <para>
133 Convenience function to create a new account manager proxy.</para>
134 <para>
135 </para><variablelist role="params">
136 <varlistentry><term><parameter>bus_daemon</parameter>&#160;:</term>
137 <listitem><simpara> Proxy for the D-Bus daemon
138 </simpara></listitem></varlistentry>
139 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new reference to an account manager proxy
140 </simpara></listitem></varlistentry>
141 </variablelist></refsect2>
142 <refsect2 id="tp-account-manager-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
143 <title>tp_account_manager_init_known_interfaces ()</title>
144 <indexterm zone="tp-account-manager-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_account_manager_init_known_interfaces">tp_account_manager_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_account_manager_init_known_interfaces
145 (void);</programlisting>
146 <para>
147 Ensure that the known interfaces for TpAccountManager have been set up.
148 This is done automatically when necessary, but for correct
149 overriding of library interfaces by local extensions, you should
150 call this function before calling
151 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
152 <link linkend="TP-TYPE-ACCOUNT-MANAGER--CAPS"><literal>TP_TYPE_ACCOUNT_MANAGER</literal></link>.</para>
153 <para>
154 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
155 <refsect2 id="tp-cli-account-manager-callback-for-create-account" role="function">
156 <title>tp_cli_account_manager_callback_for_create_account ()</title>
157 <indexterm zone="tp-cli-account-manager-callback-for-create-account"><primary sortas="tp_cli_account_manager_callback_for_create_account">tp_cli_account_manager_callback_for_create_account</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_manager_callback_for_create_account)
158 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
159 const <link linkend="gchar">gchar</link> *out_Account,
160 const <link linkend="GError">GError</link> *error,
161 <link linkend="gpointer">gpointer</link> user_data,
162 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
163 <para>
164 Signature of the callback called when a CreateAccount method call
165 succeeds or fails.</para>
166 <para>
167 </para><variablelist role="params">
168 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
169 <listitem><simpara> the proxy on which the call was made
170 </simpara></listitem></varlistentry>
171 <varlistentry><term><parameter>out_Account</parameter>&#160;:</term>
172 <listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: The new &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt;.
173 </simpara></listitem></varlistentry>
174 <varlistentry><term><parameter>error</parameter>&#160;:</term>
175 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
176 </simpara></listitem></varlistentry>
177 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
178 <listitem><simpara> user-supplied data
179 </simpara></listitem></varlistentry>
180 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
181 <listitem><simpara> user-supplied object
182 </simpara></listitem></varlistentry>
183 </variablelist></refsect2>
184 <refsect2 id="tp-cli-account-manager-call-create-account" role="function">
185 <title>tp_cli_account_manager_call_create_account ()</title>
186 <indexterm zone="tp-cli-account-manager-call-create-account"><primary sortas="tp_cli_account_manager_call_create_account">tp_cli_account_manager_call_create_account</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_account_manager_call_create_account
187 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
188 <link linkend="gint">gint</link> timeout_ms,
189 const <link linkend="gchar">gchar</link> *in_Connection_Manager,
190 const <link linkend="gchar">gchar</link> *in_Protocol,
191 const <link linkend="gchar">gchar</link> *in_Display_Name,
192 <link linkend="GHashTable">GHashTable</link> *in_Parameters,
193 <link linkend="GHashTable">GHashTable</link> *in_Properties,
194 <link linkend="tp-cli-account-manager-callback-for-create-account">tp_cli_account_manager_callback_for_create_account</link> callback,
195 <link linkend="gpointer">gpointer</link> user_data,
196 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
197 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
198 <para>
199 Start a CreateAccount method call.
200 </para>
201 <para>
202 Request the creation of a new &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt;. The account manager SHOULD NOT allow invalid accounts to be created.</para>
203 <para>
204 </para><variablelist role="params">
205 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
206 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
207 </simpara></listitem></varlistentry>
208 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
209 <listitem><simpara> the timeout in milliseconds, or -1 to use the
210 default
211 </simpara></listitem></varlistentry>
212 <varlistentry><term><parameter>in_Connection_Manager</parameter>&#160;:</term>
213 <listitem><simpara> Used to pass an 'in' argument: The name of the connection manager, e.g. &amp;quot;salut&amp;quot;.
214 </simpara></listitem></varlistentry>
215 <varlistentry><term><parameter>in_Protocol</parameter>&#160;:</term>
216 <listitem><simpara> Used to pass an 'in' argument: The protocol, e.g. &amp;quot;local-xmpp&amp;quot;.
217 </simpara></listitem></varlistentry>
218 <varlistentry><term><parameter>in_Display_Name</parameter>&#160;:</term>
219 <listitem><simpara> Used to pass an 'in' argument: The initial value of the new account&apos;s &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Account&quot;&gt;DisplayName&lt;/tp:dbus-ref&gt; property. The account manager SHOULD modify this to make it unique if an Account already exists with the same display name, for instance by appending a number or the &apos;account&apos; parameter. Account manager implementations SHOULD accept an empty string, but account editing user interfaces should avoid passing an empty string for this parameter. &lt;tp:rationale&gt; &lt;p&gt;The account creation UI may ask the user for a name for the new account. If the author of the UI chooses not to do this, the account creation UI is better able to suggest a default display name because it has protocol-specific knowledge which the account manager does not.&lt;/p&gt; &lt;p&gt;The account manager always knows the complete list of accounts so it can easily tell whether it should append something to the display name to avoid presenting two identically-named accounts to the user.&lt;/p&gt; &lt;/tp:rationale&gt;
220 </simpara></listitem></varlistentry>
221 <varlistentry><term><parameter>in_Parameters</parameter>&#160;:</term>
222 <listitem><simpara> Used to pass an 'in' argument: Initial parameter values, as would be passed to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ConnectionManager&quot;&gt;RequestConnection&lt;/tp:dbus-ref&gt;.
223 </simpara></listitem></varlistentry>
224 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
225 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The values of any other properties to be set immediately on the new Account.&lt;/p&gt; &lt;p&gt;Only the properties mentioned in &lt;tp:member-ref&gt;SupportedAccountProperties&lt;/tp:member-ref&gt; are acceptable here. In particular, the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Account&quot;&gt;DisplayName&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Account&quot;&gt;Parameters&lt;/tp:dbus-ref&gt; properties are never allowed here, since they are set using the other arguments to this method.&lt;/p&gt; &lt;p&gt;Account manager implementations SHOULD support creating accounts with an empty value for this argument.&lt;/p&gt;
226 </simpara></listitem></varlistentry>
227 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
228 <listitem><simpara> called when the method call succeeds or fails;
229 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
230 reply tracking
231 </simpara></listitem></varlistentry>
232 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
233 <listitem><simpara> user-supplied data passed to the callback;
234 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
235 </simpara></listitem></varlistentry>
236 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
237 <listitem><simpara> called with the user_data as argument, after the
238 call has succeeded, failed or been cancelled;
239 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
240 </simpara></listitem></varlistentry>
241 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
242 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
243 weakly referenced; if it is destroyed, this call
244 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
245 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
246 </simpara></listitem></varlistentry>
247 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
248 progress. It is borrowed from the object, and will become
249 invalid when the callback is called, the call is
250 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
251 </simpara></listitem></varlistentry>
252 </variablelist></refsect2>
253 <refsect2 id="tp-cli-account-manager-signal-callback-account-removed" role="function">
254 <title>tp_cli_account_manager_signal_callback_account_removed ()</title>
255 <indexterm zone="tp-cli-account-manager-signal-callback-account-removed"><primary sortas="tp_cli_account_manager_signal_callback_account_removed">tp_cli_account_manager_signal_callback_account_removed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_manager_signal_callback_account_removed)
256 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
257 const <link linkend="gchar">gchar</link> *arg_Account,
258 <link linkend="gpointer">gpointer</link> user_data,
259 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
260 <para>
261 Represents the signature of a callback for the signal AccountRemoved.</para>
262 <para>
263 </para><variablelist role="params">
264 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
265 <listitem><simpara> The proxy on which <link linkend="tp-cli-account-manager-connect-to-account-removed"><function>tp_cli_account_manager_connect_to_account_removed()</function></link>
266 was called
267 </simpara></listitem></varlistentry>
268 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
269 <listitem><simpara> An Account, which must not be used any more.
270 </simpara></listitem></varlistentry>
271 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
272 <listitem><simpara> User-supplied data
273 </simpara></listitem></varlistentry>
274 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
275 <listitem><simpara> User-supplied weakly referenced object
276 </simpara></listitem></varlistentry>
277 </variablelist></refsect2>
278 <refsect2 id="tp-cli-account-manager-connect-to-account-removed" role="function">
279 <title>tp_cli_account_manager_connect_to_account_removed ()</title>
280 <indexterm zone="tp-cli-account-manager-connect-to-account-removed"><primary sortas="tp_cli_account_manager_connect_to_account_removed">tp_cli_account_manager_connect_to_account_removed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_account_manager_connect_to_account_removed
281 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
282 <link linkend="tp-cli-account-manager-signal-callback-account-removed">tp_cli_account_manager_signal_callback_account_removed</link> callback,
283 <link linkend="gpointer">gpointer</link> user_data,
284 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
285 <link linkend="GObject">GObject</link> *weak_object,
286 <link linkend="GError">GError</link> **error);</programlisting>
287 <para>
288 Connect a handler to the signal AccountRemoved.
289 </para>
290 <para>
291 The given account has been removed. &lt;tp:rationale&gt; This is effectively change notification for the valid and invalid accounts lists. On emission of this signal, the Account indicated will no longer be present in either of the lists. &lt;/tp:rationale&gt;</para>
292 <para>
293 </para><variablelist role="params">
294 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
295 <listitem><simpara> A <link linkend="TpAccountManager"><type>TpAccountManager</type></link> or subclass
296 </simpara></listitem></varlistentry>
297 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
298 <listitem><simpara> Callback to be called when the signal is
299 received
300 </simpara></listitem></varlistentry>
301 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
302 <listitem><simpara> User-supplied data for the callback
303 </simpara></listitem></varlistentry>
304 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
305 <listitem><simpara> Destructor for the user-supplied data, which
306 will be called when this signal is disconnected, or
307 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
308 </simpara></listitem></varlistentry>
309 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
310 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
311 if it is destroyed, this callback will automatically be
312 disconnected
313 </simpara></listitem></varlistentry>
314 <varlistentry><term><parameter>error</parameter>&#160;:</term>
315 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
316 returned
317 </simpara></listitem></varlistentry>
318 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
319 above, which can be used to disconnect the signal; or
320 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
321 or has become invalid.
322 </simpara></listitem></varlistentry>
323 </variablelist></refsect2>
324 <refsect2 id="tp-cli-account-manager-signal-callback-account-validity-changed" role="function">
325 <title>tp_cli_account_manager_signal_callback_account_validity_changed ()</title>
326 <indexterm zone="tp-cli-account-manager-signal-callback-account-validity-changed"><primary sortas="tp_cli_account_manager_signal_callback_account_validity_changed">tp_cli_account_manager_signal_callback_account_validity_changed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_manager_signal_callback_account_validity_changed)
327 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
328 const <link linkend="gchar">gchar</link> *arg_Account,
329 <link linkend="gboolean">gboolean</link> arg_Valid,
330 <link linkend="gpointer">gpointer</link> user_data,
331 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
332 <para>
333 Represents the signature of a callback for the signal AccountValidityChanged.</para>
334 <para>
335 </para><variablelist role="params">
336 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
337 <listitem><simpara> The proxy on which <link linkend="tp-cli-account-manager-connect-to-account-validity-changed"><function>tp_cli_account_manager_connect_to_account_validity_changed()</function></link>
338 was called
339 </simpara></listitem></varlistentry>
340 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
341 <listitem><simpara> An Account.
342 </simpara></listitem></varlistentry>
343 <varlistentry><term><parameter>arg_Valid</parameter>&#160;:</term>
344 <listitem><simpara> True if the account is now valid.
345 </simpara></listitem></varlistentry>
346 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
347 <listitem><simpara> User-supplied data
348 </simpara></listitem></varlistentry>
349 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
350 <listitem><simpara> User-supplied weakly referenced object
351 </simpara></listitem></varlistentry>
352 </variablelist></refsect2>
353 <refsect2 id="tp-cli-account-manager-connect-to-account-validity-changed" role="function">
354 <title>tp_cli_account_manager_connect_to_account_validity_changed ()</title>
355 <indexterm zone="tp-cli-account-manager-connect-to-account-validity-changed"><primary sortas="tp_cli_account_manager_connect_to_account_validity_changed">tp_cli_account_manager_connect_to_account_validity_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_account_manager_connect_to_account_validity_changed
356 (<link linkend="TpAccountManager">TpAccountManager</link> *proxy,
357 <link linkend="tp-cli-account-manager-signal-callback-account-validity-changed">tp_cli_account_manager_signal_callback_account_validity_changed</link> callback,
358 <link linkend="gpointer">gpointer</link> user_data,
359 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
360 <link linkend="GObject">GObject</link> *weak_object,
361 <link linkend="GError">GError</link> **error);</programlisting>
362 <para>
363 Connect a handler to the signal AccountValidityChanged.
364 </para>
365 <para>
366 The validity of the given account has changed. New accounts are also indicated by this signal, as an account validity change (usually to True) on an account that did not previously exist. &lt;tp:rationale&gt; This is effectively change notification for the valid and invalid accounts lists. &lt;/tp:rationale&gt;</para>
367 <para>
368 </para><variablelist role="params">
369 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
370 <listitem><simpara> A <link linkend="TpAccountManager"><type>TpAccountManager</type></link> or subclass
371 </simpara></listitem></varlistentry>
372 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
373 <listitem><simpara> Callback to be called when the signal is
374 received
375 </simpara></listitem></varlistentry>
376 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
377 <listitem><simpara> User-supplied data for the callback
378 </simpara></listitem></varlistentry>
379 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
380 <listitem><simpara> Destructor for the user-supplied data, which
381 will be called when this signal is disconnected, or
382 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
383 </simpara></listitem></varlistentry>
384 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
385 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
386 if it is destroyed, this callback will automatically be
387 disconnected
388 </simpara></listitem></varlistentry>
389 <varlistentry><term><parameter>error</parameter>&#160;:</term>
390 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
391 returned
392 </simpara></listitem></varlistentry>
393 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
394 above, which can be used to disconnect the signal; or
395 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
396 or has become invalid.
397 </simpara></listitem></varlistentry>
398 </variablelist></refsect2>
399
400 </refsect1>
401
402
403
404 <refsect1 id="telepathy-glib-account-manager.see-also">
405 <title>See Also</title>
406 #TpAccount
407 </refsect1>
408
409 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-account">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-account.top_of_page">TpAccount</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpAccount</refname>
12 <refpurpose>proxy object for an account in the Telepathy account
13 manager</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv id="telepathy-glib-account.synopsis" role="synopsis">
17 <title role="synopsis.title">Synopsis</title>
18 <anchor id="TpAccount"/>
19 <synopsis>
20
21 #include &lt;telepathy-glib/account.h&gt;
22
23 <link linkend="TpAccount-struct">TpAccount</link>;
24 <link linkend="TpAccountClass">TpAccountClass</link>;
25 <link linkend="TpAccount">TpAccount</link> * <link linkend="tp-account-new">tp_account_new</link> (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
26 const <link linkend="gchar">gchar</link> *object_path,
27 <link linkend="GError">GError</link> **error);
28 <link linkend="void">void</link> <link linkend="tp-account-init-known-interfaces">tp_account_init_known_interfaces</link> (void);
29
30 <link linkend="void">void</link> (<link linkend="tp-cli-account-callback-for-reconnect">*tp_cli_account_callback_for_reconnect</link>)
31 (<link linkend="TpAccount">TpAccount</link> *proxy,
32 const <link linkend="GError">GError</link> *error,
33 <link linkend="gpointer">gpointer</link> user_data,
34 <link linkend="GObject">GObject</link> *weak_object);
35 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-account-call-reconnect">tp_cli_account_call_reconnect</link> (<link linkend="TpAccount">TpAccount</link> *proxy,
36 <link linkend="gint">gint</link> timeout_ms,
37 <link linkend="tp-cli-account-callback-for-reconnect">tp_cli_account_callback_for_reconnect</link> callback,
38 <link linkend="gpointer">gpointer</link> user_data,
39 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
40 <link linkend="GObject">GObject</link> *weak_object);
41 <link linkend="void">void</link> (<link linkend="tp-cli-account-callback-for-remove">*tp_cli_account_callback_for_remove</link>)
42 (<link linkend="TpAccount">TpAccount</link> *proxy,
43 const <link linkend="GError">GError</link> *error,
44 <link linkend="gpointer">gpointer</link> user_data,
45 <link linkend="GObject">GObject</link> *weak_object);
46 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-account-call-remove">tp_cli_account_call_remove</link> (<link linkend="TpAccount">TpAccount</link> *proxy,
47 <link linkend="gint">gint</link> timeout_ms,
48 <link linkend="tp-cli-account-callback-for-remove">tp_cli_account_callback_for_remove</link> callback,
49 <link linkend="gpointer">gpointer</link> user_data,
50 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
51 <link linkend="GObject">GObject</link> *weak_object);
52 <link linkend="void">void</link> (<link linkend="tp-cli-account-callback-for-update-parameters">*tp_cli_account_callback_for_update_parameters</link>)
53 (<link linkend="TpAccount">TpAccount</link> *proxy,
54 const <link linkend="gchar">gchar</link> **out_Reconnect_Required,
55 const <link linkend="GError">GError</link> *error,
56 <link linkend="gpointer">gpointer</link> user_data,
57 <link linkend="GObject">GObject</link> *weak_object);
58 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-account-call-update-parameters">tp_cli_account_call_update_parameters</link>
59 (<link linkend="TpAccount">TpAccount</link> *proxy,
60 <link linkend="gint">gint</link> timeout_ms,
61 <link linkend="GHashTable">GHashTable</link> *in_Set,
62 const <link linkend="gchar">gchar</link> **in_Unset,
63 <link linkend="tp-cli-account-callback-for-update-parameters">tp_cli_account_callback_for_update_parameters</link> callback,
64 <link linkend="gpointer">gpointer</link> user_data,
65 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
66 <link linkend="GObject">GObject</link> *weak_object);
67 <link linkend="void">void</link> (<link linkend="tp-cli-account-signal-callback-account-property-changed">*tp_cli_account_signal_callback_account_property_changed</link>)
68 (<link linkend="TpAccount">TpAccount</link> *proxy,
69 <link linkend="GHashTable">GHashTable</link> *arg_Properties,
70 <link linkend="gpointer">gpointer</link> user_data,
71 <link linkend="GObject">GObject</link> *weak_object);
72 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-account-connect-to-account-property-changed">tp_cli_account_connect_to_account_property_changed</link>
73 (<link linkend="TpAccount">TpAccount</link> *proxy,
74 <link linkend="tp-cli-account-signal-callback-account-property-changed">tp_cli_account_signal_callback_account_property_changed</link> callback,
75 <link linkend="gpointer">gpointer</link> user_data,
76 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
77 <link linkend="GObject">GObject</link> *weak_object,
78 <link linkend="GError">GError</link> **error);
79 <link linkend="void">void</link> (<link linkend="tp-cli-account-signal-callback-removed">*tp_cli_account_signal_callback_removed</link>)
80 (<link linkend="TpAccount">TpAccount</link> *proxy,
81 <link linkend="gpointer">gpointer</link> user_data,
82 <link linkend="GObject">GObject</link> *weak_object);
83 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-account-connect-to-removed">tp_cli_account_connect_to_removed</link>
84 (<link linkend="TpAccount">TpAccount</link> *proxy,
85 <link linkend="tp-cli-account-signal-callback-removed">tp_cli_account_signal_callback_removed</link> callback,
86 <link linkend="gpointer">gpointer</link> user_data,
87 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
88 <link linkend="GObject">GObject</link> *weak_object,
89 <link linkend="GError">GError</link> **error);
90
91 <link linkend="void">void</link> (<link linkend="tp-cli-account-interface-avatar-signal-callback-avatar-changed">*tp_cli_account_interface_avatar_signal_callback_avatar_changed</link>)
92 (<link linkend="TpAccount">TpAccount</link> *proxy,
93 <link linkend="gpointer">gpointer</link> user_data,
94 <link linkend="GObject">GObject</link> *weak_object);
95 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-account-interface-avatar-connect-to-avatar-changed">tp_cli_account_interface_avatar_connect_to_avatar_changed</link>
96 (<link linkend="TpAccount">TpAccount</link> *proxy,
97 <link linkend="tp-cli-account-interface-avatar-signal-callback-avatar-changed">tp_cli_account_interface_avatar_signal_callback_avatar_changed</link> callback,
98 <link linkend="gpointer">gpointer</link> user_data,
99 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
100 <link linkend="GObject">GObject</link> *weak_object,
101 <link linkend="GError">GError</link> **error);
102 </synopsis>
103 </refsynopsisdiv>
104
105 <refsect1 id="telepathy-glib-account.object-hierarchy" role="object_hierarchy">
106 <title role="object_hierarchy.title">Object Hierarchy</title>
107 <synopsis>
108 <link linkend="GObject">GObject</link>
109 +----<link linkend="TpProxy">TpProxy</link>
110 +----TpAccount
111 </synopsis>
112 </refsect1>
113
114
115
116
117
118
119
120
121 <refsect1 id="telepathy-glib-account.description" role="desc">
122 <title role="desc.title">Description</title>
123 <para>
124 The Telepathy Account Manager stores the user's configured real-time
125 communication accounts. The <link linkend="TpAccount"><type>TpAccount</type></link> object represents a stored account.</para>
126 <para>
127 </para>
128 </refsect1>
129
130 <refsect1 id="telepathy-glib-account.details" role="details">
131 <title role="details.title">Details</title>
132 <refsect2 id="TpAccount-struct" role="struct">
133 <title>TpAccount</title>
134 <indexterm zone="TpAccount-struct" role="0.7.UNRELEASED"><primary sortas="TpAccount">TpAccount</primary></indexterm><programlisting>typedef struct _TpAccount TpAccount;</programlisting>
135 <para>
136 The Telepathy Account Manager stores the user's configured real-time
137 communication accounts. This object represents a stored account.
138 </para>
139 <para>
140 If this account is deleted from the account manager, the
141 <link linkend="TpProxy-invalidated"><type>"invalidated"</type></link> signal will be emitted
142 with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
143 <link linkend="TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><literal>TP_DBUS_ERROR_OBJECT_REMOVED</literal></link>.
144 </para>
145 <para>
146 This proxy is usable but very incomplete: accessors for the
147 Account's D-Bus properties will be added in a later version of
148 telepathy-glib, along with a mechanism similar to
149 <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.
150 </para>
151 <para>
152 Most operations performed on an Account are done via D-Bus properties.
153 Until convenience methods for this are implemented, use of the generic
154 <link linkend="tp-cli-dbus-properties-call-get-all"><function>tp_cli_dbus_properties_call_get_all()</function></link> and <link linkend="tp-cli-dbus-properties-call-set"><function>tp_cli_dbus_properties_call_set()</function></link>
155 methods is recommended.
156 </para>
157 <para>
158 Other useful auto-generated method wrappers on an Account include
159 <link linkend="tp-cli-account-call-remove"><function>tp_cli_account_call_remove()</function></link>, <link linkend="tp-cli-account-call-update-parameters"><function>tp_cli_account_call_update_parameters()</function></link> and
160 <link linkend="tp-cli-account-call-reconnect"><function>tp_cli_account_call_reconnect()</function></link>.</para>
161 <para>
162 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
163 <refsect2 id="TpAccountClass" role="struct">
164 <title>TpAccountClass</title>
165 <indexterm zone="TpAccountClass"><primary sortas="TpAccountClass">TpAccountClass</primary></indexterm><programlisting>typedef struct {
166 } TpAccountClass;
167 </programlisting>
168 <para>
169 The class of a <link linkend="TpAccount"><type>TpAccount</type></link>.</para>
170 <para>
171 </para></refsect2>
172 <refsect2 id="tp-account-new" role="function">
173 <title>tp_account_new ()</title>
174 <indexterm zone="tp-account-new"><primary sortas="tp_account_new">tp_account_new</primary></indexterm><programlisting><link linkend="TpAccount">TpAccount</link> * tp_account_new (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
175 const <link linkend="gchar">gchar</link> *object_path,
176 <link linkend="GError">GError</link> **error);</programlisting>
177 <para>
178 Convenience function to create a new account proxy.</para>
179 <para>
180 </para><variablelist role="params">
181 <varlistentry><term><parameter>bus_daemon</parameter>&#160;:</term>
182 <listitem><simpara> Proxy for the D-Bus daemon
183 </simpara></listitem></varlistentry>
184 <varlistentry><term><parameter>object_path</parameter>&#160;:</term>
185 <listitem><simpara> The non-NULL object path of this account
186 </simpara></listitem></varlistentry>
187 <varlistentry><term><parameter>error</parameter>&#160;:</term>
188 <listitem><simpara> Used to raise an error if <parameter>object_path</parameter> is not valid
189 </simpara></listitem></varlistentry>
190 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new reference to an account proxy, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>object_path</parameter> is
191 not valid
192 </simpara></listitem></varlistentry>
193 </variablelist></refsect2>
194 <refsect2 id="tp-account-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
195 <title>tp_account_init_known_interfaces ()</title>
196 <indexterm zone="tp-account-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_account_init_known_interfaces">tp_account_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_account_init_known_interfaces (void);</programlisting>
197 <para>
198 Ensure that the known interfaces for TpAccount have been set up.
199 This is done automatically when necessary, but for correct
200 overriding of library interfaces by local extensions, you should
201 call this function before calling
202 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
203 <link linkend="TP-TYPE-ACCOUNT--CAPS"><literal>TP_TYPE_ACCOUNT</literal></link>.</para>
204 <para>
205 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
206 <refsect2 id="tp-cli-account-callback-for-reconnect" role="function">
207 <title>tp_cli_account_callback_for_reconnect ()</title>
208 <indexterm zone="tp-cli-account-callback-for-reconnect"><primary sortas="tp_cli_account_callback_for_reconnect">tp_cli_account_callback_for_reconnect</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_callback_for_reconnect)
209 (<link linkend="TpAccount">TpAccount</link> *proxy,
210 const <link linkend="GError">GError</link> *error,
211 <link linkend="gpointer">gpointer</link> user_data,
212 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
213 <para>
214 Signature of the callback called when a Reconnect method call
215 succeeds or fails.</para>
216 <para>
217 </para><variablelist role="params">
218 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
219 <listitem><simpara> the proxy on which the call was made
220 </simpara></listitem></varlistentry>
221 <varlistentry><term><parameter>error</parameter>&#160;:</term>
222 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
223 </simpara></listitem></varlistentry>
224 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
225 <listitem><simpara> user-supplied data
226 </simpara></listitem></varlistentry>
227 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
228 <listitem><simpara> user-supplied object
229 </simpara></listitem></varlistentry>
230 </variablelist></refsect2>
231 <refsect2 id="tp-cli-account-call-reconnect" role="function">
232 <title>tp_cli_account_call_reconnect ()</title>
233 <indexterm zone="tp-cli-account-call-reconnect"><primary sortas="tp_cli_account_call_reconnect">tp_cli_account_call_reconnect</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_account_call_reconnect (<link linkend="TpAccount">TpAccount</link> *proxy,
234 <link linkend="gint">gint</link> timeout_ms,
235 <link linkend="tp-cli-account-callback-for-reconnect">tp_cli_account_callback_for_reconnect</link> callback,
236 <link linkend="gpointer">gpointer</link> user_data,
237 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
238 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
239 <para>
240 Start a Reconnect method call.
241 </para>
242 <para>
243 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Re-connect this account. If the account is currently disconnected and the requested presence is offline, or if the account is not &lt;tp:member-ref&gt;Enabled&lt;/tp:member-ref&gt; or not &lt;tp:member-ref&gt;Valid&lt;/tp:member-ref&gt;, this does nothing.&lt;/p&gt; &lt;p&gt;If the account is disconnected and the requested presence is not offline, this forces an attempt to connect with the requested presence immediately.&lt;/p&gt; &lt;p&gt;If the account is connecting or connected, this is equivalent to remembering the current value of &lt;tp:member-ref&gt;RequestedPresence&lt;/tp:member-ref&gt;, setting its value to (OFFLINE, &amp;quot;offline&amp;quot;, &amp;quot;&amp;quot;), waiting for the change to take effect, then setting its value to the value that was previously remembered.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Clients desiring &amp;quot;instant apply&amp;quot; semantics for CM parameters MAY call this method to achieve that.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;In particular, if the account&apos;s &lt;tp:member-ref&gt;Connection&lt;/tp:member-ref&gt; is in the Connecting state, calling this method causes the attempt to connect to be aborted and re-tried.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This is necessary to ensure that the new parameters are picked up.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
244 <para>
245 </para><variablelist role="params">
246 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
247 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
248 </simpara></listitem></varlistentry>
249 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
250 <listitem><simpara> the timeout in milliseconds, or -1 to use the
251 default
252 </simpara></listitem></varlistentry>
253 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
254 <listitem><simpara> called when the method call succeeds or fails;
255 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
256 reply tracking
257 </simpara></listitem></varlistentry>
258 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
259 <listitem><simpara> user-supplied data passed to the callback;
260 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
261 </simpara></listitem></varlistentry>
262 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
263 <listitem><simpara> called with the user_data as argument, after the
264 call has succeeded, failed or been cancelled;
265 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
266 </simpara></listitem></varlistentry>
267 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
268 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
269 weakly referenced; if it is destroyed, this call
270 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
271 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
272 </simpara></listitem></varlistentry>
273 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
274 progress. It is borrowed from the object, and will become
275 invalid when the callback is called, the call is
276 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
277 </simpara></listitem></varlistentry>
278 </variablelist></refsect2>
279 <refsect2 id="tp-cli-account-callback-for-remove" role="function">
280 <title>tp_cli_account_callback_for_remove ()</title>
281 <indexterm zone="tp-cli-account-callback-for-remove"><primary sortas="tp_cli_account_callback_for_remove">tp_cli_account_callback_for_remove</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_callback_for_remove)
282 (<link linkend="TpAccount">TpAccount</link> *proxy,
283 const <link linkend="GError">GError</link> *error,
284 <link linkend="gpointer">gpointer</link> user_data,
285 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
286 <para>
287 Signature of the callback called when a Remove method call
288 succeeds or fails.</para>
289 <para>
290 </para><variablelist role="params">
291 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
292 <listitem><simpara> the proxy on which the call was made
293 </simpara></listitem></varlistentry>
294 <varlistentry><term><parameter>error</parameter>&#160;:</term>
295 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
296 </simpara></listitem></varlistentry>
297 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
298 <listitem><simpara> user-supplied data
299 </simpara></listitem></varlistentry>
300 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
301 <listitem><simpara> user-supplied object
302 </simpara></listitem></varlistentry>
303 </variablelist></refsect2>
304 <refsect2 id="tp-cli-account-call-remove" role="function">
305 <title>tp_cli_account_call_remove ()</title>
306 <indexterm zone="tp-cli-account-call-remove"><primary sortas="tp_cli_account_call_remove">tp_cli_account_call_remove</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_account_call_remove (<link linkend="TpAccount">TpAccount</link> *proxy,
307 <link linkend="gint">gint</link> timeout_ms,
308 <link linkend="tp-cli-account-callback-for-remove">tp_cli_account_callback_for_remove</link> callback,
309 <link linkend="gpointer">gpointer</link> user_data,
310 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
311 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
312 <para>
313 Start a Remove method call.
314 </para>
315 <para>
316 Delete the account.</para>
317 <para>
318 </para><variablelist role="params">
319 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
320 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
321 </simpara></listitem></varlistentry>
322 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
323 <listitem><simpara> the timeout in milliseconds, or -1 to use the
324 default
325 </simpara></listitem></varlistentry>
326 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
327 <listitem><simpara> called when the method call succeeds or fails;
328 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
329 reply tracking
330 </simpara></listitem></varlistentry>
331 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
332 <listitem><simpara> user-supplied data passed to the callback;
333 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
334 </simpara></listitem></varlistentry>
335 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
336 <listitem><simpara> called with the user_data as argument, after the
337 call has succeeded, failed or been cancelled;
338 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
339 </simpara></listitem></varlistentry>
340 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
341 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
342 weakly referenced; if it is destroyed, this call
343 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
344 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
345 </simpara></listitem></varlistentry>
346 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
347 progress. It is borrowed from the object, and will become
348 invalid when the callback is called, the call is
349 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
350 </simpara></listitem></varlistentry>
351 </variablelist></refsect2>
352 <refsect2 id="tp-cli-account-callback-for-update-parameters" role="function">
353 <title>tp_cli_account_callback_for_update_parameters ()</title>
354 <indexterm zone="tp-cli-account-callback-for-update-parameters"><primary sortas="tp_cli_account_callback_for_update_parameters">tp_cli_account_callback_for_update_parameters</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_callback_for_update_parameters)
355 (<link linkend="TpAccount">TpAccount</link> *proxy,
356 const <link linkend="gchar">gchar</link> **out_Reconnect_Required,
357 const <link linkend="GError">GError</link> *error,
358 <link linkend="gpointer">gpointer</link> user_data,
359 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
360 <para>
361 Signature of the callback called when a UpdateParameters method call
362 succeeds or fails.</para>
363 <para>
364 </para><variablelist role="params">
365 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
366 <listitem><simpara> the proxy on which the call was made
367 </simpara></listitem></varlistentry>
368 <varlistentry><term><parameter>out_Reconnect_Required</parameter>&#160;:</term>
369 <listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: A list of the names of parameters with changes that will not take effect until the account is reconnected (this may be empty, e.g. if all the parameters are D-Bus properties or parameters for which the account manager has specific support). User interfaces that require &amp;quot;instant apply&amp;quot; semantics MAY call &lt;tp:member-ref&gt;Reconnect&lt;/tp:member-ref&gt; in response to receiving a non-empty list.
370 </simpara></listitem></varlistentry>
371 <varlistentry><term><parameter>error</parameter>&#160;:</term>
372 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
373 </simpara></listitem></varlistentry>
374 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
375 <listitem><simpara> user-supplied data
376 </simpara></listitem></varlistentry>
377 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
378 <listitem><simpara> user-supplied object
379 </simpara></listitem></varlistentry>
380 </variablelist></refsect2>
381 <refsect2 id="tp-cli-account-call-update-parameters" role="function">
382 <title>tp_cli_account_call_update_parameters ()</title>
383 <indexterm zone="tp-cli-account-call-update-parameters"><primary sortas="tp_cli_account_call_update_parameters">tp_cli_account_call_update_parameters</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_account_call_update_parameters
384 (<link linkend="TpAccount">TpAccount</link> *proxy,
385 <link linkend="gint">gint</link> timeout_ms,
386 <link linkend="GHashTable">GHashTable</link> *in_Set,
387 const <link linkend="gchar">gchar</link> **in_Unset,
388 <link linkend="tp-cli-account-callback-for-update-parameters">tp_cli_account_callback_for_update_parameters</link> callback,
389 <link linkend="gpointer">gpointer</link> user_data,
390 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
391 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
392 <para>
393 Start a UpdateParameters method call.
394 </para>
395 <para>
396 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Change the value of the &lt;tp:member-ref&gt;Parameters&lt;/tp:member-ref&gt; property.&lt;/p&gt; &lt;p&gt;If any of the changed parameters&apos; &lt;tp:type&gt;Conn_Mgr_Param_Flags&lt;/tp:type&gt; include &lt;code&gt;DBus_Property&lt;/code&gt;, the change will be applied to the corresponding D-Bus Property on the active &lt;tp:member-ref&gt;Connection&lt;/tp:member-ref&gt;, if there is one. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;In general, reconnecting is a destructive operation that shouldn&apos;t happen as a side-effect. In particular, migration tools that twiddle the settings of all accounts shouldn&apos;t cause an automatic disconnect and reconnect.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
397 <para>
398 </para><variablelist role="params">
399 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
400 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
401 </simpara></listitem></varlistentry>
402 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
403 <listitem><simpara> the timeout in milliseconds, or -1 to use the
404 default
405 </simpara></listitem></varlistentry>
406 <varlistentry><term><parameter>in_Set</parameter>&#160;:</term>
407 <listitem><simpara> Used to pass an 'in' argument: A mapping from parameter names to their values. These parameters should be stored for future use.
408 </simpara></listitem></varlistentry>
409 <varlistentry><term><parameter>in_Unset</parameter>&#160;:</term>
410 <listitem><simpara> Used to pass an 'in' argument: A list of the names of parameters to be removed from the set of stored values, allowing the default values to be used. If the given parameters were not, in fact, stored, or even if they do not exist at all, the account manager MUST accept this without error.
411 </simpara></listitem></varlistentry>
412 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
413 <listitem><simpara> called when the method call succeeds or fails;
414 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
415 reply tracking
416 </simpara></listitem></varlistentry>
417 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
418 <listitem><simpara> user-supplied data passed to the callback;
419 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
420 </simpara></listitem></varlistentry>
421 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
422 <listitem><simpara> called with the user_data as argument, after the
423 call has succeeded, failed or been cancelled;
424 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
425 </simpara></listitem></varlistentry>
426 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
427 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
428 weakly referenced; if it is destroyed, this call
429 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
430 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
431 </simpara></listitem></varlistentry>
432 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
433 progress. It is borrowed from the object, and will become
434 invalid when the callback is called, the call is
435 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
436 </simpara></listitem></varlistentry>
437 </variablelist></refsect2>
438 <refsect2 id="tp-cli-account-signal-callback-account-property-changed" role="function">
439 <title>tp_cli_account_signal_callback_account_property_changed ()</title>
440 <indexterm zone="tp-cli-account-signal-callback-account-property-changed"><primary sortas="tp_cli_account_signal_callback_account_property_changed">tp_cli_account_signal_callback_account_property_changed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_signal_callback_account_property_changed)
441 (<link linkend="TpAccount">TpAccount</link> *proxy,
442 <link linkend="GHashTable">GHashTable</link> *arg_Properties,
443 <link linkend="gpointer">gpointer</link> user_data,
444 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
445 <para>
446 Represents the signature of a callback for the signal AccountPropertyChanged.</para>
447 <para>
448 </para><variablelist role="params">
449 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
450 <listitem><simpara> The proxy on which <link linkend="tp-cli-account-connect-to-account-property-changed"><function>tp_cli_account_connect_to_account_property_changed()</function></link>
451 was called
452 </simpara></listitem></varlistentry>
453 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
454 <listitem><simpara> A map from property names in this namespace (e.g. &lt;tp:member-ref&gt;Nickname&lt;/tp:member-ref&gt;) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done.
455 </simpara></listitem></varlistentry>
456 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
457 <listitem><simpara> User-supplied data
458 </simpara></listitem></varlistentry>
459 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
460 <listitem><simpara> User-supplied weakly referenced object
461 </simpara></listitem></varlistentry>
462 </variablelist></refsect2>
463 <refsect2 id="tp-cli-account-connect-to-account-property-changed" role="function">
464 <title>tp_cli_account_connect_to_account_property_changed ()</title>
465 <indexterm zone="tp-cli-account-connect-to-account-property-changed"><primary sortas="tp_cli_account_connect_to_account_property_changed">tp_cli_account_connect_to_account_property_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_account_connect_to_account_property_changed
466 (<link linkend="TpAccount">TpAccount</link> *proxy,
467 <link linkend="tp-cli-account-signal-callback-account-property-changed">tp_cli_account_signal_callback_account_property_changed</link> callback,
468 <link linkend="gpointer">gpointer</link> user_data,
469 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
470 <link linkend="GObject">GObject</link> *weak_object,
471 <link linkend="GError">GError</link> **error);</programlisting>
472 <para>
473 Connect a handler to the signal AccountPropertyChanged.
474 </para>
475 <para>
476 The values of one or more properties on this interface (that do not specify that this signal does not apply to them) may have changed. This does not cover properties of other interfaces, which must provide their own change notification if appropriate.</para>
477 <para>
478 </para><variablelist role="params">
479 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
480 <listitem><simpara> A <link linkend="TpAccount"><type>TpAccount</type></link> or subclass
481 </simpara></listitem></varlistentry>
482 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
483 <listitem><simpara> Callback to be called when the signal is
484 received
485 </simpara></listitem></varlistentry>
486 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
487 <listitem><simpara> User-supplied data for the callback
488 </simpara></listitem></varlistentry>
489 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
490 <listitem><simpara> Destructor for the user-supplied data, which
491 will be called when this signal is disconnected, or
492 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
493 </simpara></listitem></varlistentry>
494 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
495 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
496 if it is destroyed, this callback will automatically be
497 disconnected
498 </simpara></listitem></varlistentry>
499 <varlistentry><term><parameter>error</parameter>&#160;:</term>
500 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
501 returned
502 </simpara></listitem></varlistentry>
503 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
504 above, which can be used to disconnect the signal; or
505 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
506 or has become invalid.
507 </simpara></listitem></varlistentry>
508 </variablelist></refsect2>
509 <refsect2 id="tp-cli-account-signal-callback-removed" role="function">
510 <title>tp_cli_account_signal_callback_removed ()</title>
511 <indexterm zone="tp-cli-account-signal-callback-removed"><primary sortas="tp_cli_account_signal_callback_removed">tp_cli_account_signal_callback_removed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_signal_callback_removed)
512 (<link linkend="TpAccount">TpAccount</link> *proxy,
513 <link linkend="gpointer">gpointer</link> user_data,
514 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
515 <para>
516 Represents the signature of a callback for the signal Removed.</para>
517 <para>
518 </para><variablelist role="params">
519 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
520 <listitem><simpara> The proxy on which <link linkend="tp-cli-account-connect-to-removed"><function>tp_cli_account_connect_to_removed()</function></link>
521 was called
522 </simpara></listitem></varlistentry>
523 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
524 <listitem><simpara> User-supplied data
525 </simpara></listitem></varlistentry>
526 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
527 <listitem><simpara> User-supplied weakly referenced object
528 </simpara></listitem></varlistentry>
529 </variablelist></refsect2>
530 <refsect2 id="tp-cli-account-connect-to-removed" role="function">
531 <title>tp_cli_account_connect_to_removed ()</title>
532 <indexterm zone="tp-cli-account-connect-to-removed"><primary sortas="tp_cli_account_connect_to_removed">tp_cli_account_connect_to_removed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_account_connect_to_removed
533 (<link linkend="TpAccount">TpAccount</link> *proxy,
534 <link linkend="tp-cli-account-signal-callback-removed">tp_cli_account_signal_callback_removed</link> callback,
535 <link linkend="gpointer">gpointer</link> user_data,
536 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
537 <link linkend="GObject">GObject</link> *weak_object,
538 <link linkend="GError">GError</link> **error);</programlisting>
539 <para>
540 Connect a handler to the signal Removed.
541 </para>
542 <para>
543 This account has been removed. &lt;tp:rationale&gt; This is redundant with &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.AccountManager&quot;&gt;AccountRemoved&lt;/tp:dbus-ref&gt;, but it&apos;s still worth having, to avoid having to bind to AccountManager.AccountRemoved to tell you whether your Account is valid — ideally, an account-editing UI should only care about a single Account. &lt;/tp:rationale&gt;</para>
544 <para>
545 </para><variablelist role="params">
546 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
547 <listitem><simpara> A <link linkend="TpAccount"><type>TpAccount</type></link> or subclass
548 </simpara></listitem></varlistentry>
549 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
550 <listitem><simpara> Callback to be called when the signal is
551 received
552 </simpara></listitem></varlistentry>
553 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
554 <listitem><simpara> User-supplied data for the callback
555 </simpara></listitem></varlistentry>
556 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
557 <listitem><simpara> Destructor for the user-supplied data, which
558 will be called when this signal is disconnected, or
559 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
560 </simpara></listitem></varlistentry>
561 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
562 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
563 if it is destroyed, this callback will automatically be
564 disconnected
565 </simpara></listitem></varlistentry>
566 <varlistentry><term><parameter>error</parameter>&#160;:</term>
567 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
568 returned
569 </simpara></listitem></varlistentry>
570 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
571 above, which can be used to disconnect the signal; or
572 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
573 or has become invalid.
574 </simpara></listitem></varlistentry>
575 </variablelist></refsect2>
576 <refsect2 id="tp-cli-account-interface-avatar-signal-callback-avatar-changed" role="function">
577 <title>tp_cli_account_interface_avatar_signal_callback_avatar_changed ()</title>
578 <indexterm zone="tp-cli-account-interface-avatar-signal-callback-avatar-changed"><primary sortas="tp_cli_account_interface_avatar_signal_callback_avatar_changed">tp_cli_account_interface_avatar_signal_callback_avatar_changed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_account_interface_avatar_signal_callback_avatar_changed)
579 (<link linkend="TpAccount">TpAccount</link> *proxy,
580 <link linkend="gpointer">gpointer</link> user_data,
581 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
582 <para>
583 Represents the signature of a callback for the signal AvatarChanged.</para>
584 <para>
585 </para><variablelist role="params">
586 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
587 <listitem><simpara> The proxy on which <link linkend="tp-cli-account-interface-avatar-connect-to-avatar-changed"><function>tp_cli_account_interface_avatar_connect_to_avatar_changed()</function></link>
588 was called
589 </simpara></listitem></varlistentry>
590 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
591 <listitem><simpara> User-supplied data
592 </simpara></listitem></varlistentry>
593 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
594 <listitem><simpara> User-supplied weakly referenced object
595 </simpara></listitem></varlistentry>
596 </variablelist></refsect2>
597 <refsect2 id="tp-cli-account-interface-avatar-connect-to-avatar-changed" role="function">
598 <title>tp_cli_account_interface_avatar_connect_to_avatar_changed ()</title>
599 <indexterm zone="tp-cli-account-interface-avatar-connect-to-avatar-changed"><primary sortas="tp_cli_account_interface_avatar_connect_to_avatar_changed">tp_cli_account_interface_avatar_connect_to_avatar_changed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_account_interface_avatar_connect_to_avatar_changed
600 (<link linkend="TpAccount">TpAccount</link> *proxy,
601 <link linkend="tp-cli-account-interface-avatar-signal-callback-avatar-changed">tp_cli_account_interface_avatar_signal_callback_avatar_changed</link> callback,
602 <link linkend="gpointer">gpointer</link> user_data,
603 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
604 <link linkend="GObject">GObject</link> *weak_object,
605 <link linkend="GError">GError</link> **error);</programlisting>
606 <para>
607 Connect a handler to the signal AvatarChanged.
608 </para>
609 <para>
610 Emitted when the Avatar property changes. &lt;tp:rationale&gt;The avatar itself is deliberately not included in this signal, to reduce bus traffic in the (likely common) case where no running application cares about the user&apos;s own avatar.&lt;/tp:rationale&gt;</para>
611 <para>
612 </para><variablelist role="params">
613 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
614 <listitem><simpara> A <link linkend="TpAccount"><type>TpAccount</type></link> or subclass
615 </simpara></listitem></varlistentry>
616 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
617 <listitem><simpara> Callback to be called when the signal is
618 received
619 </simpara></listitem></varlistentry>
620 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
621 <listitem><simpara> User-supplied data for the callback
622 </simpara></listitem></varlistentry>
623 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
624 <listitem><simpara> Destructor for the user-supplied data, which
625 will be called when this signal is disconnected, or
626 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
627 </simpara></listitem></varlistentry>
628 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
629 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
630 if it is destroyed, this callback will automatically be
631 disconnected
632 </simpara></listitem></varlistentry>
633 <varlistentry><term><parameter>error</parameter>&#160;:</term>
634 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
635 returned
636 </simpara></listitem></varlistentry>
637 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
638 above, which can be used to disconnect the signal; or
639 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
640 or has become invalid.
641 </simpara></listitem></varlistentry>
642 </variablelist></refsect2>
643
644 </refsect1>
645
646
647
648 <refsect1 id="telepathy-glib-account.see-also">
649 <title>See Also</title>
650 #TpAccountManager
651 </refsect1>
652
653 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE indexdiv PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <indexdiv>
4 <indexdiv><title>T</title>
5 <indexentry><primaryie linkends="TpAccount-struct"><link linkend="TpAccount">TpAccount</link></primaryie></indexentry>
6 <indexentry><primaryie linkends="TpAccountManager-struct"><link linkend="TpAccountManager">TpAccountManager</link></primaryie></indexentry>
7 <indexentry><primaryie linkends="TpChannelDispatcher-struct"><link linkend="TpChannelDispatcher">TpChannelDispatcher</link></primaryie></indexentry>
8 <indexentry><primaryie linkends="TpChannelDispatchOperation-struct"><link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link></primaryie></indexentry>
9 <indexentry><primaryie linkends="TpChannelRequest-struct"><link linkend="TpChannelRequest">TpChannelRequest</link></primaryie></indexentry>
10 <indexentry><primaryie linkends="TpClient-struct"><link linkend="TpClient">TpClient</link></primaryie></indexentry>
11 <indexentry><primaryie linkends="tp-account-init-known-interfaces"><link linkend="tp-account-init-known-interfaces">tp_account_init_known_interfaces</link></primaryie></indexentry>
12 <indexentry><primaryie linkends="tp-account-manager-init-known-interfaces"><link linkend="tp-account-manager-init-known-interfaces">tp_account_manager_init_known_interfaces</link></primaryie></indexentry>
13 <indexentry><primaryie linkends="tp-channel-dispatcher-init-known-interfaces"><link linkend="tp-channel-dispatcher-init-known-interfaces">tp_channel_dispatcher_init_known_interfaces</link></primaryie></indexentry>
14 <indexentry><primaryie linkends="tp-channel-dispatch-operation-init-known-interfaces"><link linkend="tp-channel-dispatch-operation-init-known-interfaces">tp_channel_dispatch_operation_init_known_interfaces</link></primaryie></indexentry>
15 <indexentry><primaryie linkends="tp-channel-request-init-known-interfaces"><link linkend="tp-channel-request-init-known-interfaces">tp_channel_request_init_known_interfaces</link></primaryie></indexentry>
16 <indexentry><primaryie linkends="tp-client-init-known-interfaces"><link linkend="tp-client-init-known-interfaces">tp_client_init_known_interfaces</link></primaryie></indexentry>
17 <indexentry><primaryie linkends="tp-connection-manager-init-known-interfaces"><link linkend="tp-connection-manager-init-known-interfaces">tp_connection_manager_init_known_interfaces</link></primaryie></indexentry>
18 <indexentry><primaryie linkends="tp-dbus-daemon-init-known-interfaces"><link linkend="tp-dbus-daemon-init-known-interfaces">tp_dbus_daemon_init_known_interfaces</link></primaryie></indexentry>
19 <indexentry><primaryie linkends="tp-media-session-handler-init-known-interfaces"><link linkend="tp-media-session-handler-init-known-interfaces">tp_media_session_handler_init_known_interfaces</link></primaryie></indexentry>
20 <indexentry><primaryie linkends="tp-media-stream-handler-init-known-interfaces"><link linkend="tp-media-stream-handler-init-known-interfaces">tp_media_stream_handler_init_known_interfaces</link></primaryie></indexentry>
21 </indexdiv>
22 </indexdiv>
3131 <indexentry><primaryie linkends="NUM-TP-TUBE-TYPES--CAPS"><link linkend="NUM-TP-TUBE-TYPES--CAPS">NUM_TP_TUBE_TYPES</link></primaryie></indexentry>
3232 </indexdiv>
3333 <indexdiv><title>T</title>
34 <indexentry><primaryie linkends="TpAccount-struct"><link linkend="TpAccount">TpAccount</link></primaryie></indexentry>
35 <indexentry><primaryie linkends="TpAccountClass"><link linkend="TpAccountClass">TpAccountClass</link></primaryie></indexentry>
36 <indexentry><primaryie linkends="TpAccountManager-struct"><link linkend="TpAccountManager">TpAccountManager</link></primaryie></indexentry>
37 <indexentry><primaryie linkends="TpAccountManagerClass"><link linkend="TpAccountManagerClass">TpAccountManagerClass</link></primaryie></indexentry>
3438 <indexentry><primaryie linkends="TpBaseConnection-struct"><link linkend="TpBaseConnection">TpBaseConnection</link></primaryie></indexentry>
3539 <indexentry><primaryie linkends="TpBaseConnection-shutdown-finished"><link linkend="TpBaseConnection-shutdown-finished">TpBaseConnection::shutdown-finished</link></primaryie></indexentry>
3640 <indexentry><primaryie linkends="TpBaseConnection--protocol"><link linkend="TpBaseConnection--protocol">TpBaseConnection:protocol</link></primaryie></indexentry>
5963 <indexentry><primaryie linkends="TpChannelCallStateFlags"><link linkend="TpChannelCallStateFlags">TpChannelCallStateFlags</link></primaryie></indexentry>
6064 <indexentry><primaryie linkends="TpChannelChatState"><link linkend="TpChannelChatState">TpChannelChatState</link></primaryie></indexentry>
6165 <indexentry><primaryie linkends="TpChannelClass"><link linkend="TpChannelClass">TpChannelClass</link></primaryie></indexentry>
66 <indexentry><primaryie linkends="TpChannelDispatcher-struct"><link linkend="TpChannelDispatcher">TpChannelDispatcher</link></primaryie></indexentry>
67 <indexentry><primaryie linkends="TpChannelDispatcherClass"><link linkend="TpChannelDispatcherClass">TpChannelDispatcherClass</link></primaryie></indexentry>
68 <indexentry><primaryie linkends="TpChannelDispatchOperation-struct"><link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link></primaryie></indexentry>
69 <indexentry><primaryie linkends="TpChannelDispatchOperationClass"><link linkend="TpChannelDispatchOperationClass">TpChannelDispatchOperationClass</link></primaryie></indexentry>
6270 <indexentry><primaryie linkends="TpChannelFactoryIface-struct"><link linkend="TpChannelFactoryIface">TpChannelFactoryIface</link></primaryie></indexentry>
6371 <indexentry><primaryie linkends="TpChannelFactoryIface-channel-error"><link linkend="TpChannelFactoryIface-channel-error">TpChannelFactoryIface::channel-error</link></primaryie></indexentry>
6472 <indexentry><primaryie linkends="TpChannelFactoryIface-new-channel"><link linkend="TpChannelFactoryIface-new-channel">TpChannelFactoryIface::new-channel</link></primaryie></indexentry>
8997 <indexentry><primaryie linkends="TpChannelManagerRequestFunc"><link linkend="TpChannelManagerRequestFunc">TpChannelManagerRequestFunc</link></primaryie></indexentry>
9098 <indexentry><primaryie linkends="TpChannelMediaCapabilities"><link linkend="TpChannelMediaCapabilities">TpChannelMediaCapabilities</link></primaryie></indexentry>
9199 <indexentry><primaryie linkends="TpChannelPasswordFlags"><link linkend="TpChannelPasswordFlags">TpChannelPasswordFlags</link></primaryie></indexentry>
100 <indexentry><primaryie linkends="TpChannelRequest-struct"><link linkend="TpChannelRequest">TpChannelRequest</link></primaryie></indexentry>
101 <indexentry><primaryie linkends="TpChannelRequest-succeeded"><link linkend="TpChannelRequest-succeeded">TpChannelRequest::succeeded</link></primaryie></indexentry>
102 <indexentry><primaryie linkends="TpChannelRequestClass"><link linkend="TpChannelRequestClass">TpChannelRequestClass</link></primaryie></indexentry>
92103 <indexentry><primaryie linkends="TpChannelTextMessageFlags"><link linkend="TpChannelTextMessageFlags">TpChannelTextMessageFlags</link></primaryie></indexentry>
93104 <indexentry><primaryie linkends="TpChannelTextMessageType"><link linkend="TpChannelTextMessageType">TpChannelTextMessageType</link></primaryie></indexentry>
94105 <indexentry><primaryie linkends="TpChannelTextSendError"><link linkend="TpChannelTextSendError">TpChannelTextSendError</link></primaryie></indexentry>
95106 <indexentry><primaryie linkends="TpChannelWhenReadyCb"><link linkend="TpChannelWhenReadyCb">TpChannelWhenReadyCb</link></primaryie></indexentry>
107 <indexentry><primaryie linkends="TpClient-struct"><link linkend="TpClient">TpClient</link></primaryie></indexentry>
108 <indexentry><primaryie linkends="TpClientClass"><link linkend="TpClientClass">TpClientClass</link></primaryie></indexentry>
96109 <indexentry><primaryie linkends="TpCMInfoSource"><link linkend="TpCMInfoSource">TpCMInfoSource</link></primaryie></indexentry>
97110 <indexentry><primaryie linkends="TpCMParamFilter"><link linkend="TpCMParamFilter">TpCMParamFilter</link></primaryie></indexentry>
98111 <indexentry><primaryie linkends="TpCMParamSetter"><link linkend="TpCMParamSetter">TpCMParamSetter</link></primaryie></indexentry>
242255 <indexentry><primaryie linkends="TpStaticHandleRepo-struct"><link linkend="TpStaticHandleRepo">TpStaticHandleRepo</link></primaryie></indexentry>
243256 <indexentry><primaryie linkends="TpStaticHandleRepo--handle-names"><link linkend="TpStaticHandleRepo--handle-names">TpStaticHandleRepo:handle-names</link></primaryie></indexentry>
244257 <indexentry><primaryie linkends="TpStaticHandleRepoClass"><link linkend="TpStaticHandleRepoClass">TpStaticHandleRepoClass</link></primaryie></indexentry>
258 <indexentry><primaryie linkends="TpSvcAccount-struct"><link linkend="TpSvcAccount">TpSvcAccount</link></primaryie></indexentry>
259 <indexentry><primaryie linkends="TpSvcAccount-account-property-changed"><link linkend="TpSvcAccount-account-property-changed">TpSvcAccount::account-property-changed</link></primaryie></indexentry>
260 <indexentry><primaryie linkends="TpSvcAccount-removed"><link linkend="TpSvcAccount-removed">TpSvcAccount::removed</link></primaryie></indexentry>
261 <indexentry><primaryie linkends="TpSvcAccountClass"><link linkend="TpSvcAccountClass">TpSvcAccountClass</link></primaryie></indexentry>
262 <indexentry><primaryie linkends="TpSvcAccountInterfaceAvatar-struct"><link linkend="TpSvcAccountInterfaceAvatar">TpSvcAccountInterfaceAvatar</link></primaryie></indexentry>
263 <indexentry><primaryie linkends="TpSvcAccountInterfaceAvatar-avatar-changed"><link linkend="TpSvcAccountInterfaceAvatar-avatar-changed">TpSvcAccountInterfaceAvatar::avatar-changed</link></primaryie></indexentry>
264 <indexentry><primaryie linkends="TpSvcAccountInterfaceAvatarClass"><link linkend="TpSvcAccountInterfaceAvatarClass">TpSvcAccountInterfaceAvatarClass</link></primaryie></indexentry>
265 <indexentry><primaryie linkends="TpSvcAccountManager-struct"><link linkend="TpSvcAccountManager">TpSvcAccountManager</link></primaryie></indexentry>
266 <indexentry><primaryie linkends="TpSvcAccountManager-account-removed"><link linkend="TpSvcAccountManager-account-removed">TpSvcAccountManager::account-removed</link></primaryie></indexentry>
267 <indexentry><primaryie linkends="TpSvcAccountManager-account-validity-changed"><link linkend="TpSvcAccountManager-account-validity-changed">TpSvcAccountManager::account-validity-changed</link></primaryie></indexentry>
268 <indexentry><primaryie linkends="TpSvcAccountManagerClass"><link linkend="TpSvcAccountManagerClass">TpSvcAccountManagerClass</link></primaryie></indexentry>
245269 <indexentry><primaryie linkends="TpSvcChannel-struct"><link linkend="TpSvcChannel">TpSvcChannel</link></primaryie></indexentry>
246270 <indexentry><primaryie linkends="TpSvcChannel-closed"><link linkend="TpSvcChannel-closed">TpSvcChannel::closed</link></primaryie></indexentry>
247271 <indexentry><primaryie linkends="TpSvcChannelClass"><link linkend="TpSvcChannelClass">TpSvcChannelClass</link></primaryie></indexentry>
272 <indexentry><primaryie linkends="TpSvcChannelDispatcher-struct"><link linkend="TpSvcChannelDispatcher">TpSvcChannelDispatcher</link></primaryie></indexentry>
273 <indexentry><primaryie linkends="TpSvcChannelDispatcherClass"><link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link></primaryie></indexentry>
274 <indexentry><primaryie linkends="TpSvcChannelDispatcherInterfaceOperationList-struct"><link linkend="TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</link></primaryie></indexentry>
275 <indexentry><primaryie linkends="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"><link linkend="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished">TpSvcChannelDispatcherInterfaceOperationList::dispatch-operation-finished</link></primaryie></indexentry>
276 <indexentry><primaryie linkends="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"><link linkend="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation">TpSvcChannelDispatcherInterfaceOperationList::new-dispatch-operation</link></primaryie></indexentry>
277 <indexentry><primaryie linkends="TpSvcChannelDispatcherInterfaceOperationListClass"><link linkend="TpSvcChannelDispatcherInterfaceOperationListClass">TpSvcChannelDispatcherInterfaceOperationListClass</link></primaryie></indexentry>
278 <indexentry><primaryie linkends="TpSvcChannelDispatchOperation-struct"><link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link></primaryie></indexentry>
279 <indexentry><primaryie linkends="TpSvcChannelDispatchOperation-channel-lost"><link linkend="TpSvcChannelDispatchOperation-channel-lost">TpSvcChannelDispatchOperation::channel-lost</link></primaryie></indexentry>
280 <indexentry><primaryie linkends="TpSvcChannelDispatchOperation-finished"><link linkend="TpSvcChannelDispatchOperation-finished">TpSvcChannelDispatchOperation::finished</link></primaryie></indexentry>
281 <indexentry><primaryie linkends="TpSvcChannelDispatchOperationClass"><link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link></primaryie></indexentry>
248282 <indexentry><primaryie linkends="TpSvcChannelInterfaceCallState-struct"><link linkend="TpSvcChannelInterfaceCallState">TpSvcChannelInterfaceCallState</link></primaryie></indexentry>
249283 <indexentry><primaryie linkends="TpSvcChannelInterfaceCallState-call-state-changed"><link linkend="TpSvcChannelInterfaceCallState-call-state-changed">TpSvcChannelInterfaceCallState::call-state-changed</link></primaryie></indexentry>
250284 <indexentry><primaryie linkends="TpSvcChannelInterfaceCallStateClass"><link linkend="TpSvcChannelInterfaceCallStateClass">TpSvcChannelInterfaceCallStateClass</link></primaryie></indexentry>
275309 <indexentry><primaryie linkends="TpSvcChannelInterfacePasswordClass"><link linkend="TpSvcChannelInterfacePasswordClass">TpSvcChannelInterfacePasswordClass</link></primaryie></indexentry>
276310 <indexentry><primaryie linkends="TpSvcChannelInterfaceTube"><link linkend="TpSvcChannelInterfaceTube">TpSvcChannelInterfaceTube</link></primaryie></indexentry>
277311 <indexentry><primaryie linkends="TpSvcChannelInterfaceTubeClass"><link linkend="TpSvcChannelInterfaceTubeClass">TpSvcChannelInterfaceTubeClass</link></primaryie></indexentry>
312 <indexentry><primaryie linkends="TpSvcChannelRequest-struct"><link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link></primaryie></indexentry>
313 <indexentry><primaryie linkends="TpSvcChannelRequest-failed"><link linkend="TpSvcChannelRequest-failed">TpSvcChannelRequest::failed</link></primaryie></indexentry>
314 <indexentry><primaryie linkends="TpSvcChannelRequest-succeeded"><link linkend="TpSvcChannelRequest-succeeded">TpSvcChannelRequest::succeeded</link></primaryie></indexentry>
315 <indexentry><primaryie linkends="TpSvcChannelRequestClass"><link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link></primaryie></indexentry>
278316 <indexentry><primaryie linkends="TpSvcChannelTypeContactList-struct"><link linkend="TpSvcChannelTypeContactList">TpSvcChannelTypeContactList</link></primaryie></indexentry>
279317 <indexentry><primaryie linkends="TpSvcChannelTypeContactListClass"><link linkend="TpSvcChannelTypeContactListClass">TpSvcChannelTypeContactListClass</link></primaryie></indexentry>
280318 <indexentry><primaryie linkends="TpSvcChannelTypeDBusTube"><link linkend="TpSvcChannelTypeDBusTube">TpSvcChannelTypeDBusTube</link></primaryie></indexentry>
307345 <indexentry><primaryie linkends="TpSvcChannelTypeTubes-tube-closed"><link linkend="TpSvcChannelTypeTubes-tube-closed">TpSvcChannelTypeTubes::tube-closed</link></primaryie></indexentry>
308346 <indexentry><primaryie linkends="TpSvcChannelTypeTubes-tube-state-changed"><link linkend="TpSvcChannelTypeTubes-tube-state-changed">TpSvcChannelTypeTubes::tube-state-changed</link></primaryie></indexentry>
309347 <indexentry><primaryie linkends="TpSvcChannelTypeTubesClass"><link linkend="TpSvcChannelTypeTubesClass">TpSvcChannelTypeTubesClass</link></primaryie></indexentry>
348 <indexentry><primaryie linkends="TpSvcClient-struct"><link linkend="TpSvcClient">TpSvcClient</link></primaryie></indexentry>
349 <indexentry><primaryie linkends="TpSvcClientApprover-struct"><link linkend="TpSvcClientApprover">TpSvcClientApprover</link></primaryie></indexentry>
350 <indexentry><primaryie linkends="TpSvcClientApproverClass"><link linkend="TpSvcClientApproverClass">TpSvcClientApproverClass</link></primaryie></indexentry>
351 <indexentry><primaryie linkends="TpSvcClientClass"><link linkend="TpSvcClientClass">TpSvcClientClass</link></primaryie></indexentry>
352 <indexentry><primaryie linkends="TpSvcClientHandler-struct"><link linkend="TpSvcClientHandler">TpSvcClientHandler</link></primaryie></indexentry>
353 <indexentry><primaryie linkends="TpSvcClientHandlerClass"><link linkend="TpSvcClientHandlerClass">TpSvcClientHandlerClass</link></primaryie></indexentry>
354 <indexentry><primaryie linkends="TpSvcClientInterfaceRequests-struct"><link linkend="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</link></primaryie></indexentry>
355 <indexentry><primaryie linkends="TpSvcClientInterfaceRequestsClass"><link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link></primaryie></indexentry>
356 <indexentry><primaryie linkends="TpSvcClientObserver-struct"><link linkend="TpSvcClientObserver">TpSvcClientObserver</link></primaryie></indexentry>
357 <indexentry><primaryie linkends="TpSvcClientObserverClass"><link linkend="TpSvcClientObserverClass">TpSvcClientObserverClass</link></primaryie></indexentry>
310358 <indexentry><primaryie linkends="TpSvcConnection-struct"><link linkend="TpSvcConnection">TpSvcConnection</link></primaryie></indexentry>
311359 <indexentry><primaryie linkends="TpSvcConnection-connection-error"><link linkend="TpSvcConnection-connection-error">TpSvcConnection::connection-error</link></primaryie></indexentry>
312360 <indexentry><primaryie linkends="TpSvcConnection-new-channel"><link linkend="TpSvcConnection-new-channel">TpSvcConnection::new-channel</link></primaryie></indexentry>
367415 <indexentry><primaryie linkends="TpTubeChannelState"><link linkend="TpTubeChannelState">TpTubeChannelState</link></primaryie></indexentry>
368416 <indexentry><primaryie linkends="TpTubeState"><link linkend="TpTubeState">TpTubeState</link></primaryie></indexentry>
369417 <indexentry><primaryie linkends="TpTubeType"><link linkend="TpTubeType">TpTubeType</link></primaryie></indexentry>
418 <indexentry><primaryie linkends="tp-account-init-known-interfaces"><link linkend="tp-account-init-known-interfaces">tp_account_init_known_interfaces</link></primaryie></indexentry>
419 <indexentry><primaryie linkends="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS"><link linkend="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS">TP_ACCOUNT_MANAGER_BUS_NAME</link></primaryie></indexentry>
420 <indexentry><primaryie linkends="tp-account-manager-init-known-interfaces"><link linkend="tp-account-manager-init-known-interfaces">tp_account_manager_init_known_interfaces</link></primaryie></indexentry>
421 <indexentry><primaryie linkends="tp-account-manager-new"><link linkend="tp-account-manager-new">tp_account_manager_new</link></primaryie></indexentry>
422 <indexentry><primaryie linkends="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS"><link linkend="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS">TP_ACCOUNT_MANAGER_OBJECT_PATH</link></primaryie></indexentry>
423 <indexentry><primaryie linkends="tp-account-new"><link linkend="tp-account-new">tp_account_new</link></primaryie></indexentry>
424 <indexentry><primaryie linkends="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS"><link linkend="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS">TP_ACCOUNT_OBJECT_PATH_BASE</link></primaryie></indexentry>
370425 <indexentry><primaryie linkends="TP-ANSI-BG-BLUE--CAPS"><link linkend="TP-ANSI-BG-BLUE--CAPS">TP_ANSI_BG_BLUE</link></primaryie></indexentry>
371426 <indexentry><primaryie linkends="TP-ANSI-BG-CYAN--CAPS"><link linkend="TP-ANSI-BG-CYAN--CAPS">TP_ANSI_BG_CYAN</link></primaryie></indexentry>
372427 <indexentry><primaryie linkends="TP-ANSI-BG-GREEN--CAPS"><link linkend="TP-ANSI-BG-GREEN--CAPS">TP_ANSI_BG_GREEN</link></primaryie></indexentry>
394449 <indexentry><primaryie linkends="TP-ARRAY-TYPE-CHANNEL-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CHANNEL-INFO-LIST--CAPS">TP_ARRAY_TYPE_CHANNEL_INFO_LIST</link></primaryie></indexentry>
395450 <indexentry><primaryie linkends="TP-ARRAY-TYPE-CONTACT-CAPABILITY-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-CONTACT-CAPABILITY-LIST--CAPS">TP_ARRAY_TYPE_CONTACT_CAPABILITY_LIST</link></primaryie></indexentry>
396451 <indexentry><primaryie linkends="TP-ARRAY-TYPE-DBUS-TUBE-MEMBER-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-DBUS-TUBE-MEMBER-LIST--CAPS">TP_ARRAY_TYPE_DBUS_TUBE_MEMBER_LIST</link></primaryie></indexentry>
452 <indexentry><primaryie linkends="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS">TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</link></primaryie></indexentry>
397453 <indexentry><primaryie linkends="TP-ARRAY-TYPE-LOCAL-PENDING-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-LOCAL-PENDING-INFO-LIST--CAPS">TP_ARRAY_TYPE_LOCAL_PENDING_INFO_LIST</link></primaryie></indexentry>
398454 <indexentry><primaryie linkends="TP-ARRAY-TYPE-MEDIA-SESSION-HANDLER-INFO-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-MEDIA-SESSION-HANDLER-INFO-LIST--CAPS">TP_ARRAY_TYPE_MEDIA_SESSION_HANDLER_INFO_LIST</link></primaryie></indexentry>
399455 <indexentry><primaryie linkends="TP-ARRAY-TYPE-MEDIA-STREAM-HANDLER-CANDIDATE-LIST--CAPS"><link linkend="TP-ARRAY-TYPE-MEDIA-STREAM-HANDLER-CANDIDATE-LIST--CAPS">TP_ARRAY_TYPE_MEDIA_STREAM_HANDLER_CANDIDATE_LIST</link></primaryie></indexentry>
463519 <indexentry><primaryie linkends="tp-channel-borrow-connection"><link linkend="tp-channel-borrow-connection">tp_channel_borrow_connection</link></primaryie></indexentry>
464520 <indexentry><primaryie linkends="tp-channel-borrow-immutable-properties"><link linkend="tp-channel-borrow-immutable-properties">tp_channel_borrow_immutable_properties</link></primaryie></indexentry>
465521 <indexentry><primaryie linkends="tp-channel-call-when-ready"><link linkend="tp-channel-call-when-ready">tp_channel_call_when_ready</link></primaryie></indexentry>
522 <indexentry><primaryie linkends="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS"><link linkend="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS">TP_CHANNEL_DISPATCHER_BUS_NAME</link></primaryie></indexentry>
523 <indexentry><primaryie linkends="tp-channel-dispatcher-init-known-interfaces"><link linkend="tp-channel-dispatcher-init-known-interfaces">tp_channel_dispatcher_init_known_interfaces</link></primaryie></indexentry>
524 <indexentry><primaryie linkends="tp-channel-dispatcher-new"><link linkend="tp-channel-dispatcher-new">tp_channel_dispatcher_new</link></primaryie></indexentry>
525 <indexentry><primaryie linkends="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS"><link linkend="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS">TP_CHANNEL_DISPATCHER_OBJECT_PATH</link></primaryie></indexentry>
526 <indexentry><primaryie linkends="tp-channel-dispatch-operation-init-known-interfaces"><link linkend="tp-channel-dispatch-operation-init-known-interfaces">tp_channel_dispatch_operation_init_known_interfaces</link></primaryie></indexentry>
527 <indexentry><primaryie linkends="tp-channel-dispatch-operation-new"><link linkend="tp-channel-dispatch-operation-new">tp_channel_dispatch_operation_new</link></primaryie></indexentry>
466528 <indexentry><primaryie linkends="tp-channel-factory-iface-close-all"><link linkend="tp-channel-factory-iface-close-all">tp_channel_factory_iface_close_all</link></primaryie></indexentry>
467529 <indexentry><primaryie linkends="tp-channel-factory-iface-connected"><link linkend="tp-channel-factory-iface-connected">tp_channel_factory_iface_connected</link></primaryie></indexentry>
468530 <indexentry><primaryie linkends="tp-channel-factory-iface-connecting"><link linkend="tp-channel-factory-iface-connecting">tp_channel_factory_iface_connecting</link></primaryie></indexentry>
499561 <indexentry><primaryie linkends="tp-channel-manager-request-channel"><link linkend="tp-channel-manager-request-channel">tp_channel_manager_request_channel</link></primaryie></indexentry>
500562 <indexentry><primaryie linkends="tp-channel-new"><link linkend="tp-channel-new">tp_channel_new</link></primaryie></indexentry>
501563 <indexentry><primaryie linkends="tp-channel-new-from-properties"><link linkend="tp-channel-new-from-properties">tp_channel_new_from_properties</link></primaryie></indexentry>
564 <indexentry><primaryie linkends="tp-channel-request-init-known-interfaces"><link linkend="tp-channel-request-init-known-interfaces">tp_channel_request_init_known_interfaces</link></primaryie></indexentry>
565 <indexentry><primaryie linkends="tp-channel-request-new"><link linkend="tp-channel-request-new">tp_channel_request_new</link></primaryie></indexentry>
502566 <indexentry><primaryie linkends="tp-channel-run-until-ready"><link linkend="tp-channel-run-until-ready">tp_channel_run_until_ready</link></primaryie></indexentry>
567 <indexentry><primaryie linkends="TP-CLIENT-BUS-NAME-BASE--CAPS"><link linkend="TP-CLIENT-BUS-NAME-BASE--CAPS">TP_CLIENT_BUS_NAME_BASE</link></primaryie></indexentry>
568 <indexentry><primaryie linkends="tp-client-init-known-interfaces"><link linkend="tp-client-init-known-interfaces">tp_client_init_known_interfaces</link></primaryie></indexentry>
569 <indexentry><primaryie linkends="TP-CLIENT-OBJECT-PATH-BASE--CAPS"><link linkend="TP-CLIENT-OBJECT-PATH-BASE--CAPS">TP_CLIENT_OBJECT_PATH_BASE</link></primaryie></indexentry>
570 <indexentry><primaryie linkends="tp-cli-account-callback-for-reconnect"><link linkend="tp-cli-account-callback-for-reconnect">tp_cli_account_callback_for_reconnect</link></primaryie></indexentry>
571 <indexentry><primaryie linkends="tp-cli-account-callback-for-remove"><link linkend="tp-cli-account-callback-for-remove">tp_cli_account_callback_for_remove</link></primaryie></indexentry>
572 <indexentry><primaryie linkends="tp-cli-account-callback-for-update-parameters"><link linkend="tp-cli-account-callback-for-update-parameters">tp_cli_account_callback_for_update_parameters</link></primaryie></indexentry>
573 <indexentry><primaryie linkends="tp-cli-account-call-reconnect"><link linkend="tp-cli-account-call-reconnect">tp_cli_account_call_reconnect</link></primaryie></indexentry>
574 <indexentry><primaryie linkends="tp-cli-account-call-remove"><link linkend="tp-cli-account-call-remove">tp_cli_account_call_remove</link></primaryie></indexentry>
575 <indexentry><primaryie linkends="tp-cli-account-call-update-parameters"><link linkend="tp-cli-account-call-update-parameters">tp_cli_account_call_update_parameters</link></primaryie></indexentry>
576 <indexentry><primaryie linkends="tp-cli-account-connect-to-account-property-changed"><link linkend="tp-cli-account-connect-to-account-property-changed">tp_cli_account_connect_to_account_property_changed</link></primaryie></indexentry>
577 <indexentry><primaryie linkends="tp-cli-account-connect-to-removed"><link linkend="tp-cli-account-connect-to-removed">tp_cli_account_connect_to_removed</link></primaryie></indexentry>
578 <indexentry><primaryie linkends="tp-cli-account-interface-avatar-connect-to-avatar-changed"><link linkend="tp-cli-account-interface-avatar-connect-to-avatar-changed">tp_cli_account_interface_avatar_connect_to_avatar_changed</link></primaryie></indexentry>
579 <indexentry><primaryie linkends="tp-cli-account-interface-avatar-signal-callback-avatar-changed"><link linkend="tp-cli-account-interface-avatar-signal-callback-avatar-changed">tp_cli_account_interface_avatar_signal_callback_avatar_changed</link></primaryie></indexentry>
580 <indexentry><primaryie linkends="tp-cli-account-manager-callback-for-create-account"><link linkend="tp-cli-account-manager-callback-for-create-account">tp_cli_account_manager_callback_for_create_account</link></primaryie></indexentry>
581 <indexentry><primaryie linkends="tp-cli-account-manager-call-create-account"><link linkend="tp-cli-account-manager-call-create-account">tp_cli_account_manager_call_create_account</link></primaryie></indexentry>
582 <indexentry><primaryie linkends="tp-cli-account-manager-connect-to-account-removed"><link linkend="tp-cli-account-manager-connect-to-account-removed">tp_cli_account_manager_connect_to_account_removed</link></primaryie></indexentry>
583 <indexentry><primaryie linkends="tp-cli-account-manager-connect-to-account-validity-changed"><link linkend="tp-cli-account-manager-connect-to-account-validity-changed">tp_cli_account_manager_connect_to_account_validity_changed</link></primaryie></indexentry>
584 <indexentry><primaryie linkends="tp-cli-account-manager-signal-callback-account-removed"><link linkend="tp-cli-account-manager-signal-callback-account-removed">tp_cli_account_manager_signal_callback_account_removed</link></primaryie></indexentry>
585 <indexentry><primaryie linkends="tp-cli-account-manager-signal-callback-account-validity-changed"><link linkend="tp-cli-account-manager-signal-callback-account-validity-changed">tp_cli_account_manager_signal_callback_account_validity_changed</link></primaryie></indexentry>
586 <indexentry><primaryie linkends="tp-cli-account-signal-callback-account-property-changed"><link linkend="tp-cli-account-signal-callback-account-property-changed">tp_cli_account_signal_callback_account_property_changed</link></primaryie></indexentry>
587 <indexentry><primaryie linkends="tp-cli-account-signal-callback-removed"><link linkend="tp-cli-account-signal-callback-removed">tp_cli_account_signal_callback_removed</link></primaryie></indexentry>
503588 <indexentry><primaryie linkends="tp-cli-channel-callback-for-close"><link linkend="tp-cli-channel-callback-for-close">tp_cli_channel_callback_for_close</link></primaryie></indexentry>
504589 <indexentry><primaryie linkends="tp-cli-channel-callback-for-get-channel-type"><link linkend="tp-cli-channel-callback-for-get-channel-type">tp_cli_channel_callback_for_get_channel_type</link></primaryie></indexentry>
505590 <indexentry><primaryie linkends="tp-cli-channel-callback-for-get-handle"><link linkend="tp-cli-channel-callback-for-get-handle">tp_cli_channel_callback_for_get_handle</link></primaryie></indexentry>
509594 <indexentry><primaryie linkends="tp-cli-channel-call-get-handle"><link linkend="tp-cli-channel-call-get-handle">tp_cli_channel_call_get_handle</link></primaryie></indexentry>
510595 <indexentry><primaryie linkends="tp-cli-channel-call-get-interfaces"><link linkend="tp-cli-channel-call-get-interfaces">tp_cli_channel_call_get_interfaces</link></primaryie></indexentry>
511596 <indexentry><primaryie linkends="tp-cli-channel-connect-to-closed"><link linkend="tp-cli-channel-connect-to-closed">tp_cli_channel_connect_to_closed</link></primaryie></indexentry>
597 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-callback-for-create-channel"><link linkend="tp-cli-channel-dispatcher-callback-for-create-channel">tp_cli_channel_dispatcher_callback_for_create_channel</link></primaryie></indexentry>
598 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-callback-for-ensure-channel"><link linkend="tp-cli-channel-dispatcher-callback-for-ensure-channel">tp_cli_channel_dispatcher_callback_for_ensure_channel</link></primaryie></indexentry>
599 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-call-create-channel"><link linkend="tp-cli-channel-dispatcher-call-create-channel">tp_cli_channel_dispatcher_call_create_channel</link></primaryie></indexentry>
600 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-call-ensure-channel"><link linkend="tp-cli-channel-dispatcher-call-ensure-channel">tp_cli_channel_dispatcher_call_ensure_channel</link></primaryie></indexentry>
601 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"><link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished">tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished</link></primaryie></indexentry>
602 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"><link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation">tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation</link></primaryie></indexentry>
603 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished"><link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</link></primaryie></indexentry>
604 <indexentry><primaryie linkends="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation"><link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</link></primaryie></indexentry>
605 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-callback-for-claim"><link linkend="tp-cli-channel-dispatch-operation-callback-for-claim">tp_cli_channel_dispatch_operation_callback_for_claim</link></primaryie></indexentry>
606 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-callback-for-handle-with"><link linkend="tp-cli-channel-dispatch-operation-callback-for-handle-with">tp_cli_channel_dispatch_operation_callback_for_handle_with</link></primaryie></indexentry>
607 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-call-claim"><link linkend="tp-cli-channel-dispatch-operation-call-claim">tp_cli_channel_dispatch_operation_call_claim</link></primaryie></indexentry>
608 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-call-handle-with"><link linkend="tp-cli-channel-dispatch-operation-call-handle-with">tp_cli_channel_dispatch_operation_call_handle_with</link></primaryie></indexentry>
609 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-connect-to-channel-lost"><link linkend="tp-cli-channel-dispatch-operation-connect-to-channel-lost">tp_cli_channel_dispatch_operation_connect_to_channel_lost</link></primaryie></indexentry>
610 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-connect-to-finished"><link linkend="tp-cli-channel-dispatch-operation-connect-to-finished">tp_cli_channel_dispatch_operation_connect_to_finished</link></primaryie></indexentry>
611 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-signal-callback-channel-lost"><link linkend="tp-cli-channel-dispatch-operation-signal-callback-channel-lost">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</link></primaryie></indexentry>
612 <indexentry><primaryie linkends="tp-cli-channel-dispatch-operation-signal-callback-finished"><link linkend="tp-cli-channel-dispatch-operation-signal-callback-finished">tp_cli_channel_dispatch_operation_signal_callback_finished</link></primaryie></indexentry>
512613 <indexentry><primaryie linkends="tp-cli-channel-interface-call-state-callback-for-get-call-states"><link linkend="tp-cli-channel-interface-call-state-callback-for-get-call-states">tp_cli_channel_interface_call_state_callback_for_get_call_states</link></primaryie></indexentry>
513614 <indexentry><primaryie linkends="tp-cli-channel-interface-call-state-call-get-call-states"><link linkend="tp-cli-channel-interface-call-state-call-get-call-states">tp_cli_channel_interface_call_state_call_get_call_states</link></primaryie></indexentry>
514615 <indexentry><primaryie linkends="tp-cli-channel-interface-call-state-connect-to-call-state-changed"><link linkend="tp-cli-channel-interface-call-state-connect-to-call-state-changed">tp_cli_channel_interface_call_state_connect_to_call_state_changed</link></primaryie></indexentry>
606707 <indexentry><primaryie linkends="tp-cli-channel-interface-password-signal-callback-password-flags-changed"><link linkend="tp-cli-channel-interface-password-signal-callback-password-flags-changed">tp_cli_channel_interface_password_signal_callback_password_flags_changed</link></primaryie></indexentry>
607708 <indexentry><primaryie linkends="tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed"><link linkend="tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed">tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed</link></primaryie></indexentry>
608709 <indexentry><primaryie linkends="tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed"><link linkend="tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed">tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</link></primaryie></indexentry>
710 <indexentry><primaryie linkends="tp-cli-channel-request-callback-for-cancel"><link linkend="tp-cli-channel-request-callback-for-cancel">tp_cli_channel_request_callback_for_cancel</link></primaryie></indexentry>
711 <indexentry><primaryie linkends="tp-cli-channel-request-callback-for-proceed"><link linkend="tp-cli-channel-request-callback-for-proceed">tp_cli_channel_request_callback_for_proceed</link></primaryie></indexentry>
712 <indexentry><primaryie linkends="tp-cli-channel-request-call-cancel"><link linkend="tp-cli-channel-request-call-cancel">tp_cli_channel_request_call_cancel</link></primaryie></indexentry>
713 <indexentry><primaryie linkends="tp-cli-channel-request-call-proceed"><link linkend="tp-cli-channel-request-call-proceed">tp_cli_channel_request_call_proceed</link></primaryie></indexentry>
714 <indexentry><primaryie linkends="tp-cli-channel-request-connect-to-failed"><link linkend="tp-cli-channel-request-connect-to-failed">tp_cli_channel_request_connect_to_failed</link></primaryie></indexentry>
715 <indexentry><primaryie linkends="tp-cli-channel-request-connect-to-succeeded"><link linkend="tp-cli-channel-request-connect-to-succeeded">tp_cli_channel_request_connect_to_succeeded</link></primaryie></indexentry>
716 <indexentry><primaryie linkends="tp-cli-channel-request-signal-callback-failed"><link linkend="tp-cli-channel-request-signal-callback-failed">tp_cli_channel_request_signal_callback_failed</link></primaryie></indexentry>
717 <indexentry><primaryie linkends="tp-cli-channel-request-signal-callback-succeeded"><link linkend="tp-cli-channel-request-signal-callback-succeeded">tp_cli_channel_request_signal_callback_succeeded</link></primaryie></indexentry>
609718 <indexentry><primaryie linkends="tp-cli-channel-run-close"><link linkend="tp-cli-channel-run-close">tp_cli_channel_run_close</link></primaryie></indexentry>
610719 <indexentry><primaryie linkends="tp-cli-channel-run-get-channel-type"><link linkend="tp-cli-channel-run-get-channel-type">tp_cli_channel_run_get_channel_type</link></primaryie></indexentry>
611720 <indexentry><primaryie linkends="tp-cli-channel-run-get-handle"><link linkend="tp-cli-channel-run-get-handle">tp_cli_channel_run_get_handle</link></primaryie></indexentry>
741850 <indexentry><primaryie linkends="tp-cli-channel-type-tubes-signal-callback-stream-tube-new-connection"><link linkend="tp-cli-channel-type-tubes-signal-callback-stream-tube-new-connection">tp_cli_channel_type_tubes_signal_callback_stream_tube_new_connection</link></primaryie></indexentry>
742851 <indexentry><primaryie linkends="tp-cli-channel-type-tubes-signal-callback-tube-closed"><link linkend="tp-cli-channel-type-tubes-signal-callback-tube-closed">tp_cli_channel_type_tubes_signal_callback_tube_closed</link></primaryie></indexentry>
743852 <indexentry><primaryie linkends="tp-cli-channel-type-tubes-signal-callback-tube-state-changed"><link linkend="tp-cli-channel-type-tubes-signal-callback-tube-state-changed">tp_cli_channel_type_tubes_signal_callback_tube_state_changed</link></primaryie></indexentry>
853 <indexentry><primaryie linkends="tp-cli-client-approver-callback-for-add-dispatch-operation"><link linkend="tp-cli-client-approver-callback-for-add-dispatch-operation">tp_cli_client_approver_callback_for_add_dispatch_operation</link></primaryie></indexentry>
854 <indexentry><primaryie linkends="tp-cli-client-approver-call-add-dispatch-operation"><link linkend="tp-cli-client-approver-call-add-dispatch-operation">tp_cli_client_approver_call_add_dispatch_operation</link></primaryie></indexentry>
855 <indexentry><primaryie linkends="tp-cli-client-handler-callback-for-handle-channels"><link linkend="tp-cli-client-handler-callback-for-handle-channels">tp_cli_client_handler_callback_for_handle_channels</link></primaryie></indexentry>
856 <indexentry><primaryie linkends="tp-cli-client-handler-call-handle-channels"><link linkend="tp-cli-client-handler-call-handle-channels">tp_cli_client_handler_call_handle_channels</link></primaryie></indexentry>
857 <indexentry><primaryie linkends="tp-cli-client-interface-requests-callback-for-add-request"><link linkend="tp-cli-client-interface-requests-callback-for-add-request">tp_cli_client_interface_requests_callback_for_add_request</link></primaryie></indexentry>
858 <indexentry><primaryie linkends="tp-cli-client-interface-requests-callback-for-remove-request"><link linkend="tp-cli-client-interface-requests-callback-for-remove-request">tp_cli_client_interface_requests_callback_for_remove_request</link></primaryie></indexentry>
859 <indexentry><primaryie linkends="tp-cli-client-interface-requests-call-add-request"><link linkend="tp-cli-client-interface-requests-call-add-request">tp_cli_client_interface_requests_call_add_request</link></primaryie></indexentry>
860 <indexentry><primaryie linkends="tp-cli-client-interface-requests-call-remove-request"><link linkend="tp-cli-client-interface-requests-call-remove-request">tp_cli_client_interface_requests_call_remove_request</link></primaryie></indexentry>
861 <indexentry><primaryie linkends="tp-cli-client-observer-callback-for-observe-channels"><link linkend="tp-cli-client-observer-callback-for-observe-channels">tp_cli_client_observer_callback_for_observe_channels</link></primaryie></indexentry>
862 <indexentry><primaryie linkends="tp-cli-client-observer-call-observe-channels"><link linkend="tp-cli-client-observer-call-observe-channels">tp_cli_client_observer_call_observe_channels</link></primaryie></indexentry>
744863 <indexentry><primaryie linkends="tp-cli-connection-callback-for-connect"><link linkend="tp-cli-connection-callback-for-connect">tp_cli_connection_callback_for_connect</link></primaryie></indexentry>
745864 <indexentry><primaryie linkends="tp-cli-connection-callback-for-disconnect"><link linkend="tp-cli-connection-callback-for-disconnect">tp_cli_connection_callback_for_disconnect</link></primaryie></indexentry>
746865 <indexentry><primaryie linkends="tp-cli-connection-callback-for-get-interfaces"><link linkend="tp-cli-connection-callback-for-get-interfaces">tp_cli_connection_callback_for_get_interfaces</link></primaryie></indexentry>
10641183 <indexentry><primaryie linkends="tp-connection-manager-get-name"><link linkend="tp-connection-manager-get-name">tp_connection_manager_get_name</link></primaryie></indexentry>
10651184 <indexentry><primaryie linkends="tp-connection-manager-get-protocol"><link linkend="tp-connection-manager-get-protocol">tp_connection_manager_get_protocol</link></primaryie></indexentry>
10661185 <indexentry><primaryie linkends="tp-connection-manager-has-protocol"><link linkend="tp-connection-manager-has-protocol">tp_connection_manager_has_protocol</link></primaryie></indexentry>
1186 <indexentry><primaryie linkends="tp-connection-manager-init-known-interfaces"><link linkend="tp-connection-manager-init-known-interfaces">tp_connection_manager_init_known_interfaces</link></primaryie></indexentry>
10671187 <indexentry><primaryie linkends="tp-connection-manager-is-ready"><link linkend="tp-connection-manager-is-ready">tp_connection_manager_is_ready</link></primaryie></indexentry>
10681188 <indexentry><primaryie linkends="tp-connection-manager-is-running"><link linkend="tp-connection-manager-is-running">tp_connection_manager_is_running</link></primaryie></indexentry>
10691189 <indexentry><primaryie linkends="tp-connection-manager-new"><link linkend="tp-connection-manager-new">tp_connection_manager_new</link></primaryie></indexentry>
11081228 <indexentry><primaryie linkends="tp-dbus-check-valid-object-path"><link linkend="tp-dbus-check-valid-object-path">tp_dbus_check_valid_object_path</link></primaryie></indexentry>
11091229 <indexentry><primaryie linkends="tp-dbus-daemon-cancel-name-owner-watch"><link linkend="tp-dbus-daemon-cancel-name-owner-watch">tp_dbus_daemon_cancel_name_owner_watch</link></primaryie></indexentry>
11101230 <indexentry><primaryie linkends="tp-dbus-daemon-dup"><link linkend="tp-dbus-daemon-dup">tp_dbus_daemon_dup</link></primaryie></indexentry>
1231 <indexentry><primaryie linkends="tp-dbus-daemon-init-known-interfaces"><link linkend="tp-dbus-daemon-init-known-interfaces">tp_dbus_daemon_init_known_interfaces</link></primaryie></indexentry>
11111232 <indexentry><primaryie linkends="tp-dbus-daemon-new"><link linkend="tp-dbus-daemon-new">tp_dbus_daemon_new</link></primaryie></indexentry>
11121233 <indexentry><primaryie linkends="tp-dbus-daemon-release-name"><link linkend="tp-dbus-daemon-release-name">tp_dbus_daemon_release_name</link></primaryie></indexentry>
11131234 <indexentry><primaryie linkends="tp-dbus-daemon-request-name"><link linkend="tp-dbus-daemon-request-name">tp_dbus_daemon_request_name</link></primaryie></indexentry>
12851406 <indexentry><primaryie linkends="tp-heap-peek-first"><link linkend="tp-heap-peek-first">tp_heap_peek_first</link></primaryie></indexentry>
12861407 <indexentry><primaryie linkends="tp-heap-remove"><link linkend="tp-heap-remove">tp_heap_remove</link></primaryie></indexentry>
12871408 <indexentry><primaryie linkends="tp-heap-size"><link linkend="tp-heap-size">tp_heap_size</link></primaryie></indexentry>
1409 <indexentry><primaryie linkends="TP-IFACE-ACCOUNT--CAPS"><link linkend="TP-IFACE-ACCOUNT--CAPS">TP_IFACE_ACCOUNT</link></primaryie></indexentry>
1410 <indexentry><primaryie linkends="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS"><link linkend="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS">TP_IFACE_ACCOUNT_INTERFACE_AVATAR</link></primaryie></indexentry>
1411 <indexentry><primaryie linkends="TP-IFACE-ACCOUNT-MANAGER--CAPS"><link linkend="TP-IFACE-ACCOUNT-MANAGER--CAPS">TP_IFACE_ACCOUNT_MANAGER</link></primaryie></indexentry>
12881412 <indexentry><primaryie linkends="TP-IFACE-CHANNEL--CAPS"><link linkend="TP-IFACE-CHANNEL--CAPS">TP_IFACE_CHANNEL</link></primaryie></indexentry>
1413 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-DISPATCHER--CAPS"><link linkend="TP-IFACE-CHANNEL-DISPATCHER--CAPS">TP_IFACE_CHANNEL_DISPATCHER</link></primaryie></indexentry>
1414 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"><link linkend="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</link></primaryie></indexentry>
1415 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS"><link linkend="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS">TP_IFACE_CHANNEL_DISPATCH_OPERATION</link></primaryie></indexentry>
12891416 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-CALL-STATE--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-CALL-STATE--CAPS">TP_IFACE_CHANNEL_INTERFACE_CALL_STATE</link></primaryie></indexentry>
12901417 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-CHAT-STATE--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-CHAT-STATE--CAPS">TP_IFACE_CHANNEL_INTERFACE_CHAT_STATE</link></primaryie></indexentry>
12911418 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-DESTROYABLE--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-DESTROYABLE--CAPS">TP_IFACE_CHANNEL_INTERFACE_DESTROYABLE</link></primaryie></indexentry>
12961423 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS">TP_IFACE_CHANNEL_INTERFACE_MESSAGES</link></primaryie></indexentry>
12971424 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-PASSWORD--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-PASSWORD--CAPS">TP_IFACE_CHANNEL_INTERFACE_PASSWORD</link></primaryie></indexentry>
12981425 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-INTERFACE-TUBE--CAPS"><link linkend="TP-IFACE-CHANNEL-INTERFACE-TUBE--CAPS">TP_IFACE_CHANNEL_INTERFACE_TUBE</link></primaryie></indexentry>
1426 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-REQUEST--CAPS"><link linkend="TP-IFACE-CHANNEL-REQUEST--CAPS">TP_IFACE_CHANNEL_REQUEST</link></primaryie></indexentry>
12991427 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-CONTACT-LIST--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-CONTACT-LIST--CAPS">TP_IFACE_CHANNEL_TYPE_CONTACT_LIST</link></primaryie></indexentry>
13001428 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-DBUS-TUBE--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-DBUS-TUBE--CAPS">TP_IFACE_CHANNEL_TYPE_DBUS_TUBE</link></primaryie></indexentry>
13011429 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-FILE-TRANSFER--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-FILE-TRANSFER--CAPS">TP_IFACE_CHANNEL_TYPE_FILE_TRANSFER</link></primaryie></indexentry>
13041432 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-STREAM-TUBE--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-STREAM-TUBE--CAPS">TP_IFACE_CHANNEL_TYPE_STREAM_TUBE</link></primaryie></indexentry>
13051433 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-TEXT--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-TEXT--CAPS">TP_IFACE_CHANNEL_TYPE_TEXT</link></primaryie></indexentry>
13061434 <indexentry><primaryie linkends="TP-IFACE-CHANNEL-TYPE-TUBES--CAPS"><link linkend="TP-IFACE-CHANNEL-TYPE-TUBES--CAPS">TP_IFACE_CHANNEL_TYPE_TUBES</link></primaryie></indexentry>
1435 <indexentry><primaryie linkends="TP-IFACE-CLIENT--CAPS"><link linkend="TP-IFACE-CLIENT--CAPS">TP_IFACE_CLIENT</link></primaryie></indexentry>
1436 <indexentry><primaryie linkends="TP-IFACE-CLIENT-APPROVER--CAPS"><link linkend="TP-IFACE-CLIENT-APPROVER--CAPS">TP_IFACE_CLIENT_APPROVER</link></primaryie></indexentry>
1437 <indexentry><primaryie linkends="TP-IFACE-CLIENT-HANDLER--CAPS"><link linkend="TP-IFACE-CLIENT-HANDLER--CAPS">TP_IFACE_CLIENT_HANDLER</link></primaryie></indexentry>
1438 <indexentry><primaryie linkends="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS"><link linkend="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS">TP_IFACE_CLIENT_INTERFACE_REQUESTS</link></primaryie></indexentry>
1439 <indexentry><primaryie linkends="TP-IFACE-CLIENT-OBSERVER--CAPS"><link linkend="TP-IFACE-CLIENT-OBSERVER--CAPS">TP_IFACE_CLIENT_OBSERVER</link></primaryie></indexentry>
13071440 <indexentry><primaryie linkends="TP-IFACE-CONNECTION--CAPS"><link linkend="TP-IFACE-CONNECTION--CAPS">TP_IFACE_CONNECTION</link></primaryie></indexentry>
13081441 <indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-ALIASING--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-ALIASING--CAPS">TP_IFACE_CONNECTION_INTERFACE_ALIASING</link></primaryie></indexentry>
13091442 <indexentry><primaryie linkends="TP-IFACE-CONNECTION-INTERFACE-AVATARS--CAPS"><link linkend="TP-IFACE-CONNECTION-INTERFACE-AVATARS--CAPS">TP_IFACE_CONNECTION_INTERFACE_AVATARS</link></primaryie></indexentry>
13201453 <indexentry><primaryie linkends="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS"><link linkend="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS">TP_IFACE_MEDIA_SESSION_HANDLER</link></primaryie></indexentry>
13211454 <indexentry><primaryie linkends="TP-IFACE-MEDIA-STREAM-HANDLER--CAPS"><link linkend="TP-IFACE-MEDIA-STREAM-HANDLER--CAPS">TP_IFACE_MEDIA_STREAM_HANDLER</link></primaryie></indexentry>
13221455 <indexentry><primaryie linkends="TP-IFACE-PROPERTIES-INTERFACE--CAPS"><link linkend="TP-IFACE-PROPERTIES-INTERFACE--CAPS">TP_IFACE_PROPERTIES_INTERFACE</link></primaryie></indexentry>
1456 <indexentry><primaryie linkends="TP-IFACE-QUARK-ACCOUNT--CAPS"><link linkend="TP-IFACE-QUARK-ACCOUNT--CAPS">TP_IFACE_QUARK_ACCOUNT</link></primaryie></indexentry>
1457 <indexentry><primaryie linkends="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS"><link linkend="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS">TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</link></primaryie></indexentry>
1458 <indexentry><primaryie linkends="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS"><link linkend="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS">TP_IFACE_QUARK_ACCOUNT_MANAGER</link></primaryie></indexentry>
13231459 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL--CAPS">TP_IFACE_QUARK_CHANNEL</link></primaryie></indexentry>
1460 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCHER</link></primaryie></indexentry>
1461 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</link></primaryie></indexentry>
1462 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</link></primaryie></indexentry>
13241463 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-CALL-STATE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-CALL-STATE--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_CALL_STATE</link></primaryie></indexentry>
13251464 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-CHAT-STATE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-CHAT-STATE--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_CHAT_STATE</link></primaryie></indexentry>
13261465 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-DESTROYABLE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-DESTROYABLE--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_DESTROYABLE</link></primaryie></indexentry>
13311470 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES</link></primaryie></indexentry>
13321471 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-PASSWORD--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-PASSWORD--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_PASSWORD</link></primaryie></indexentry>
13331472 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-INTERFACE-TUBE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-TUBE--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_TUBE</link></primaryie></indexentry>
1473 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS">TP_IFACE_QUARK_CHANNEL_REQUEST</link></primaryie></indexentry>
13341474 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-CONTACT-LIST--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-CONTACT-LIST--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_CONTACT_LIST</link></primaryie></indexentry>
13351475 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-DBUS-TUBE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-DBUS-TUBE--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_DBUS_TUBE</link></primaryie></indexentry>
13361476 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-FILE-TRANSFER--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-FILE-TRANSFER--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_FILE_TRANSFER</link></primaryie></indexentry>
13391479 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-STREAM-TUBE--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-STREAM-TUBE--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_STREAM_TUBE</link></primaryie></indexentry>
13401480 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-TEXT--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-TEXT--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_TEXT</link></primaryie></indexentry>
13411481 <indexentry><primaryie linkends="TP-IFACE-QUARK-CHANNEL-TYPE-TUBES--CAPS"><link linkend="TP-IFACE-QUARK-CHANNEL-TYPE-TUBES--CAPS">TP_IFACE_QUARK_CHANNEL_TYPE_TUBES</link></primaryie></indexentry>
1482 <indexentry><primaryie linkends="TP-IFACE-QUARK-CLIENT--CAPS"><link linkend="TP-IFACE-QUARK-CLIENT--CAPS">TP_IFACE_QUARK_CLIENT</link></primaryie></indexentry>
1483 <indexentry><primaryie linkends="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS"><link linkend="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS">TP_IFACE_QUARK_CLIENT_APPROVER</link></primaryie></indexentry>
1484 <indexentry><primaryie linkends="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS"><link linkend="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS">TP_IFACE_QUARK_CLIENT_HANDLER</link></primaryie></indexentry>
1485 <indexentry><primaryie linkends="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS"><link linkend="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS">TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</link></primaryie></indexentry>
1486 <indexentry><primaryie linkends="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS"><link linkend="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS">TP_IFACE_QUARK_CLIENT_OBSERVER</link></primaryie></indexentry>
13421487 <indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION--CAPS">TP_IFACE_QUARK_CONNECTION</link></primaryie></indexentry>
13431488 <indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-ALIASING--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-ALIASING--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_ALIASING</link></primaryie></indexentry>
13441489 <indexentry><primaryie linkends="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS"><link linkend="TP-IFACE-QUARK-CONNECTION-INTERFACE-AVATARS--CAPS">TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS</link></primaryie></indexentry>
13791524 <indexentry><primaryie linkends="tp-intset-union"><link linkend="tp-intset-union">tp_intset_union</link></primaryie></indexentry>
13801525 <indexentry><primaryie linkends="tp-list-connection-managers"><link linkend="tp-list-connection-managers">tp_list_connection_managers</link></primaryie></indexentry>
13811526 <indexentry><primaryie linkends="tp-list-connection-names"><link linkend="tp-list-connection-names">tp_list_connection_names</link></primaryie></indexentry>
1527 <indexentry><primaryie linkends="tp-media-session-handler-init-known-interfaces"><link linkend="tp-media-session-handler-init-known-interfaces">tp_media_session_handler_init_known_interfaces</link></primaryie></indexentry>
13821528 <indexentry><primaryie linkends="tp-media-session-handler-new"><link linkend="tp-media-session-handler-new">tp_media_session_handler_new</link></primaryie></indexentry>
1529 <indexentry><primaryie linkends="tp-media-stream-handler-init-known-interfaces"><link linkend="tp-media-stream-handler-init-known-interfaces">tp_media_stream_handler_init_known_interfaces</link></primaryie></indexentry>
13831530 <indexentry><primaryie linkends="tp-media-stream-handler-new"><link linkend="tp-media-stream-handler-new">tp_media_stream_handler_new</link></primaryie></indexentry>
13841531 <indexentry><primaryie linkends="tp-message-append-part"><link linkend="tp-message-append-part">tp_message_append_part</link></primaryie></indexentry>
13851532 <indexentry><primaryie linkends="tp-message-count-parts"><link linkend="tp-message-count-parts">tp_message_count_parts</link></primaryie></indexentry>
14761623 <indexentry><primaryie linkends="tp-static-handle-repo-new"><link linkend="tp-static-handle-repo-new">tp_static_handle_repo_new</link></primaryie></indexentry>
14771624 <indexentry><primaryie linkends="tp-strdiff"><link linkend="tp-strdiff">tp_strdiff</link></primaryie></indexentry>
14781625 <indexentry><primaryie linkends="TP-STRUCT-TYPE-ALIAS-PAIR--CAPS"><link linkend="TP-STRUCT-TYPE-ALIAS-PAIR--CAPS">TP_STRUCT_TYPE_ALIAS_PAIR</link></primaryie></indexentry>
1626 <indexentry><primaryie linkends="TP-STRUCT-TYPE-AVATAR--CAPS"><link linkend="TP-STRUCT-TYPE-AVATAR--CAPS">TP_STRUCT_TYPE_AVATAR</link></primaryie></indexentry>
14791627 <indexentry><primaryie linkends="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS"><link linkend="TP-STRUCT-TYPE-CAPABILITY-CHANGE--CAPS">TP_STRUCT_TYPE_CAPABILITY_CHANGE</link></primaryie></indexentry>
14801628 <indexentry><primaryie linkends="TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS"><link linkend="TP-STRUCT-TYPE-CAPABILITY-PAIR--CAPS">TP_STRUCT_TYPE_CAPABILITY_PAIR</link></primaryie></indexentry>
14811629 <indexentry><primaryie linkends="TP-STRUCT-TYPE-CHANNEL-DETAILS--CAPS"><link linkend="TP-STRUCT-TYPE-CHANNEL-DETAILS--CAPS">TP_STRUCT_TYPE_CHANNEL_DETAILS</link></primaryie></indexentry>
14821630 <indexentry><primaryie linkends="TP-STRUCT-TYPE-CHANNEL-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-CHANNEL-INFO--CAPS">TP_STRUCT_TYPE_CHANNEL_INFO</link></primaryie></indexentry>
14831631 <indexentry><primaryie linkends="TP-STRUCT-TYPE-CONTACT-CAPABILITY--CAPS"><link linkend="TP-STRUCT-TYPE-CONTACT-CAPABILITY--CAPS">TP_STRUCT_TYPE_CONTACT_CAPABILITY</link></primaryie></indexentry>
14841632 <indexentry><primaryie linkends="TP-STRUCT-TYPE-DBUS-TUBE-MEMBER--CAPS"><link linkend="TP-STRUCT-TYPE-DBUS-TUBE-MEMBER--CAPS">TP_STRUCT_TYPE_DBUS_TUBE_MEMBER</link></primaryie></indexentry>
1633 <indexentry><primaryie linkends="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"><link linkend="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</link></primaryie></indexentry>
14851634 <indexentry><primaryie linkends="TP-STRUCT-TYPE-LAST-ACTIVITY-AND-STATUSES--CAPS"><link linkend="TP-STRUCT-TYPE-LAST-ACTIVITY-AND-STATUSES--CAPS">TP_STRUCT_TYPE_LAST_ACTIVITY_AND_STATUSES</link></primaryie></indexentry>
14861635 <indexentry><primaryie linkends="TP-STRUCT-TYPE-LOCAL-PENDING-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-LOCAL-PENDING-INFO--CAPS">TP_STRUCT_TYPE_LOCAL_PENDING_INFO</link></primaryie></indexentry>
14871636 <indexentry><primaryie linkends="TP-STRUCT-TYPE-MEDIA-SESSION-HANDLER-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-MEDIA-SESSION-HANDLER-INFO--CAPS">TP_STRUCT_TYPE_MEDIA_SESSION_HANDLER_INFO</link></primaryie></indexentry>
15071656 <indexentry><primaryie linkends="TP-STRUCT-TYPE-STATUS-SPEC--CAPS"><link linkend="TP-STRUCT-TYPE-STATUS-SPEC--CAPS">TP_STRUCT_TYPE_STATUS_SPEC</link></primaryie></indexentry>
15081657 <indexentry><primaryie linkends="TP-STRUCT-TYPE-TUBE-INFO--CAPS"><link linkend="TP-STRUCT-TYPE-TUBE-INFO--CAPS">TP_STRUCT_TYPE_TUBE_INFO</link></primaryie></indexentry>
15091658 <indexentry><primaryie linkends="tp-strv-contains"><link linkend="tp-strv-contains">tp_strv_contains</link></primaryie></indexentry>
1659 <indexentry><primaryie linkends="tp-svc-account-emit-account-property-changed"><link linkend="tp-svc-account-emit-account-property-changed">tp_svc_account_emit_account_property_changed</link></primaryie></indexentry>
1660 <indexentry><primaryie linkends="tp-svc-account-emit-removed"><link linkend="tp-svc-account-emit-removed">tp_svc_account_emit_removed</link></primaryie></indexentry>
1661 <indexentry><primaryie linkends="tp-svc-account-implement-reconnect"><link linkend="tp-svc-account-implement-reconnect">tp_svc_account_implement_reconnect</link></primaryie></indexentry>
1662 <indexentry><primaryie linkends="tp-svc-account-implement-remove"><link linkend="tp-svc-account-implement-remove">tp_svc_account_implement_remove</link></primaryie></indexentry>
1663 <indexentry><primaryie linkends="tp-svc-account-implement-update-parameters"><link linkend="tp-svc-account-implement-update-parameters">tp_svc_account_implement_update_parameters</link></primaryie></indexentry>
1664 <indexentry><primaryie linkends="tp-svc-account-interface-avatar-emit-avatar-changed"><link linkend="tp-svc-account-interface-avatar-emit-avatar-changed">tp_svc_account_interface_avatar_emit_avatar_changed</link></primaryie></indexentry>
1665 <indexentry><primaryie linkends="tp-svc-account-manager-create-account-impl"><link linkend="tp-svc-account-manager-create-account-impl">tp_svc_account_manager_create_account_impl</link></primaryie></indexentry>
1666 <indexentry><primaryie linkends="tp-svc-account-manager-emit-account-removed"><link linkend="tp-svc-account-manager-emit-account-removed">tp_svc_account_manager_emit_account_removed</link></primaryie></indexentry>
1667 <indexentry><primaryie linkends="tp-svc-account-manager-emit-account-validity-changed"><link linkend="tp-svc-account-manager-emit-account-validity-changed">tp_svc_account_manager_emit_account_validity_changed</link></primaryie></indexentry>
1668 <indexentry><primaryie linkends="tp-svc-account-manager-implement-create-account"><link linkend="tp-svc-account-manager-implement-create-account">tp_svc_account_manager_implement_create_account</link></primaryie></indexentry>
1669 <indexentry><primaryie linkends="tp-svc-account-manager-return-from-create-account"><link linkend="tp-svc-account-manager-return-from-create-account">tp_svc_account_manager_return_from_create_account</link></primaryie></indexentry>
1670 <indexentry><primaryie linkends="tp-svc-account-reconnect-impl"><link linkend="tp-svc-account-reconnect-impl">tp_svc_account_reconnect_impl</link></primaryie></indexentry>
1671 <indexentry><primaryie linkends="tp-svc-account-remove-impl"><link linkend="tp-svc-account-remove-impl">tp_svc_account_remove_impl</link></primaryie></indexentry>
1672 <indexentry><primaryie linkends="tp-svc-account-return-from-reconnect"><link linkend="tp-svc-account-return-from-reconnect">tp_svc_account_return_from_reconnect</link></primaryie></indexentry>
1673 <indexentry><primaryie linkends="tp-svc-account-return-from-remove"><link linkend="tp-svc-account-return-from-remove">tp_svc_account_return_from_remove</link></primaryie></indexentry>
1674 <indexentry><primaryie linkends="tp-svc-account-return-from-update-parameters"><link linkend="tp-svc-account-return-from-update-parameters">tp_svc_account_return_from_update_parameters</link></primaryie></indexentry>
1675 <indexentry><primaryie linkends="tp-svc-account-update-parameters-impl"><link linkend="tp-svc-account-update-parameters-impl">tp_svc_account_update_parameters_impl</link></primaryie></indexentry>
15101676 <indexentry><primaryie linkends="tp-svc-channel-close-impl"><link linkend="tp-svc-channel-close-impl">tp_svc_channel_close_impl</link></primaryie></indexentry>
1677 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-create-channel-impl"><link linkend="tp-svc-channel-dispatcher-create-channel-impl">tp_svc_channel_dispatcher_create_channel_impl</link></primaryie></indexentry>
1678 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-ensure-channel-impl"><link linkend="tp-svc-channel-dispatcher-ensure-channel-impl">tp_svc_channel_dispatcher_ensure_channel_impl</link></primaryie></indexentry>
1679 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-implement-create-channel"><link linkend="tp-svc-channel-dispatcher-implement-create-channel">tp_svc_channel_dispatcher_implement_create_channel</link></primaryie></indexentry>
1680 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-implement-ensure-channel"><link linkend="tp-svc-channel-dispatcher-implement-ensure-channel">tp_svc_channel_dispatcher_implement_ensure_channel</link></primaryie></indexentry>
1681 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished"><link linkend="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished">tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished</link></primaryie></indexentry>
1682 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation"><link linkend="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation">tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation</link></primaryie></indexentry>
1683 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-return-from-create-channel"><link linkend="tp-svc-channel-dispatcher-return-from-create-channel">tp_svc_channel_dispatcher_return_from_create_channel</link></primaryie></indexentry>
1684 <indexentry><primaryie linkends="tp-svc-channel-dispatcher-return-from-ensure-channel"><link linkend="tp-svc-channel-dispatcher-return-from-ensure-channel">tp_svc_channel_dispatcher_return_from_ensure_channel</link></primaryie></indexentry>
1685 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-claim-impl"><link linkend="tp-svc-channel-dispatch-operation-claim-impl">tp_svc_channel_dispatch_operation_claim_impl</link></primaryie></indexentry>
1686 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-emit-channel-lost"><link linkend="tp-svc-channel-dispatch-operation-emit-channel-lost">tp_svc_channel_dispatch_operation_emit_channel_lost</link></primaryie></indexentry>
1687 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-emit-finished"><link linkend="tp-svc-channel-dispatch-operation-emit-finished">tp_svc_channel_dispatch_operation_emit_finished</link></primaryie></indexentry>
1688 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-handle-with-impl"><link linkend="tp-svc-channel-dispatch-operation-handle-with-impl">tp_svc_channel_dispatch_operation_handle_with_impl</link></primaryie></indexentry>
1689 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-implement-claim"><link linkend="tp-svc-channel-dispatch-operation-implement-claim">tp_svc_channel_dispatch_operation_implement_claim</link></primaryie></indexentry>
1690 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-implement-handle-with"><link linkend="tp-svc-channel-dispatch-operation-implement-handle-with">tp_svc_channel_dispatch_operation_implement_handle_with</link></primaryie></indexentry>
1691 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-return-from-claim"><link linkend="tp-svc-channel-dispatch-operation-return-from-claim">tp_svc_channel_dispatch_operation_return_from_claim</link></primaryie></indexentry>
1692 <indexentry><primaryie linkends="tp-svc-channel-dispatch-operation-return-from-handle-with"><link linkend="tp-svc-channel-dispatch-operation-return-from-handle-with">tp_svc_channel_dispatch_operation_return_from_handle_with</link></primaryie></indexentry>
15111693 <indexentry><primaryie linkends="tp-svc-channel-emit-closed"><link linkend="tp-svc-channel-emit-closed">tp_svc_channel_emit_closed</link></primaryie></indexentry>
15121694 <indexentry><primaryie linkends="tp-svc-channel-get-channel-type-impl"><link linkend="tp-svc-channel-get-channel-type-impl">tp_svc_channel_get_channel_type_impl</link></primaryie></indexentry>
15131695 <indexentry><primaryie linkends="tp-svc-channel-get-handle-impl"><link linkend="tp-svc-channel-get-handle-impl">tp_svc_channel_get_handle_impl</link></primaryie></indexentry>
15991781 <indexentry><primaryie linkends="tp-svc-channel-interface-password-return-from-get-password-flags"><link linkend="tp-svc-channel-interface-password-return-from-get-password-flags">tp_svc_channel_interface_password_return_from_get_password_flags</link></primaryie></indexentry>
16001782 <indexentry><primaryie linkends="tp-svc-channel-interface-password-return-from-provide-password"><link linkend="tp-svc-channel-interface-password-return-from-provide-password">tp_svc_channel_interface_password_return_from_provide_password</link></primaryie></indexentry>
16011783 <indexentry><primaryie linkends="tp-svc-channel-interface-tube-emit-tube-channel-state-changed"><link linkend="tp-svc-channel-interface-tube-emit-tube-channel-state-changed">tp_svc_channel_interface_tube_emit_tube_channel_state_changed</link></primaryie></indexentry>
1784 <indexentry><primaryie linkends="tp-svc-channel-request-cancel-impl"><link linkend="tp-svc-channel-request-cancel-impl">tp_svc_channel_request_cancel_impl</link></primaryie></indexentry>
1785 <indexentry><primaryie linkends="tp-svc-channel-request-emit-failed"><link linkend="tp-svc-channel-request-emit-failed">tp_svc_channel_request_emit_failed</link></primaryie></indexentry>
1786 <indexentry><primaryie linkends="tp-svc-channel-request-emit-succeeded"><link linkend="tp-svc-channel-request-emit-succeeded">tp_svc_channel_request_emit_succeeded</link></primaryie></indexentry>
1787 <indexentry><primaryie linkends="tp-svc-channel-request-implement-cancel"><link linkend="tp-svc-channel-request-implement-cancel">tp_svc_channel_request_implement_cancel</link></primaryie></indexentry>
1788 <indexentry><primaryie linkends="tp-svc-channel-request-implement-proceed"><link linkend="tp-svc-channel-request-implement-proceed">tp_svc_channel_request_implement_proceed</link></primaryie></indexentry>
1789 <indexentry><primaryie linkends="tp-svc-channel-request-proceed-impl"><link linkend="tp-svc-channel-request-proceed-impl">tp_svc_channel_request_proceed_impl</link></primaryie></indexentry>
1790 <indexentry><primaryie linkends="tp-svc-channel-request-return-from-cancel"><link linkend="tp-svc-channel-request-return-from-cancel">tp_svc_channel_request_return_from_cancel</link></primaryie></indexentry>
1791 <indexentry><primaryie linkends="tp-svc-channel-request-return-from-proceed"><link linkend="tp-svc-channel-request-return-from-proceed">tp_svc_channel_request_return_from_proceed</link></primaryie></indexentry>
16021792 <indexentry><primaryie linkends="tp-svc-channel-return-from-close"><link linkend="tp-svc-channel-return-from-close">tp_svc_channel_return_from_close</link></primaryie></indexentry>
16031793 <indexentry><primaryie linkends="tp-svc-channel-return-from-get-channel-type"><link linkend="tp-svc-channel-return-from-get-channel-type">tp_svc_channel_return_from_get_channel_type</link></primaryie></indexentry>
16041794 <indexentry><primaryie linkends="tp-svc-channel-return-from-get-handle"><link linkend="tp-svc-channel-return-from-get-handle">tp_svc_channel_return_from_get_handle</link></primaryie></indexentry>
17101900 <indexentry><primaryie linkends="tp-svc-channel-type-tubes-return-from-list-tubes"><link linkend="tp-svc-channel-type-tubes-return-from-list-tubes">tp_svc_channel_type_tubes_return_from_list_tubes</link></primaryie></indexentry>
17111901 <indexentry><primaryie linkends="tp-svc-channel-type-tubes-return-from-offer-d-bus-tube"><link linkend="tp-svc-channel-type-tubes-return-from-offer-d-bus-tube">tp_svc_channel_type_tubes_return_from_offer_d_bus_tube</link></primaryie></indexentry>
17121902 <indexentry><primaryie linkends="tp-svc-channel-type-tubes-return-from-offer-stream-tube"><link linkend="tp-svc-channel-type-tubes-return-from-offer-stream-tube">tp_svc_channel_type_tubes_return_from_offer_stream_tube</link></primaryie></indexentry>
1903 <indexentry><primaryie linkends="tp-svc-client-approver-add-dispatch-operation-impl"><link linkend="tp-svc-client-approver-add-dispatch-operation-impl">tp_svc_client_approver_add_dispatch_operation_impl</link></primaryie></indexentry>
1904 <indexentry><primaryie linkends="tp-svc-client-approver-implement-add-dispatch-operation"><link linkend="tp-svc-client-approver-implement-add-dispatch-operation">tp_svc_client_approver_implement_add_dispatch_operation</link></primaryie></indexentry>
1905 <indexentry><primaryie linkends="tp-svc-client-approver-return-from-add-dispatch-operation"><link linkend="tp-svc-client-approver-return-from-add-dispatch-operation">tp_svc_client_approver_return_from_add_dispatch_operation</link></primaryie></indexentry>
1906 <indexentry><primaryie linkends="tp-svc-client-handler-handle-channels-impl"><link linkend="tp-svc-client-handler-handle-channels-impl">tp_svc_client_handler_handle_channels_impl</link></primaryie></indexentry>
1907 <indexentry><primaryie linkends="tp-svc-client-handler-implement-handle-channels"><link linkend="tp-svc-client-handler-implement-handle-channels">tp_svc_client_handler_implement_handle_channels</link></primaryie></indexentry>
1908 <indexentry><primaryie linkends="tp-svc-client-handler-return-from-handle-channels"><link linkend="tp-svc-client-handler-return-from-handle-channels">tp_svc_client_handler_return_from_handle_channels</link></primaryie></indexentry>
1909 <indexentry><primaryie linkends="tp-svc-client-interface-requests-add-request-impl"><link linkend="tp-svc-client-interface-requests-add-request-impl">tp_svc_client_interface_requests_add_request_impl</link></primaryie></indexentry>
1910 <indexentry><primaryie linkends="tp-svc-client-interface-requests-implement-add-request"><link linkend="tp-svc-client-interface-requests-implement-add-request">tp_svc_client_interface_requests_implement_add_request</link></primaryie></indexentry>
1911 <indexentry><primaryie linkends="tp-svc-client-interface-requests-implement-remove-request"><link linkend="tp-svc-client-interface-requests-implement-remove-request">tp_svc_client_interface_requests_implement_remove_request</link></primaryie></indexentry>
1912 <indexentry><primaryie linkends="tp-svc-client-interface-requests-remove-request-impl"><link linkend="tp-svc-client-interface-requests-remove-request-impl">tp_svc_client_interface_requests_remove_request_impl</link></primaryie></indexentry>
1913 <indexentry><primaryie linkends="tp-svc-client-interface-requests-return-from-add-request"><link linkend="tp-svc-client-interface-requests-return-from-add-request">tp_svc_client_interface_requests_return_from_add_request</link></primaryie></indexentry>
1914 <indexentry><primaryie linkends="tp-svc-client-interface-requests-return-from-remove-request"><link linkend="tp-svc-client-interface-requests-return-from-remove-request">tp_svc_client_interface_requests_return_from_remove_request</link></primaryie></indexentry>
1915 <indexentry><primaryie linkends="tp-svc-client-observer-implement-observe-channels"><link linkend="tp-svc-client-observer-implement-observe-channels">tp_svc_client_observer_implement_observe_channels</link></primaryie></indexentry>
1916 <indexentry><primaryie linkends="tp-svc-client-observer-observe-channels-impl"><link linkend="tp-svc-client-observer-observe-channels-impl">tp_svc_client_observer_observe_channels_impl</link></primaryie></indexentry>
1917 <indexentry><primaryie linkends="tp-svc-client-observer-return-from-observe-channels"><link linkend="tp-svc-client-observer-return-from-observe-channels">tp_svc_client_observer_return_from_observe_channels</link></primaryie></indexentry>
17131918 <indexentry><primaryie linkends="tp-svc-connection-connect-impl"><link linkend="tp-svc-connection-connect-impl">tp_svc_connection_connect_impl</link></primaryie></indexentry>
17141919 <indexentry><primaryie linkends="tp-svc-connection-disconnect-impl"><link linkend="tp-svc-connection-disconnect-impl">tp_svc_connection_disconnect_impl</link></primaryie></indexentry>
17151920 <indexentry><primaryie linkends="tp-svc-connection-emit-connection-error"><link linkend="tp-svc-connection-emit-connection-error">tp_svc_connection_emit_connection_error</link></primaryie></indexentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-channel-dispatch-operation">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-channel-dispatch-operation.top_of_page">TpChannelDispatchOperation</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpChannelDispatchOperation</refname>
12 <refpurpose>proxy object for a to the Telepathy channel
13 dispatcher</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv id="telepathy-glib-channel-dispatch-operation.synopsis" role="synopsis">
17 <title role="synopsis.title">Synopsis</title>
18 <anchor id="TpChannelDispatchOperation"/>
19 <synopsis>
20
21 #include &lt;telepathy-glib/channel-dispatch-operation.h&gt;
22
23 struct <link linkend="TpChannelDispatchOperation-struct">TpChannelDispatchOperation</link>;
24 struct <link linkend="TpChannelDispatchOperationClass">TpChannelDispatchOperationClass</link>;
25 <link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> * <link linkend="tp-channel-dispatch-operation-new">tp_channel_dispatch_operation_new</link>
26 (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
27 const <link linkend="gchar">gchar</link> *object_path,
28 <link linkend="GHashTable">GHashTable</link> *immutable_properties,
29 <link linkend="GError">GError</link> **error);
30 <link linkend="void">void</link> <link linkend="tp-channel-dispatch-operation-init-known-interfaces">tp_channel_dispatch_operation_init_known_interfaces</link>
31 (void);
32
33 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatch-operation-callback-for-claim">*tp_cli_channel_dispatch_operation_callback_for_claim</link>)
34 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
35 const <link linkend="GError">GError</link> *error,
36 <link linkend="gpointer">gpointer</link> user_data,
37 <link linkend="GObject">GObject</link> *weak_object);
38 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-dispatch-operation-call-claim">tp_cli_channel_dispatch_operation_call_claim</link>
39 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
40 <link linkend="gint">gint</link> timeout_ms,
41 <link linkend="tp-cli-channel-dispatch-operation-callback-for-claim">tp_cli_channel_dispatch_operation_callback_for_claim</link> callback,
42 <link linkend="gpointer">gpointer</link> user_data,
43 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
44 <link linkend="GObject">GObject</link> *weak_object);
45 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatch-operation-callback-for-handle-with">*tp_cli_channel_dispatch_operation_callback_for_handle_with</link>)
46 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
47 const <link linkend="GError">GError</link> *error,
48 <link linkend="gpointer">gpointer</link> user_data,
49 <link linkend="GObject">GObject</link> *weak_object);
50 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-dispatch-operation-call-handle-with">tp_cli_channel_dispatch_operation_call_handle_with</link>
51 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
52 <link linkend="gint">gint</link> timeout_ms,
53 const <link linkend="gchar">gchar</link> *in_Handler,
54 <link linkend="tp-cli-channel-dispatch-operation-callback-for-handle-with">tp_cli_channel_dispatch_operation_callback_for_handle_with</link> callback,
55 <link linkend="gpointer">gpointer</link> user_data,
56 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
57 <link linkend="GObject">GObject</link> *weak_object);
58 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatch-operation-signal-callback-channel-lost">*tp_cli_channel_dispatch_operation_signal_callback_channel_lost</link>)
59 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
60 const <link linkend="gchar">gchar</link> *arg_Channel,
61 const <link linkend="gchar">gchar</link> *arg_Error,
62 const <link linkend="gchar">gchar</link> *arg_Message,
63 <link linkend="gpointer">gpointer</link> user_data,
64 <link linkend="GObject">GObject</link> *weak_object);
65 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-dispatch-operation-connect-to-channel-lost">tp_cli_channel_dispatch_operation_connect_to_channel_lost</link>
66 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
67 <link linkend="tp-cli-channel-dispatch-operation-signal-callback-channel-lost">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</link> callback,
68 <link linkend="gpointer">gpointer</link> user_data,
69 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
70 <link linkend="GObject">GObject</link> *weak_object,
71 <link linkend="GError">GError</link> **error);
72 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatch-operation-signal-callback-finished">*tp_cli_channel_dispatch_operation_signal_callback_finished</link>)
73 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
74 <link linkend="gpointer">gpointer</link> user_data,
75 <link linkend="GObject">GObject</link> *weak_object);
76 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-dispatch-operation-connect-to-finished">tp_cli_channel_dispatch_operation_connect_to_finished</link>
77 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
78 <link linkend="tp-cli-channel-dispatch-operation-signal-callback-finished">tp_cli_channel_dispatch_operation_signal_callback_finished</link> callback,
79 <link linkend="gpointer">gpointer</link> user_data,
80 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
81 <link linkend="GObject">GObject</link> *weak_object,
82 <link linkend="GError">GError</link> **error);
83 </synopsis>
84 </refsynopsisdiv>
85
86 <refsect1 id="telepathy-glib-channel-dispatch-operation.object-hierarchy" role="object_hierarchy">
87 <title role="object_hierarchy.title">Object Hierarchy</title>
88 <synopsis>
89 <link linkend="GObject">GObject</link>
90 +----<link linkend="TpProxy">TpProxy</link>
91 +----TpChannelDispatchOperation
92 </synopsis>
93 </refsect1>
94
95
96
97
98
99
100
101
102 <refsect1 id="telepathy-glib-channel-dispatch-operation.description" role="desc">
103 <title role="desc.title">Description</title>
104 <para>
105 One of the channel dispatcher's functions is to offer incoming channels to
106 Approver clients for approval. Approvers respond to the channel dispatcher
107 via a <link linkend="TpChannelDispatchOperation"><type>TpChannelDispatchOperation</type></link> object.</para>
108 <para>
109 </para>
110 </refsect1>
111
112 <refsect1 id="telepathy-glib-channel-dispatch-operation.details" role="details">
113 <title role="details.title">Details</title>
114 <refsect2 id="TpChannelDispatchOperation-struct" role="struct">
115 <title>struct TpChannelDispatchOperation</title>
116 <indexterm zone="TpChannelDispatchOperation-struct" role="0.7.UNRELEASED"><primary sortas="TpChannelDispatchOperation">TpChannelDispatchOperation</primary></indexterm><programlisting>struct TpChannelDispatchOperation;</programlisting>
117 <para>
118 One of the channel dispatcher's functions is to offer incoming channels to
119 Approver clients for approval. An approver should generally ask the user
120 whether they want to participate in the requested communication channels
121 (join the chat or chatroom, answer the call, accept the file transfer, or
122 whatever is appropriate). A collection of channels offered in this way
123 is represented by a ChannelDispatchOperation object.
124 </para>
125 <para>
126 If the user wishes to accept the communication channels, the approver
127 should call <link linkend="tp-cli-channel-dispatch-operation-call-handle-with"><function>tp_cli_channel_dispatch_operation_call_handle_with()</function></link> to
128 indicate the user's or approver's preferred handler for the channels (the
129 empty string indicates no particular preference, and will cause any
130 suitable handler to be used).
131 </para>
132 <para>
133 If the user wishes to reject the communication channels, or if the user
134 accepts the channels and the approver will handle them itself, the approver
135 should call <link linkend="tp-cli-channel-dispatch-operation-call-claim"><function>tp_cli_channel_dispatch_operation_call_claim()</function></link>. If this method
136 succeeds, the approver immediately has control over the channels as their
137 primary handler, and may do anything with them (in particular, it may close
138 them in whatever way seems most appropriate).
139 </para>
140 <para>
141 There are various situations in which the channel dispatch operation will
142 be closed, causing the <link linkend="TpProxy-invalidated"><type>"invalidated"</type></link> signal to be emitted. If this
143 happens, the approver should stop prompting the user.
144 </para>
145 <para>
146 Because all approvers are launched simultaneously, the user might respond
147 to another approver; if this happens, the invalidated signal will be
148 emitted with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
149 <link linkend="TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><literal>TP_DBUS_ERROR_OBJECT_REMOVED</literal></link>.
150 </para>
151 <para>
152 If a channel closes, the D-Bus signal ChannelLost is emitted; this class
153 doesn't (yet) have a GObject binding for this signal, but you can use
154 <link linkend="tp-cli-channel-dispatch-operation-connect-to-channel-lost"><function>tp_cli_channel_dispatch_operation_connect_to_channel_lost()</function></link>. If all channels
155 close, there is nothing more to dispatch, so the invalidated signal will be
156 emitted with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
157 <link linkend="TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><literal>TP_DBUS_ERROR_OBJECT_REMOVED</literal></link>.
158 </para>
159 <para>
160 If the channel dispatcher crashes or exits, the invalidated
161 signal will be emitted with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
162 <link linkend="TP-DBUS-ERROR-NAME-OWNER-LOST--CAPS"><literal>TP_DBUS_ERROR_NAME_OWNER_LOST</literal></link>. In a high-quality implementation, the
163 dispatcher should be restarted, at which point it will create new
164 channel dispatch operations for any undispatched channels, and the approver
165 will be notified again.
166 </para>
167 <para>
168 This proxy is usable but incomplete: accessors for the D-Bus properties will
169 be added in a later version of telepathy-glib, along with a mechanism
170 similar to <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.</para>
171 <para>
172 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
173 <refsect2 id="TpChannelDispatchOperationClass" role="struct">
174 <title>struct TpChannelDispatchOperationClass</title>
175 <indexterm zone="TpChannelDispatchOperationClass"><primary sortas="TpChannelDispatchOperationClass">TpChannelDispatchOperationClass</primary></indexterm><programlisting>struct TpChannelDispatchOperationClass {
176 };
177 </programlisting>
178 <para>
179 The class of a <link linkend="TpChannelDispatchOperation"><type>TpChannelDispatchOperation</type></link>.</para>
180 <para>
181 </para></refsect2>
182 <refsect2 id="tp-channel-dispatch-operation-new" role="function">
183 <title>tp_channel_dispatch_operation_new ()</title>
184 <indexterm zone="tp-channel-dispatch-operation-new"><primary sortas="tp_channel_dispatch_operation_new">tp_channel_dispatch_operation_new</primary></indexterm><programlisting><link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> * tp_channel_dispatch_operation_new
185 (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
186 const <link linkend="gchar">gchar</link> *object_path,
187 <link linkend="GHashTable">GHashTable</link> *immutable_properties,
188 <link linkend="GError">GError</link> **error);</programlisting>
189 <para>
190 Convenience function to create a new channel dispatch operation proxy.
191 </para>
192 <para>
193 The <parameter>immutable_properties</parameter> argument is not yet used.</para>
194 <para>
195 </para><variablelist role="params">
196 <varlistentry><term><parameter>bus_daemon</parameter>&#160;:</term>
197 <listitem><simpara> Proxy for the D-Bus daemon
198 </simpara></listitem></varlistentry>
199 <varlistentry><term><parameter>object_path</parameter>&#160;:</term>
200 <listitem><simpara> The non-NULL object path of this channel dispatch operation
201 </simpara></listitem></varlistentry>
202 <varlistentry><term><parameter>immutable_properties</parameter>&#160;:</term>
203 <listitem><simpara> As many as are known of the immutable D-Bus
204 properties of this channel dispatch operation, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if none are known
205 </simpara></listitem></varlistentry>
206 <varlistentry><term><parameter>error</parameter>&#160;:</term>
207 <listitem><simpara> Used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is returned
208 </simpara></listitem></varlistentry>
209 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new reference to an channel dispatch operation proxy, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
210 <parameter>object_path</parameter> is not syntactically valid or the channel dispatcher is not
211 running
212 </simpara></listitem></varlistentry>
213 </variablelist></refsect2>
214 <refsect2 id="tp-channel-dispatch-operation-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
215 <title>tp_channel_dispatch_operation_init_known_interfaces ()</title>
216 <indexterm zone="tp-channel-dispatch-operation-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_channel_dispatch_operation_init_known_interfaces">tp_channel_dispatch_operation_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_channel_dispatch_operation_init_known_interfaces
217 (void);</programlisting>
218 <para>
219 Ensure that the known interfaces for TpChannelDispatchOperation have been
220 set up. This is done automatically when necessary, but for correct
221 overriding of library interfaces by local extensions, you should
222 call this function before calling
223 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
224 <link linkend="TP-TYPE-CHANNEL-DISPATCH-OPERATION--CAPS"><literal>TP_TYPE_CHANNEL_DISPATCH_OPERATION</literal></link>.</para>
225 <para>
226 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
227 <refsect2 id="tp-cli-channel-dispatch-operation-callback-for-claim" role="function">
228 <title>tp_cli_channel_dispatch_operation_callback_for_claim ()</title>
229 <indexterm zone="tp-cli-channel-dispatch-operation-callback-for-claim"><primary sortas="tp_cli_channel_dispatch_operation_callback_for_claim">tp_cli_channel_dispatch_operation_callback_for_claim</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatch_operation_callback_for_claim)
230 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
231 const <link linkend="GError">GError</link> *error,
232 <link linkend="gpointer">gpointer</link> user_data,
233 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
234 <para>
235 Signature of the callback called when a Claim method call
236 succeeds or fails.</para>
237 <para>
238 </para><variablelist role="params">
239 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
240 <listitem><simpara> the proxy on which the call was made
241 </simpara></listitem></varlistentry>
242 <varlistentry><term><parameter>error</parameter>&#160;:</term>
243 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
244 </simpara></listitem></varlistentry>
245 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
246 <listitem><simpara> user-supplied data
247 </simpara></listitem></varlistentry>
248 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
249 <listitem><simpara> user-supplied object
250 </simpara></listitem></varlistentry>
251 </variablelist></refsect2>
252 <refsect2 id="tp-cli-channel-dispatch-operation-call-claim" role="function">
253 <title>tp_cli_channel_dispatch_operation_call_claim ()</title>
254 <indexterm zone="tp-cli-channel-dispatch-operation-call-claim"><primary sortas="tp_cli_channel_dispatch_operation_call_claim">tp_cli_channel_dispatch_operation_call_claim</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_dispatch_operation_call_claim
255 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
256 <link linkend="gint">gint</link> timeout_ms,
257 <link linkend="tp-cli-channel-dispatch-operation-callback-for-claim">tp_cli_channel_dispatch_operation_callback_for_claim</link> callback,
258 <link linkend="gpointer">gpointer</link> user_data,
259 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
260 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
261 <para>
262 Start a Claim method call.
263 </para>
264 <para>
265 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by an approver to claim channels for handling internally. If this method is called successfully, the process calling this method becomes the handler for the channel, but &lt;em&gt;does not&lt;/em&gt; have the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt; method called on it.&lt;/p&gt; &lt;p&gt;Clients that call Claim on channels but do not immediately close them SHOULD implement the Handler interface and its &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandledChannels&lt;/tp:dbus-ref&gt; property.&lt;/p&gt; &lt;p&gt;Approvers wishing to reject channels MUST call this method to claim ownership of them, and MUST NOT call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Channel&quot;&gt;Close&lt;/tp:dbus-ref&gt; on the channels unless/until this method returns successfully.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The channel dispatcher can&apos;t know how best to close arbitrary channel types, so it leaves it up to the approver to do so. For instance, for Text channels it is necessary to acknowledge any messages that have already been displayed to the user first - ideally, the approver would display and then acknowledge the messages - or to call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel.Interface.Destroyable.Destroy&lt;/tp:dbus-ref&gt; if the destructive behaviour of that method is desired.&lt;/p&gt; &lt;p&gt;Similarly, an Approver for StreamedMedia channels can close the channel with a reason (e.g. &amp;quot;busy&amp;quot;) if desired. The channel dispatcher, which is designed to have no specific knowledge of particular channel types, can&apos;t do that.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation object to disappear, emitting &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;, in the same way as for &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;This method may fail because the dispatch operation has already been completed. Again, see HandleWith for more details. The approver MUST NOT attempt to interact with the channels further in this case.&lt;/p&gt; &lt;p&gt;(FIXME: list some other possible errors)&lt;/p&gt;</para>
266 <para>
267 </para><variablelist role="params">
268 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
269 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
270 </simpara></listitem></varlistentry>
271 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
272 <listitem><simpara> the timeout in milliseconds, or -1 to use the
273 default
274 </simpara></listitem></varlistentry>
275 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
276 <listitem><simpara> called when the method call succeeds or fails;
277 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
278 reply tracking
279 </simpara></listitem></varlistentry>
280 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
281 <listitem><simpara> user-supplied data passed to the callback;
282 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
283 </simpara></listitem></varlistentry>
284 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
285 <listitem><simpara> called with the user_data as argument, after the
286 call has succeeded, failed or been cancelled;
287 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
288 </simpara></listitem></varlistentry>
289 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
290 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
291 weakly referenced; if it is destroyed, this call
292 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
293 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
294 </simpara></listitem></varlistentry>
295 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
296 progress. It is borrowed from the object, and will become
297 invalid when the callback is called, the call is
298 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
299 </simpara></listitem></varlistentry>
300 </variablelist></refsect2>
301 <refsect2 id="tp-cli-channel-dispatch-operation-callback-for-handle-with" role="function">
302 <title>tp_cli_channel_dispatch_operation_callback_for_handle_with ()</title>
303 <indexterm zone="tp-cli-channel-dispatch-operation-callback-for-handle-with"><primary sortas="tp_cli_channel_dispatch_operation_callback_for_handle_with">tp_cli_channel_dispatch_operation_callback_for_handle_with</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatch_operation_callback_for_handle_with)
304 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
305 const <link linkend="GError">GError</link> *error,
306 <link linkend="gpointer">gpointer</link> user_data,
307 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
308 <para>
309 Signature of the callback called when a HandleWith method call
310 succeeds or fails.</para>
311 <para>
312 </para><variablelist role="params">
313 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
314 <listitem><simpara> the proxy on which the call was made
315 </simpara></listitem></varlistentry>
316 <varlistentry><term><parameter>error</parameter>&#160;:</term>
317 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
318 </simpara></listitem></varlistentry>
319 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
320 <listitem><simpara> user-supplied data
321 </simpara></listitem></varlistentry>
322 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
323 <listitem><simpara> user-supplied object
324 </simpara></listitem></varlistentry>
325 </variablelist></refsect2>
326 <refsect2 id="tp-cli-channel-dispatch-operation-call-handle-with" role="function">
327 <title>tp_cli_channel_dispatch_operation_call_handle_with ()</title>
328 <indexterm zone="tp-cli-channel-dispatch-operation-call-handle-with"><primary sortas="tp_cli_channel_dispatch_operation_call_handle_with">tp_cli_channel_dispatch_operation_call_handle_with</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_dispatch_operation_call_handle_with
329 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
330 <link linkend="gint">gint</link> timeout_ms,
331 const <link linkend="gchar">gchar</link> *in_Handler,
332 <link linkend="tp-cli-channel-dispatch-operation-callback-for-handle-with">tp_cli_channel_dispatch_operation_callback_for_handle_with</link> callback,
333 <link linkend="gpointer">gpointer</link> user_data,
334 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
335 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
336 <para>
337 Start a HandleWith method call.
338 </para>
339 <para>
340 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by an approver to accept a channel bundle and request that the given handler be used to handle it.&lt;/p&gt; &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation object to disappear, emitting &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;However, this method may fail because the dispatch has already been completed and the object has already gone. If this occurs, it indicates that another approver has asked for the bundle to be handled by a particular handler. The approver MUST NOT attempt to interact with the channels further in this case, unless it is separately invoked as the handler.&lt;/p&gt; &lt;p&gt;Approvers which are also channel handlers SHOULD use &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; instead of HandleWith to request that they can handle a channel bundle themselves.&lt;/p&gt; &lt;p&gt;(FIXME: list some possible errors)&lt;/p&gt; &lt;p&gt;If the channel handler raises an error from &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt;, this method MAY respond by raising that same error, even if it is not specifically documented here.&lt;/p&gt;</para>
341 <para>
342 </para><variablelist role="params">
343 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
344 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
345 </simpara></listitem></varlistentry>
346 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
347 <listitem><simpara> the timeout in milliseconds, or -1 to use the
348 default
349 </simpara></listitem></varlistentry>
350 <varlistentry><term><parameter>in_Handler</parameter>&#160;:</term>
351 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the channel handler that should handle the channel, or the empty string if the client has no preferred channel handler.&lt;/p&gt;
352 </simpara></listitem></varlistentry>
353 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
354 <listitem><simpara> called when the method call succeeds or fails;
355 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
356 reply tracking
357 </simpara></listitem></varlistentry>
358 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
359 <listitem><simpara> user-supplied data passed to the callback;
360 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
361 </simpara></listitem></varlistentry>
362 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
363 <listitem><simpara> called with the user_data as argument, after the
364 call has succeeded, failed or been cancelled;
365 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
366 </simpara></listitem></varlistentry>
367 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
368 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
369 weakly referenced; if it is destroyed, this call
370 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
371 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
372 </simpara></listitem></varlistentry>
373 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
374 progress. It is borrowed from the object, and will become
375 invalid when the callback is called, the call is
376 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
377 </simpara></listitem></varlistentry>
378 </variablelist></refsect2>
379 <refsect2 id="tp-cli-channel-dispatch-operation-signal-callback-channel-lost" role="function">
380 <title>tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()</title>
381 <indexterm zone="tp-cli-channel-dispatch-operation-signal-callback-channel-lost"><primary sortas="tp_cli_channel_dispatch_operation_signal_callback_channel_lost">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatch_operation_signal_callback_channel_lost)
382 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
383 const <link linkend="gchar">gchar</link> *arg_Channel,
384 const <link linkend="gchar">gchar</link> *arg_Error,
385 const <link linkend="gchar">gchar</link> *arg_Message,
386 <link linkend="gpointer">gpointer</link> user_data,
387 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
388 <para>
389 Represents the signature of a callback for the signal ChannelLost.</para>
390 <para>
391 </para><variablelist role="params">
392 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
393 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-dispatch-operation-connect-to-channel-lost"><function>tp_cli_channel_dispatch_operation_connect_to_channel_lost()</function></link>
394 was called
395 </simpara></listitem></varlistentry>
396 <varlistentry><term><parameter>arg_Channel</parameter>&#160;:</term>
397 <listitem><simpara> The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel&lt;/tp:dbus-ref&gt; that closed.
398 </simpara></listitem></varlistentry>
399 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
400 <listitem><simpara> &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The name of a D-Bus error indicating why the channel closed. If no better reason can be found, &lt;code&gt;org.freedesktop.Telepathy.Error.NotAvailable&lt;/code&gt; MAY be used as a fallback; this means that this error SHOULD NOT be given any more specific meaning.&lt;/p&gt;
401 </simpara></listitem></varlistentry>
402 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
403 <listitem><simpara> A string associated with the D-Bus error.
404 </simpara></listitem></varlistentry>
405 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
406 <listitem><simpara> User-supplied data
407 </simpara></listitem></varlistentry>
408 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
409 <listitem><simpara> User-supplied weakly referenced object
410 </simpara></listitem></varlistentry>
411 </variablelist></refsect2>
412 <refsect2 id="tp-cli-channel-dispatch-operation-connect-to-channel-lost" role="function">
413 <title>tp_cli_channel_dispatch_operation_connect_to_channel_lost ()</title>
414 <indexterm zone="tp-cli-channel-dispatch-operation-connect-to-channel-lost"><primary sortas="tp_cli_channel_dispatch_operation_connect_to_channel_lost">tp_cli_channel_dispatch_operation_connect_to_channel_lost</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_dispatch_operation_connect_to_channel_lost
415 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
416 <link linkend="tp-cli-channel-dispatch-operation-signal-callback-channel-lost">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</link> callback,
417 <link linkend="gpointer">gpointer</link> user_data,
418 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
419 <link linkend="GObject">GObject</link> *weak_object,
420 <link linkend="GError">GError</link> **error);</programlisting>
421 <para>
422 Connect a handler to the signal ChannelLost.
423 </para>
424 <para>
425 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;A channel has closed before it could be claimed or handled. If this is emitted for the last remaining channel in a channel dispatch operation, it MUST immediately be followed by &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were invoked have returned (successfully or with an error) from their &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Approver&quot;&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means that Approvers can connect to the ChannelLost signal in a race-free way. Non-approver processes that discover a channel dispatch operation in some way (such as observers) will have to follow the usual &amp;quot;connect to signals then recover state&amp;quot; model - first connect to ChannelLost and &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;, then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt; (and on error, perhaps assume that the operation has already Finished).&lt;/p&gt; &lt;/tp:rationale&gt;</para>
426 <para>
427 </para><variablelist role="params">
428 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
429 <listitem><simpara> A <link linkend="TpChannelDispatchOperation"><type>TpChannelDispatchOperation</type></link> or subclass
430 </simpara></listitem></varlistentry>
431 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
432 <listitem><simpara> Callback to be called when the signal is
433 received
434 </simpara></listitem></varlistentry>
435 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
436 <listitem><simpara> User-supplied data for the callback
437 </simpara></listitem></varlistentry>
438 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
439 <listitem><simpara> Destructor for the user-supplied data, which
440 will be called when this signal is disconnected, or
441 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
442 </simpara></listitem></varlistentry>
443 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
444 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
445 if it is destroyed, this callback will automatically be
446 disconnected
447 </simpara></listitem></varlistentry>
448 <varlistentry><term><parameter>error</parameter>&#160;:</term>
449 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
450 returned
451 </simpara></listitem></varlistentry>
452 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
453 above, which can be used to disconnect the signal; or
454 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
455 or has become invalid.
456 </simpara></listitem></varlistentry>
457 </variablelist></refsect2>
458 <refsect2 id="tp-cli-channel-dispatch-operation-signal-callback-finished" role="function">
459 <title>tp_cli_channel_dispatch_operation_signal_callback_finished ()</title>
460 <indexterm zone="tp-cli-channel-dispatch-operation-signal-callback-finished"><primary sortas="tp_cli_channel_dispatch_operation_signal_callback_finished">tp_cli_channel_dispatch_operation_signal_callback_finished</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatch_operation_signal_callback_finished)
461 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
462 <link linkend="gpointer">gpointer</link> user_data,
463 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
464 <para>
465 Represents the signature of a callback for the signal Finished.</para>
466 <para>
467 </para><variablelist role="params">
468 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
469 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-dispatch-operation-connect-to-finished"><function>tp_cli_channel_dispatch_operation_connect_to_finished()</function></link>
470 was called
471 </simpara></listitem></varlistentry>
472 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
473 <listitem><simpara> User-supplied data
474 </simpara></listitem></varlistentry>
475 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
476 <listitem><simpara> User-supplied weakly referenced object
477 </simpara></listitem></varlistentry>
478 </variablelist></refsect2>
479 <refsect2 id="tp-cli-channel-dispatch-operation-connect-to-finished" role="function">
480 <title>tp_cli_channel_dispatch_operation_connect_to_finished ()</title>
481 <indexterm zone="tp-cli-channel-dispatch-operation-connect-to-finished"><primary sortas="tp_cli_channel_dispatch_operation_connect_to_finished">tp_cli_channel_dispatch_operation_connect_to_finished</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_dispatch_operation_connect_to_finished
482 (<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link> *proxy,
483 <link linkend="tp-cli-channel-dispatch-operation-signal-callback-finished">tp_cli_channel_dispatch_operation_signal_callback_finished</link> callback,
484 <link linkend="gpointer">gpointer</link> user_data,
485 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
486 <link linkend="GObject">GObject</link> *weak_object,
487 <link linkend="GError">GError</link> **error);</programlisting>
488 <para>
489 Connect a handler to the signal Finished.
490 </para>
491 <para>
492 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Emitted when this dispatch operation finishes. The dispatch operation is no longer present and further methods must not be called on it.&lt;/p&gt; &lt;p&gt;Approvers that have a user interface SHOULD stop notifying the user about the channels in response to this signal; they MAY assume that on errors, they would have received &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; first.&lt;/p&gt; &lt;p&gt;Its object path SHOULD NOT be reused for a subsequent dispatch operation; the ChannelDispatcher MUST choose object paths in a way that avoids immediate re-use.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Otherwise, clients might accidentally call &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt; or &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; on a new dispatch operation instead of the one they intended to handle.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were invoked have returned (successfully or with an error) from their &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Approver&quot;&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means that Approvers can connect to the ChannelLost signal in a race-free way. Non-approver processes that discover a channel dispatch operation in some way (such as observers) will have to follow the usual &amp;quot;connect to signals then recover state&amp;quot; model - first connect to &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; and Finished, then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt; (and on error, perhaps assume that the operation has already Finished).&lt;/p&gt; &lt;/tp:rationale&gt;</para>
493 <para>
494 </para><variablelist role="params">
495 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
496 <listitem><simpara> A <link linkend="TpChannelDispatchOperation"><type>TpChannelDispatchOperation</type></link> or subclass
497 </simpara></listitem></varlistentry>
498 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
499 <listitem><simpara> Callback to be called when the signal is
500 received
501 </simpara></listitem></varlistentry>
502 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
503 <listitem><simpara> User-supplied data for the callback
504 </simpara></listitem></varlistentry>
505 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
506 <listitem><simpara> Destructor for the user-supplied data, which
507 will be called when this signal is disconnected, or
508 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
509 </simpara></listitem></varlistentry>
510 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
511 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
512 if it is destroyed, this callback will automatically be
513 disconnected
514 </simpara></listitem></varlistentry>
515 <varlistentry><term><parameter>error</parameter>&#160;:</term>
516 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
517 returned
518 </simpara></listitem></varlistentry>
519 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
520 above, which can be used to disconnect the signal; or
521 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
522 or has become invalid.
523 </simpara></listitem></varlistentry>
524 </variablelist></refsect2>
525
526 </refsect1>
527
528
529
530 <refsect1 id="telepathy-glib-channel-dispatch-operation.see-also">
531 <title>See Also</title>
532 #TpChannelDispatcher
533 </refsect1>
534
535 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-channel-dispatcher">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-channel-dispatcher.top_of_page">TpChannelDispatcher</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpChannelDispatcher</refname>
12 <refpurpose>proxy object for the Telepathy channel dispatcher</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-channel-dispatcher.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpChannelDispatcher"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/channel-dispatcher.h&gt;
21
22 <link linkend="TpChannelDispatcher-struct">TpChannelDispatcher</link>;
23 <link linkend="TpChannelDispatcherClass">TpChannelDispatcherClass</link>;
24 <link linkend="TpChannelDispatcher">TpChannelDispatcher</link> * <link linkend="tp-channel-dispatcher-new">tp_channel_dispatcher_new</link> (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon);
25 <link linkend="void">void</link> <link linkend="tp-channel-dispatcher-init-known-interfaces">tp_channel_dispatcher_init_known_interfaces</link>
26 (void);
27
28 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatcher-callback-for-create-channel">*tp_cli_channel_dispatcher_callback_for_create_channel</link>)
29 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
30 const <link linkend="gchar">gchar</link> *out_Request,
31 const <link linkend="GError">GError</link> *error,
32 <link linkend="gpointer">gpointer</link> user_data,
33 <link linkend="GObject">GObject</link> *weak_object);
34 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-dispatcher-call-create-channel">tp_cli_channel_dispatcher_call_create_channel</link>
35 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
36 <link linkend="gint">gint</link> timeout_ms,
37 const <link linkend="gchar">gchar</link> *in_Account,
38 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
39 <link linkend="gint64">gint64</link> in_User_Action_Time,
40 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
41 <link linkend="tp-cli-channel-dispatcher-callback-for-create-channel">tp_cli_channel_dispatcher_callback_for_create_channel</link> callback,
42 <link linkend="gpointer">gpointer</link> user_data,
43 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
44 <link linkend="GObject">GObject</link> *weak_object);
45 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatcher-callback-for-ensure-channel">*tp_cli_channel_dispatcher_callback_for_ensure_channel</link>)
46 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
47 const <link linkend="gchar">gchar</link> *out_Request,
48 const <link linkend="GError">GError</link> *error,
49 <link linkend="gpointer">gpointer</link> user_data,
50 <link linkend="GObject">GObject</link> *weak_object);
51 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-dispatcher-call-ensure-channel">tp_cli_channel_dispatcher_call_ensure_channel</link>
52 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
53 <link linkend="gint">gint</link> timeout_ms,
54 const <link linkend="gchar">gchar</link> *in_Account,
55 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
56 <link linkend="gint64">gint64</link> in_User_Action_Time,
57 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
58 <link linkend="tp-cli-channel-dispatcher-callback-for-ensure-channel">tp_cli_channel_dispatcher_callback_for_ensure_channel</link> callback,
59 <link linkend="gpointer">gpointer</link> user_data,
60 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
61 <link linkend="GObject">GObject</link> *weak_object);
62
63 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished">*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</link>)
64 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
65 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
66 <link linkend="gpointer">gpointer</link> user_data,
67 <link linkend="GObject">GObject</link> *weak_object);
68 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished">tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished</link>
69 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
70 <link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</link> callback,
71 <link linkend="gpointer">gpointer</link> user_data,
72 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
73 <link linkend="GObject">GObject</link> *weak_object,
74 <link linkend="GError">GError</link> **error);
75 <link linkend="void">void</link> (<link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation">*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</link>)
76 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
77 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
78 <link linkend="GHashTable">GHashTable</link> *arg_Properties,
79 <link linkend="gpointer">gpointer</link> user_data,
80 <link linkend="GObject">GObject</link> *weak_object);
81 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation">tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation</link>
82 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
83 <link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</link> callback,
84 <link linkend="gpointer">gpointer</link> user_data,
85 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
86 <link linkend="GObject">GObject</link> *weak_object,
87 <link linkend="GError">GError</link> **error);
88 </synopsis>
89 </refsynopsisdiv>
90
91 <refsect1 id="telepathy-glib-channel-dispatcher.object-hierarchy" role="object_hierarchy">
92 <title role="object_hierarchy.title">Object Hierarchy</title>
93 <synopsis>
94 <link linkend="GObject">GObject</link>
95 +----<link linkend="TpProxy">TpProxy</link>
96 +----TpChannelDispatcher
97 </synopsis>
98 </refsect1>
99
100
101
102
103
104
105
106
107 <refsect1 id="telepathy-glib-channel-dispatcher.description" role="desc">
108 <title role="desc.title">Description</title>
109 <para>
110 The <link linkend="TpChannelDispatcher"><type>TpChannelDispatcher</type></link> object can be used to communicate with any
111 implementation of the Telepathy ChannelDispatcher service to request
112 new channels.</para>
113 <para>
114 </para>
115 </refsect1>
116
117 <refsect1 id="telepathy-glib-channel-dispatcher.details" role="details">
118 <title role="details.title">Details</title>
119 <refsect2 id="TpChannelDispatcher-struct" role="struct">
120 <title>TpChannelDispatcher</title>
121 <indexterm zone="TpChannelDispatcher-struct" role="0.7.UNRELEASED"><primary sortas="TpChannelDispatcher">TpChannelDispatcher</primary></indexterm><programlisting>typedef struct _TpChannelDispatcher TpChannelDispatcher;</programlisting>
122 <para>
123 The Channel Dispatcher's main D-Bus API is used to request channels,
124 which is done by calling <link linkend="tp-cli-channel-dispatcher-call-create-channel"><function>tp_cli_channel_dispatcher_call_create_channel()</function></link> or
125 <link linkend="tp-cli-channel-dispatcher-call-ensure-channel"><function>tp_cli_channel_dispatcher_call_ensure_channel()</function></link> as appropriate.
126 </para>
127 <para>
128 The Telepathy Channel Dispatcher is also responsible for responding to new
129 channels and launching client processes to handle them. However, clients
130 that can work with incoming channels do not have to call methods
131 on the channel dispatcher: instead, they must register with the channel
132 dispatcher passively, by taking a bus name starting with
133 <link linkend="TP-CLIENT-BUS-NAME-BASE--CAPS"><literal>TP_CLIENT_BUS_NAME_BASE</literal></link> and implementing the <link linkend="TpSvcClient"><type>TpSvcClient</type></link> interface.
134 See the Telepathy D-Bus Interface Specification for details.
135 </para>
136 <para>
137 This proxy is usable but incomplete: convenience methods will be added in
138 a later version of telepathy-glib, along with a mechanism similar to
139 <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.</para>
140 <para>
141 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
142 <refsect2 id="TpChannelDispatcherClass" role="struct">
143 <title>TpChannelDispatcherClass</title>
144 <indexterm zone="TpChannelDispatcherClass"><primary sortas="TpChannelDispatcherClass">TpChannelDispatcherClass</primary></indexterm><programlisting>typedef struct {
145 } TpChannelDispatcherClass;
146 </programlisting>
147 <para>
148 The class of a <link linkend="TpChannelDispatcher"><type>TpChannelDispatcher</type></link>.</para>
149 <para>
150 </para></refsect2>
151 <refsect2 id="tp-channel-dispatcher-new" role="function">
152 <title>tp_channel_dispatcher_new ()</title>
153 <indexterm zone="tp-channel-dispatcher-new"><primary sortas="tp_channel_dispatcher_new">tp_channel_dispatcher_new</primary></indexterm><programlisting><link linkend="TpChannelDispatcher">TpChannelDispatcher</link> * tp_channel_dispatcher_new (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon);</programlisting>
154 <para>
155 Convenience function to create a new channel dispatcher proxy.</para>
156 <para>
157 </para><variablelist role="params">
158 <varlistentry><term><parameter>bus_daemon</parameter>&#160;:</term>
159 <listitem><simpara> Proxy for the D-Bus daemon
160 </simpara></listitem></varlistentry>
161 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new reference to a channel dispatcher proxy
162 </simpara></listitem></varlistentry>
163 </variablelist></refsect2>
164 <refsect2 id="tp-channel-dispatcher-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
165 <title>tp_channel_dispatcher_init_known_interfaces ()</title>
166 <indexterm zone="tp-channel-dispatcher-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_channel_dispatcher_init_known_interfaces">tp_channel_dispatcher_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_channel_dispatcher_init_known_interfaces
167 (void);</programlisting>
168 <para>
169 Ensure that the known interfaces for TpChannelDispatcher have been set up.
170 This is done automatically when necessary, but for correct
171 overriding of library interfaces by local extensions, you should
172 call this function before calling
173 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
174 <link linkend="TP-TYPE-CHANNEL-DISPATCHER--CAPS"><literal>TP_TYPE_CHANNEL_DISPATCHER</literal></link>.</para>
175 <para>
176 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
177 <refsect2 id="tp-cli-channel-dispatcher-callback-for-create-channel" role="function">
178 <title>tp_cli_channel_dispatcher_callback_for_create_channel ()</title>
179 <indexterm zone="tp-cli-channel-dispatcher-callback-for-create-channel"><primary sortas="tp_cli_channel_dispatcher_callback_for_create_channel">tp_cli_channel_dispatcher_callback_for_create_channel</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatcher_callback_for_create_channel)
180 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
181 const <link linkend="gchar">gchar</link> *out_Request,
182 const <link linkend="GError">GError</link> *error,
183 <link linkend="gpointer">gpointer</link> user_data,
184 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
185 <para>
186 Signature of the callback called when a CreateChannel method call
187 succeeds or fails.</para>
188 <para>
189 </para><variablelist role="params">
190 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
191 <listitem><simpara> the proxy on which the call was made
192 </simpara></listitem></varlistentry>
193 <varlistentry><term><parameter>out_Request</parameter>&#160;:</term>
194 <listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: A &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object.
195 </simpara></listitem></varlistentry>
196 <varlistentry><term><parameter>error</parameter>&#160;:</term>
197 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
198 </simpara></listitem></varlistentry>
199 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
200 <listitem><simpara> user-supplied data
201 </simpara></listitem></varlistentry>
202 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
203 <listitem><simpara> user-supplied object
204 </simpara></listitem></varlistentry>
205 </variablelist></refsect2>
206 <refsect2 id="tp-cli-channel-dispatcher-call-create-channel" role="function">
207 <title>tp_cli_channel_dispatcher_call_create_channel ()</title>
208 <indexterm zone="tp-cli-channel-dispatcher-call-create-channel"><primary sortas="tp_cli_channel_dispatcher_call_create_channel">tp_cli_channel_dispatcher_call_create_channel</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_dispatcher_call_create_channel
209 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
210 <link linkend="gint">gint</link> timeout_ms,
211 const <link linkend="gchar">gchar</link> *in_Account,
212 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
213 <link linkend="gint64">gint64</link> in_User_Action_Time,
214 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
215 <link linkend="tp-cli-channel-dispatcher-callback-for-create-channel">tp_cli_channel_dispatcher_callback_for_create_channel</link> callback,
216 <link linkend="gpointer">gpointer</link> user_data,
217 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
218 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
219 <para>
220 Start a CreateChannel method call.
221 </para>
222 <para>
223 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Start a request to create a channel. This initially just creates a &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which can be used to continue the request and track its success or failure.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The request can take a long time - in the worst case, the channel dispatcher has to ask the account manager to put the account online, the account manager has to ask the operating system to obtain an Internet connection, and the operating system has to ask the user whether to activate an Internet connection using an on-demand mechanism like dialup.&lt;/p&gt; &lt;p&gt;This means that using a single D-Bus method call and response to represent the whole request will tend to lead to that call timing out, which is not the behaviour we want.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If this method is called for an Account that is disabled, invalid or otherwise unusable, no error is signalled until &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest.Proceed&lt;/tp:dbus-ref&gt; is called, at which point &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest.Failed&lt;/tp:dbus-ref&gt; is emitted with an appropriate error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This means there&apos;s only one code path for errors, apart from InvalidArgument for &amp;quot;that request makes no sense&amp;quot;.&lt;/p&gt; &lt;p&gt;It also means that the request will proceed if the account is enabled after calling CreateChannel, but before calling Proceed.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
224 <para>
225 </para><variablelist role="params">
226 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
227 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
228 </simpara></listitem></varlistentry>
229 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
230 <listitem><simpara> the timeout in milliseconds, or -1 to use the
231 default
232 </simpara></listitem></varlistentry>
233 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
234 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt; for which the new channel is to be created.
235 </simpara></listitem></varlistentry>
236 <varlistentry><term><parameter>in_Requested_Properties</parameter>&#160;:</term>
237 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;A dictionary containing desirable properties. This has the same semantics as the corresponding parameter to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection.Interface.Requests.CreateChannel&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Certain properties will not necessarily make sense in this dictionary: for instance, &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Channel&quot;&gt;TargetHandle&lt;/tp:dbus-ref&gt; can only be given if the requester is able to interact with a &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection&lt;/tp:dbus-ref&gt; to the desired account.&lt;/p&gt;
238 </simpara></listitem></varlistentry>
239 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
240 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The time at which user action occurred, or 0 if this channel request is for some reason not involving user action. The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelRequest&quot;&gt;UserActionTime&lt;/tp:dbus-ref&gt; property will be set to this value, and it will eventually be passed as the &lt;code&gt;User_Action_Time&lt;/code&gt; parameter of &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt;.&lt;/p&gt;
241 </simpara></listitem></varlistentry>
242 <varlistentry><term><parameter>in_Preferred_Handler</parameter>&#160;:</term>
243 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Either the well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the preferred handler for this channel, or an empty string to indicate that any handler would be acceptable. The channel dispatcher SHOULD dispatch as many as possible of the resulting channels (ideally, all of them) to that handler, and SHOULD remember the preferred handler so it can try to dispatch subsequent channels in the same bundle to the same handler.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This must be the well-known bus name, not the unique name, to ensure that all handlers do indeed have the Client API, and the Client object on the handler can be located easily.&lt;/p&gt; &lt;p&gt;This is partly so the channel dispatcher can call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt; on it, and partly so the channel dispatcher can recover state if it crashes and is restarted.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If this is a well-known bus name and the handler has the Requests interface, the channel dispatcher SHOULD call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Interface.Requests&quot;&gt;AddRequest&lt;/tp:dbus-ref&gt; on that Handler after this method has returned.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This ordering allows a Handler which calls CreateChannel with itself as the preferred handler to associate the call to AddRequest with that call.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This is copied to the ChannelRequest that is returned, as the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelRequest&quot;&gt;PreferredHandler&lt;/tp:dbus-ref&gt; property.&lt;/p&gt;
244 </simpara></listitem></varlistentry>
245 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
246 <listitem><simpara> called when the method call succeeds or fails;
247 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
248 reply tracking
249 </simpara></listitem></varlistentry>
250 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
251 <listitem><simpara> user-supplied data passed to the callback;
252 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
253 </simpara></listitem></varlistentry>
254 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
255 <listitem><simpara> called with the user_data as argument, after the
256 call has succeeded, failed or been cancelled;
257 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
258 </simpara></listitem></varlistentry>
259 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
260 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
261 weakly referenced; if it is destroyed, this call
262 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
263 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
264 </simpara></listitem></varlistentry>
265 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
266 progress. It is borrowed from the object, and will become
267 invalid when the callback is called, the call is
268 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
269 </simpara></listitem></varlistentry>
270 </variablelist></refsect2>
271 <refsect2 id="tp-cli-channel-dispatcher-callback-for-ensure-channel" role="function">
272 <title>tp_cli_channel_dispatcher_callback_for_ensure_channel ()</title>
273 <indexterm zone="tp-cli-channel-dispatcher-callback-for-ensure-channel"><primary sortas="tp_cli_channel_dispatcher_callback_for_ensure_channel">tp_cli_channel_dispatcher_callback_for_ensure_channel</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatcher_callback_for_ensure_channel)
274 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
275 const <link linkend="gchar">gchar</link> *out_Request,
276 const <link linkend="GError">GError</link> *error,
277 <link linkend="gpointer">gpointer</link> user_data,
278 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
279 <para>
280 Signature of the callback called when a EnsureChannel method call
281 succeeds or fails.</para>
282 <para>
283 </para><variablelist role="params">
284 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
285 <listitem><simpara> the proxy on which the call was made
286 </simpara></listitem></varlistentry>
287 <varlistentry><term><parameter>out_Request</parameter>&#160;:</term>
288 <listitem><simpara> Used to return an 'out' argument if <parameter>error</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>: A &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object.
289 </simpara></listitem></varlistentry>
290 <varlistentry><term><parameter>error</parameter>&#160;:</term>
291 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
292 </simpara></listitem></varlistentry>
293 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
294 <listitem><simpara> user-supplied data
295 </simpara></listitem></varlistentry>
296 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
297 <listitem><simpara> user-supplied object
298 </simpara></listitem></varlistentry>
299 </variablelist></refsect2>
300 <refsect2 id="tp-cli-channel-dispatcher-call-ensure-channel" role="function">
301 <title>tp_cli_channel_dispatcher_call_ensure_channel ()</title>
302 <indexterm zone="tp-cli-channel-dispatcher-call-ensure-channel"><primary sortas="tp_cli_channel_dispatcher_call_ensure_channel">tp_cli_channel_dispatcher_call_ensure_channel</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_dispatcher_call_ensure_channel
303 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
304 <link linkend="gint">gint</link> timeout_ms,
305 const <link linkend="gchar">gchar</link> *in_Account,
306 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
307 <link linkend="gint64">gint64</link> in_User_Action_Time,
308 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
309 <link linkend="tp-cli-channel-dispatcher-callback-for-ensure-channel">tp_cli_channel_dispatcher_callback_for_ensure_channel</link> callback,
310 <link linkend="gpointer">gpointer</link> user_data,
311 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
312 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
313 <para>
314 Start a EnsureChannel method call.
315 </para>
316 <para>
317 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Start a request to ensure that a channel exists, creating it if necessary. This initially just creates a &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which can be used to continue the request and track its success or failure.&lt;/p&gt; &lt;p&gt;If this method is called for an Account that is disabled, invalid or otherwise unusable, no error is signalled until &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest.Proceed&lt;/tp:dbus-ref&gt; is called, at which point &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest.Failed&lt;/tp:dbus-ref&gt; is emitted with an appropriate error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The rationale is as for &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatcher&quot;&gt;CreateChannel&lt;/tp:dbus-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
318 <para>
319 </para><variablelist role="params">
320 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
321 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
322 </simpara></listitem></varlistentry>
323 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
324 <listitem><simpara> the timeout in milliseconds, or -1 to use the
325 default
326 </simpara></listitem></varlistentry>
327 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
328 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt; for which the new channel is to be created.
329 </simpara></listitem></varlistentry>
330 <varlistentry><term><parameter>in_Requested_Properties</parameter>&#160;:</term>
331 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;A dictionary containing desirable properties. This has the same semantics as the corresponding parameter to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection.Interface.Requests.EnsureChannel&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Certain properties will not necessarily make sense in this dictionary: for instance, &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Channel&quot;&gt;TargetHandle&lt;/tp:dbus-ref&gt; can only be given if the requester is able to interact with a &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection&lt;/tp:dbus-ref&gt; to the desired account.&lt;/p&gt;
332 </simpara></listitem></varlistentry>
333 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
334 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The time at which user action occurred, or 0 if this channel request is for some reason not involving user action.&lt;/p&gt; &lt;p&gt;This parameter is used in the same way as the corresponding parameter to &lt;tp:member-ref&gt;CreateChannel&lt;/tp:member-ref&gt;.&lt;/p&gt;
335 </simpara></listitem></varlistentry>
336 <varlistentry><term><parameter>in_Preferred_Handler</parameter>&#160;:</term>
337 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Either the well-known bus name (starting with &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the preferred handler for this channel, or an empty string to indicate that any handler would be acceptable. The behaviour and rationale are the same as for the corresponding parameter to &lt;tp:member-ref&gt;CreateChannel&lt;/tp:member-ref&gt;, except as noted here.&lt;/p&gt; &lt;p&gt;If any new channels are created in response to this request, the channel dispatcher SHOULD dispatch as many as possible of the resulting channels (ideally, all of them) to that handler, and SHOULD remember the preferred handler so it can try to dispatch subsequent channels in the same bundle to the same handler. If the requested channel already exists (that is, &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection.Interface.Requests.EnsureChannel&lt;/tp:dbus-ref&gt; returns &lt;code&gt;Yours=False&lt;/code&gt;) then the channel dispatcher SHOULD re-dispatch the channel to its existing handler, and MUST NOT dispatch it to this client (unless it is the existing handler); the request is still deemed to have succeeded in this case.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;An address book application, for example, might call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatcher&quot;&gt;EnsureChannel&lt;/tp:dbus-ref&gt; to ensure that a text channel with a particular contact is displayed to the user; it does not care whether a new channel was made. An IM client might call &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatcher&quot;&gt;EnsureChannel&lt;/tp:dbus-ref&gt; in response to the user double-clicking an entry in the contact list, with itself as the &lt;code&gt;Preferred_Handler&lt;/code&gt;; if the user already has a conversation with that contact in another application, they would expect the existing window to be presented, rather than their double-click leading to an error message. So the request should succeed, even if its &lt;code&gt;Preferred_Handler&lt;/code&gt; is not used.&lt;/p&gt; &lt;/tp:rationale&gt;
338 </simpara></listitem></varlistentry>
339 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
340 <listitem><simpara> called when the method call succeeds or fails;
341 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
342 reply tracking
343 </simpara></listitem></varlistentry>
344 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
345 <listitem><simpara> user-supplied data passed to the callback;
346 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
347 </simpara></listitem></varlistentry>
348 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
349 <listitem><simpara> called with the user_data as argument, after the
350 call has succeeded, failed or been cancelled;
351 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
352 </simpara></listitem></varlistentry>
353 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
354 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
355 weakly referenced; if it is destroyed, this call
356 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
357 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
358 </simpara></listitem></varlistentry>
359 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
360 progress. It is borrowed from the object, and will become
361 invalid when the callback is called, the call is
362 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
363 </simpara></listitem></varlistentry>
364 </variablelist></refsect2>
365 <refsect2 id="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished" role="function">
366 <title>tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished ()</title>
367 <indexterm zone="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished"><primary sortas="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished)
368 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
369 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
370 <link linkend="gpointer">gpointer</link> user_data,
371 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
372 <para>
373 Represents the signature of a callback for the signal DispatchOperationFinished.</para>
374 <para>
375 </para><variablelist role="params">
376 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
377 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"><function>tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished()</function></link>
378 was called
379 </simpara></listitem></varlistentry>
380 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
381 <listitem><simpara> The dispatch operation that was closed.
382 </simpara></listitem></varlistentry>
383 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
384 <listitem><simpara> User-supplied data
385 </simpara></listitem></varlistentry>
386 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
387 <listitem><simpara> User-supplied weakly referenced object
388 </simpara></listitem></varlistentry>
389 </variablelist></refsect2>
390 <refsect2 id="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished" role="function">
391 <title>tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished ()</title>
392 <indexterm zone="tp-cli-channel-dispatcher-interface-operation-list-connect-to-dispatch-operation-finished"><primary sortas="tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished">tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished
393 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
394 <link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-dispatch-operation-finished">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_dispatch_operation_finished</link> callback,
395 <link linkend="gpointer">gpointer</link> user_data,
396 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
397 <link linkend="GObject">GObject</link> *weak_object,
398 <link linkend="GError">GError</link> **error);</programlisting>
399 <para>
400 Connect a handler to the signal DispatchOperationFinished.
401 </para>
402 <para>
403 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; Emitted when a dispatch operation finishes (i.e. exactly once per emission of &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation.Finished&lt;/tp:dbus-ref&gt;). &lt;tp:rationale&gt; Strictly speaking this is redundant with ChannelDispatchOperation.Finished, but it provides full change-notification for the &lt;tp:member-ref&gt;DispatchOperations&lt;/tp:member-ref&gt; property. &lt;/tp:rationale&gt;</para>
404 <para>
405 </para><variablelist role="params">
406 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
407 <listitem><simpara> A <link linkend="TpChannelDispatcher"><type>TpChannelDispatcher</type></link> or subclass
408 </simpara></listitem></varlistentry>
409 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
410 <listitem><simpara> Callback to be called when the signal is
411 received
412 </simpara></listitem></varlistentry>
413 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
414 <listitem><simpara> User-supplied data for the callback
415 </simpara></listitem></varlistentry>
416 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
417 <listitem><simpara> Destructor for the user-supplied data, which
418 will be called when this signal is disconnected, or
419 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
420 </simpara></listitem></varlistentry>
421 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
422 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
423 if it is destroyed, this callback will automatically be
424 disconnected
425 </simpara></listitem></varlistentry>
426 <varlistentry><term><parameter>error</parameter>&#160;:</term>
427 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
428 returned
429 </simpara></listitem></varlistentry>
430 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
431 above, which can be used to disconnect the signal; or
432 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
433 or has become invalid.
434 </simpara></listitem></varlistentry>
435 </variablelist></refsect2>
436 <refsect2 id="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation" role="function">
437 <title>tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation ()</title>
438 <indexterm zone="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation"><primary sortas="tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation)
439 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
440 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
441 <link linkend="GHashTable">GHashTable</link> *arg_Properties,
442 <link linkend="gpointer">gpointer</link> user_data,
443 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
444 <para>
445 Represents the signature of a callback for the signal NewDispatchOperation.</para>
446 <para>
447 </para><variablelist role="params">
448 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
449 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"><function>tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation()</function></link>
450 was called
451 </simpara></listitem></varlistentry>
452 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
453 <listitem><simpara> The dispatch operation that was created.
454 </simpara></listitem></varlistentry>
455 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
456 <listitem><simpara> The same properties that would appear in the Properties member of &lt;tp:type-ref&gt;Dispatch_Operation_Details&lt;/tp:type-ref&gt;.
457 </simpara></listitem></varlistentry>
458 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
459 <listitem><simpara> User-supplied data
460 </simpara></listitem></varlistentry>
461 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
462 <listitem><simpara> User-supplied weakly referenced object
463 </simpara></listitem></varlistentry>
464 </variablelist></refsect2>
465 <refsect2 id="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation" role="function">
466 <title>tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation ()</title>
467 <indexterm zone="tp-cli-channel-dispatcher-interface-operation-list-connect-to-new-dispatch-operation"><primary sortas="tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation">tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation
468 (<link linkend="TpChannelDispatcher">TpChannelDispatcher</link> *proxy,
469 <link linkend="tp-cli-channel-dispatcher-interface-operation-list-signal-callback-new-dispatch-operation">tp_cli_channel_dispatcher_interface_operation_list_signal_callback_new_dispatch_operation</link> callback,
470 <link linkend="gpointer">gpointer</link> user_data,
471 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
472 <link linkend="GObject">GObject</link> *weak_object,
473 <link linkend="GError">GError</link> **error);</programlisting>
474 <para>
475 Connect a handler to the signal NewDispatchOperation.
476 </para>
477 <para>
478 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Emitted when a dispatch operation is added to &lt;tp:member-ref&gt;DispatchOperations&lt;/tp:member-ref&gt;.&lt;/p&gt;</para>
479 <para>
480 </para><variablelist role="params">
481 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
482 <listitem><simpara> A <link linkend="TpChannelDispatcher"><type>TpChannelDispatcher</type></link> or subclass
483 </simpara></listitem></varlistentry>
484 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
485 <listitem><simpara> Callback to be called when the signal is
486 received
487 </simpara></listitem></varlistentry>
488 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
489 <listitem><simpara> User-supplied data for the callback
490 </simpara></listitem></varlistentry>
491 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
492 <listitem><simpara> Destructor for the user-supplied data, which
493 will be called when this signal is disconnected, or
494 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
495 </simpara></listitem></varlistentry>
496 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
497 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
498 if it is destroyed, this callback will automatically be
499 disconnected
500 </simpara></listitem></varlistentry>
501 <varlistentry><term><parameter>error</parameter>&#160;:</term>
502 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
503 returned
504 </simpara></listitem></varlistentry>
505 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
506 above, which can be used to disconnect the signal; or
507 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
508 or has become invalid.
509 </simpara></listitem></varlistentry>
510 </variablelist></refsect2>
511
512 </refsect1>
513
514
515
516 <refsect1 id="telepathy-glib-channel-dispatcher.see-also">
517 <title>See Also</title>
518 #TpChannelDispatchOperation, <link linkend="TpChannelRequest"><type>TpChannelRequest</type></link>
519 </refsect1>
520
521 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-channel-request">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-channel-request.top_of_page">TpChannelRequest</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpChannelRequest</refname>
12 <refpurpose>proxy object for a request to the Telepathy channel
13 dispatcher</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv id="telepathy-glib-channel-request.synopsis" role="synopsis">
17 <title role="synopsis.title">Synopsis</title>
18 <anchor id="TpChannelRequest"/>
19 <synopsis>
20
21 #include &lt;telepathy-glib/channel-request.h&gt;
22
23 <link linkend="TpChannelRequest-struct">TpChannelRequest</link>;
24 <link linkend="TpChannelRequestClass">TpChannelRequestClass</link>;
25 <link linkend="TpChannelRequest">TpChannelRequest</link> * <link linkend="tp-channel-request-new">tp_channel_request_new</link> (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
26 const <link linkend="gchar">gchar</link> *object_path,
27 <link linkend="GHashTable">GHashTable</link> *immutable_properties,
28 <link linkend="GError">GError</link> **error);
29 <link linkend="void">void</link> <link linkend="tp-channel-request-init-known-interfaces">tp_channel_request_init_known_interfaces</link>
30 (void);
31
32 <link linkend="void">void</link> (<link linkend="tp-cli-channel-request-callback-for-cancel">*tp_cli_channel_request_callback_for_cancel</link>)
33 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
34 const <link linkend="GError">GError</link> *error,
35 <link linkend="gpointer">gpointer</link> user_data,
36 <link linkend="GObject">GObject</link> *weak_object);
37 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-request-call-cancel">tp_cli_channel_request_call_cancel</link> (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
38 <link linkend="gint">gint</link> timeout_ms,
39 <link linkend="tp-cli-channel-request-callback-for-cancel">tp_cli_channel_request_callback_for_cancel</link> callback,
40 <link linkend="gpointer">gpointer</link> user_data,
41 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
42 <link linkend="GObject">GObject</link> *weak_object);
43 <link linkend="void">void</link> (<link linkend="tp-cli-channel-request-callback-for-proceed">*tp_cli_channel_request_callback_for_proceed</link>)
44 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
45 const <link linkend="GError">GError</link> *error,
46 <link linkend="gpointer">gpointer</link> user_data,
47 <link linkend="GObject">GObject</link> *weak_object);
48 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-channel-request-call-proceed">tp_cli_channel_request_call_proceed</link>
49 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
50 <link linkend="gint">gint</link> timeout_ms,
51 <link linkend="tp-cli-channel-request-callback-for-proceed">tp_cli_channel_request_callback_for_proceed</link> callback,
52 <link linkend="gpointer">gpointer</link> user_data,
53 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
54 <link linkend="GObject">GObject</link> *weak_object);
55 <link linkend="void">void</link> (<link linkend="tp-cli-channel-request-signal-callback-failed">*tp_cli_channel_request_signal_callback_failed</link>)
56 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
57 const <link linkend="gchar">gchar</link> *arg_Error,
58 const <link linkend="gchar">gchar</link> *arg_Message,
59 <link linkend="gpointer">gpointer</link> user_data,
60 <link linkend="GObject">GObject</link> *weak_object);
61 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-request-connect-to-failed">tp_cli_channel_request_connect_to_failed</link>
62 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
63 <link linkend="tp-cli-channel-request-signal-callback-failed">tp_cli_channel_request_signal_callback_failed</link> callback,
64 <link linkend="gpointer">gpointer</link> user_data,
65 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
66 <link linkend="GObject">GObject</link> *weak_object,
67 <link linkend="GError">GError</link> **error);
68 <link linkend="void">void</link> (<link linkend="tp-cli-channel-request-signal-callback-succeeded">*tp_cli_channel_request_signal_callback_succeeded</link>)
69 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
70 <link linkend="gpointer">gpointer</link> user_data,
71 <link linkend="GObject">GObject</link> *weak_object);
72 <link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * <link linkend="tp-cli-channel-request-connect-to-succeeded">tp_cli_channel_request_connect_to_succeeded</link>
73 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
74 <link linkend="tp-cli-channel-request-signal-callback-succeeded">tp_cli_channel_request_signal_callback_succeeded</link> callback,
75 <link linkend="gpointer">gpointer</link> user_data,
76 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
77 <link linkend="GObject">GObject</link> *weak_object,
78 <link linkend="GError">GError</link> **error);
79 </synopsis>
80 </refsynopsisdiv>
81
82 <refsect1 id="telepathy-glib-channel-request.object-hierarchy" role="object_hierarchy">
83 <title role="object_hierarchy.title">Object Hierarchy</title>
84 <synopsis>
85 <link linkend="GObject">GObject</link>
86 +----<link linkend="TpProxy">TpProxy</link>
87 +----TpChannelRequest
88 </synopsis>
89 </refsect1>
90
91
92
93
94
95
96 <refsect1 id="telepathy-glib-channel-request.signals" role="signal_proto">
97 <title role="signal_proto.title">Signals</title>
98 <synopsis>
99 &quot;<link linkend="TpChannelRequest-succeeded">succeeded</link>&quot; : Run Last / Has Details
100 </synopsis>
101 </refsect1>
102
103
104 <refsect1 id="telepathy-glib-channel-request.description" role="desc">
105 <title role="desc.title">Description</title>
106 <para>
107 Requesting a channel from the channel dispatcher can take some time, so an
108 object is created in the channel dispatcher to represent each request.
109 Objects of the <link linkend="TpChannelRequest"><type>TpChannelRequest</type></link> class provide access to one of those
110 objects.</para>
111 <para>
112 </para>
113 </refsect1>
114
115 <refsect1 id="telepathy-glib-channel-request.details" role="details">
116 <title role="details.title">Details</title>
117 <refsect2 id="TpChannelRequest-struct" role="struct">
118 <title>TpChannelRequest</title>
119 <indexterm zone="TpChannelRequest-struct" role="0.7.UNRELEASED"><primary sortas="TpChannelRequest">TpChannelRequest</primary></indexterm><programlisting>typedef struct _TpChannelRequest TpChannelRequest;</programlisting>
120 <para>
121 Requesting a channel from the channel dispatcher can take some time, so an
122 object is created in the channel dispatcher to represent each request. This
123 proxy represents one of those objects.
124 </para>
125 <para>
126 Any client can call <link linkend="tp-cli-channel-request-call-cancel"><function>tp_cli_channel_request_call_cancel()</function></link> at any time to
127 attempt to cancel the request.
128 </para>
129 <para>
130 On success, the <link linkend="TpChannelRequest-succeeded"><type>"succeeded"</type></link> signal will be emitted.
131 Immediately after that, the <link linkend="TpProxy-invalidated"><type>"invalidated"</type></link> signal will be emitted,
132 with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
133 <link linkend="TP-DBUS-ERROR-OBJECT-REMOVED--CAPS"><literal>TP_DBUS_ERROR_OBJECT_REMOVED</literal></link> (this is not an error condition, it merely
134 indicates that the channel request no longer exists).
135 </para>
136 <para>
137 On failure, the <link linkend="TpProxy-invalidated"><type>"invalidated"</type></link> signal will be emitted with some
138 other suitable error, usually from the <link linkend="TP-ERRORS--CAPS"><literal>TP_ERRORS</literal></link> domain.
139 </para>
140 <para>
141 If the channel dispatcher crashes or exits, the <link linkend="TpProxy-invalidated"><type>"invalidated"</type></link>
142 signal will be emitted with the domain <link linkend="TP-DBUS-ERRORS--CAPS"><literal>TP_DBUS_ERRORS</literal></link> and the error code
143 <link linkend="TP-DBUS-ERROR-NAME-OWNER-LOST--CAPS"><literal>TP_DBUS_ERROR_NAME_OWNER_LOST</literal></link>.
144 </para>
145 <para>
146 This proxy is usable but incomplete: accessors for the Account,
147 UserActionTime, PreferredHandler, Requests and Interfaces properties will
148 be added in a later version of telepathy-glib, along with a mechanism
149 similar to <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.
150 </para>
151 <para>
152 Until suitable convenience methods are implemented, the generic
153 <link linkend="tp-cli-dbus-properties-call-get-all"><function>tp_cli_dbus_properties_call_get_all()</function></link> method can be used to get those
154 properties.</para>
155 <para>
156 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
157 <refsect2 id="TpChannelRequestClass" role="struct">
158 <title>TpChannelRequestClass</title>
159 <indexterm zone="TpChannelRequestClass"><primary sortas="TpChannelRequestClass">TpChannelRequestClass</primary></indexterm><programlisting>typedef struct {
160 } TpChannelRequestClass;
161 </programlisting>
162 <para>
163 The class of a <link linkend="TpChannelRequest"><type>TpChannelRequest</type></link>.</para>
164 <para>
165 </para></refsect2>
166 <refsect2 id="tp-channel-request-new" role="function">
167 <title>tp_channel_request_new ()</title>
168 <indexterm zone="tp-channel-request-new"><primary sortas="tp_channel_request_new">tp_channel_request_new</primary></indexterm><programlisting><link linkend="TpChannelRequest">TpChannelRequest</link> * tp_channel_request_new (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *bus_daemon,
169 const <link linkend="gchar">gchar</link> *object_path,
170 <link linkend="GHashTable">GHashTable</link> *immutable_properties,
171 <link linkend="GError">GError</link> **error);</programlisting>
172 <para>
173 Convenience function to create a new channel request proxy.
174 </para>
175 <para>
176 If the channel request was newly created, the client making the request
177 is responsible for calling <link linkend="tp-cli-channel-request-call-proceed"><function>tp_cli_channel_request_call_proceed()</function></link> when it
178 is ready for the channel request to proceed.
179 </para>
180 <para>
181 The <parameter>immutable_properties</parameter> argument is not yet used.</para>
182 <para>
183 </para><variablelist role="params">
184 <varlistentry><term><parameter>bus_daemon</parameter>&#160;:</term>
185 <listitem><simpara> Proxy for the D-Bus daemon
186 </simpara></listitem></varlistentry>
187 <varlistentry><term><parameter>object_path</parameter>&#160;:</term>
188 <listitem><simpara> The non-NULL object path of this channel request
189 </simpara></listitem></varlistentry>
190 <varlistentry><term><parameter>immutable_properties</parameter>&#160;:</term>
191 <listitem><simpara> As many as are known of the immutable D-Bus
192 properties of this channel request, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if none are known
193 </simpara></listitem></varlistentry>
194 <varlistentry><term><parameter>error</parameter>&#160;:</term>
195 <listitem><simpara> Used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is returned
196 </simpara></listitem></varlistentry>
197 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new reference to an channel request proxy, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
198 <parameter>object_path</parameter> is not syntactically valid or the channel dispatcher is
199 not running
200 </simpara></listitem></varlistentry>
201 </variablelist></refsect2>
202 <refsect2 id="tp-channel-request-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
203 <title>tp_channel_request_init_known_interfaces ()</title>
204 <indexterm zone="tp-channel-request-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_channel_request_init_known_interfaces">tp_channel_request_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_channel_request_init_known_interfaces
205 (void);</programlisting>
206 <para>
207 Ensure that the known interfaces for TpChannelRequest have been set up.
208 This is done automatically when necessary, but for correct
209 overriding of library interfaces by local extensions, you should
210 call this function before calling
211 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
212 <link linkend="TP-TYPE-CHANNEL-REQUEST--CAPS"><literal>TP_TYPE_CHANNEL_REQUEST</literal></link>.</para>
213 <para>
214 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
215 <refsect2 id="tp-cli-channel-request-callback-for-cancel" role="function">
216 <title>tp_cli_channel_request_callback_for_cancel ()</title>
217 <indexterm zone="tp-cli-channel-request-callback-for-cancel"><primary sortas="tp_cli_channel_request_callback_for_cancel">tp_cli_channel_request_callback_for_cancel</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_request_callback_for_cancel)
218 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
219 const <link linkend="GError">GError</link> *error,
220 <link linkend="gpointer">gpointer</link> user_data,
221 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
222 <para>
223 Signature of the callback called when a Cancel method call
224 succeeds or fails.</para>
225 <para>
226 </para><variablelist role="params">
227 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
228 <listitem><simpara> the proxy on which the call was made
229 </simpara></listitem></varlistentry>
230 <varlistentry><term><parameter>error</parameter>&#160;:</term>
231 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
232 </simpara></listitem></varlistentry>
233 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
234 <listitem><simpara> user-supplied data
235 </simpara></listitem></varlistentry>
236 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
237 <listitem><simpara> user-supplied object
238 </simpara></listitem></varlistentry>
239 </variablelist></refsect2>
240 <refsect2 id="tp-cli-channel-request-call-cancel" role="function">
241 <title>tp_cli_channel_request_call_cancel ()</title>
242 <indexterm zone="tp-cli-channel-request-call-cancel"><primary sortas="tp_cli_channel_request_call_cancel">tp_cli_channel_request_call_cancel</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_request_call_cancel (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
243 <link linkend="gint">gint</link> timeout_ms,
244 <link linkend="tp-cli-channel-request-callback-for-cancel">tp_cli_channel_request_callback_for_cancel</link> callback,
245 <link linkend="gpointer">gpointer</link> user_data,
246 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
247 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
248 <para>
249 Start a Cancel method call.
250 </para>
251 <para>
252 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Cancel the channel request. The precise effect depends on the current progress of the request.&lt;/p&gt; &lt;p&gt;If the connection manager has not already been asked to create a channel, then &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; is emitted immediately, and the channel request is removed.&lt;/p&gt; &lt;p&gt;If the connection manager has already been asked to create a channel but has not produced one yet (e.g. if &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection.Interface.Requests.CreateChannel&lt;/tp:dbus-ref&gt; has been called, but has not yet returned), then the ChannelDispatcher will remember that the request has been cancelled. When the channel appears, it will be closed (if it was newly created and can be closed), and will not be dispatched to a handler.&lt;/p&gt; &lt;p&gt;If the connection manager has already returned a channel, but the channel has not yet been dispatched to a handler then the channel dispatcher will not dispatch that channel to a handler. If the channel was newly created for this request, the channel dispatcher will close it with &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Channel&quot;&gt;Close&lt;/tp:dbus-ref&gt;; otherwise, the channel dispatcher will ignore it. In either case, &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; will be emitted when processing has been completed.&lt;/p&gt; &lt;p&gt;If &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; is emitted in response to this method, the error SHOULD be &lt;code&gt;org.freedesktop.Telepathy.Error.Cancelled&lt;/code&gt;.&lt;/p&gt; &lt;p&gt;If the channel has already been dispatched to a handler, then it&apos;s too late to call this method, and the channel request will no longer exist.&lt;/p&gt;</para>
253 <para>
254 </para><variablelist role="params">
255 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
256 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
257 </simpara></listitem></varlistentry>
258 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
259 <listitem><simpara> the timeout in milliseconds, or -1 to use the
260 default
261 </simpara></listitem></varlistentry>
262 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
263 <listitem><simpara> called when the method call succeeds or fails;
264 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
265 reply tracking
266 </simpara></listitem></varlistentry>
267 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
268 <listitem><simpara> user-supplied data passed to the callback;
269 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
270 </simpara></listitem></varlistentry>
271 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
272 <listitem><simpara> called with the user_data as argument, after the
273 call has succeeded, failed or been cancelled;
274 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
275 </simpara></listitem></varlistentry>
276 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
277 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
278 weakly referenced; if it is destroyed, this call
279 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
280 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
281 </simpara></listitem></varlistentry>
282 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
283 progress. It is borrowed from the object, and will become
284 invalid when the callback is called, the call is
285 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
286 </simpara></listitem></varlistentry>
287 </variablelist></refsect2>
288 <refsect2 id="tp-cli-channel-request-callback-for-proceed" role="function">
289 <title>tp_cli_channel_request_callback_for_proceed ()</title>
290 <indexterm zone="tp-cli-channel-request-callback-for-proceed"><primary sortas="tp_cli_channel_request_callback_for_proceed">tp_cli_channel_request_callback_for_proceed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_request_callback_for_proceed)
291 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
292 const <link linkend="GError">GError</link> *error,
293 <link linkend="gpointer">gpointer</link> user_data,
294 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
295 <para>
296 Signature of the callback called when a Proceed method call
297 succeeds or fails.</para>
298 <para>
299 </para><variablelist role="params">
300 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
301 <listitem><simpara> the proxy on which the call was made
302 </simpara></listitem></varlistentry>
303 <varlistentry><term><parameter>error</parameter>&#160;:</term>
304 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
305 </simpara></listitem></varlistentry>
306 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
307 <listitem><simpara> user-supplied data
308 </simpara></listitem></varlistentry>
309 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
310 <listitem><simpara> user-supplied object
311 </simpara></listitem></varlistentry>
312 </variablelist></refsect2>
313 <refsect2 id="tp-cli-channel-request-call-proceed" role="function">
314 <title>tp_cli_channel_request_call_proceed ()</title>
315 <indexterm zone="tp-cli-channel-request-call-proceed"><primary sortas="tp_cli_channel_request_call_proceed">tp_cli_channel_request_call_proceed</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_channel_request_call_proceed
316 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
317 <link linkend="gint">gint</link> timeout_ms,
318 <link linkend="tp-cli-channel-request-callback-for-proceed">tp_cli_channel_request_callback_for_proceed</link> callback,
319 <link linkend="gpointer">gpointer</link> user_data,
320 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
321 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
322 <para>
323 Start a Proceed method call.
324 </para>
325 <para>
326 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Proceed with the channel request.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The client that created this object calls this method when it has connected signal handlers for &lt;tp:member-ref&gt;Succeeded&lt;/tp:member-ref&gt; and &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Clients other than the client which created the ChannelRequest MUST NOT call this method.&lt;/p&gt; &lt;p&gt;This method SHOULD return immediately; on success, the request might still fail, but this will be indicated asynchronously by the &lt;tp:member-ref&gt;Failed&lt;/tp:member-ref&gt; signal.&lt;/p&gt; &lt;p&gt;Proceed cannot fail, unless clients have got the life-cycle of a ChannelRequest seriously wrong (e.g. a client calls this method twice, or a client that did not create the ChannelRequest calls this method). If it fails, clients SHOULD assume that the whole ChannelRequest has become useless.&lt;/p&gt;</para>
327 <para>
328 </para><variablelist role="params">
329 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
330 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
331 </simpara></listitem></varlistentry>
332 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
333 <listitem><simpara> the timeout in milliseconds, or -1 to use the
334 default
335 </simpara></listitem></varlistentry>
336 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
337 <listitem><simpara> called when the method call succeeds or fails;
338 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
339 reply tracking
340 </simpara></listitem></varlistentry>
341 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
342 <listitem><simpara> user-supplied data passed to the callback;
343 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
344 </simpara></listitem></varlistentry>
345 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
346 <listitem><simpara> called with the user_data as argument, after the
347 call has succeeded, failed or been cancelled;
348 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
349 </simpara></listitem></varlistentry>
350 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
351 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
352 weakly referenced; if it is destroyed, this call
353 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
354 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
355 </simpara></listitem></varlistentry>
356 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
357 progress. It is borrowed from the object, and will become
358 invalid when the callback is called, the call is
359 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
360 </simpara></listitem></varlistentry>
361 </variablelist></refsect2>
362 <refsect2 id="tp-cli-channel-request-signal-callback-failed" role="function">
363 <title>tp_cli_channel_request_signal_callback_failed ()</title>
364 <indexterm zone="tp-cli-channel-request-signal-callback-failed"><primary sortas="tp_cli_channel_request_signal_callback_failed">tp_cli_channel_request_signal_callback_failed</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_request_signal_callback_failed)
365 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
366 const <link linkend="gchar">gchar</link> *arg_Error,
367 const <link linkend="gchar">gchar</link> *arg_Message,
368 <link linkend="gpointer">gpointer</link> user_data,
369 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
370 <para>
371 Represents the signature of a callback for the signal Failed.</para>
372 <para>
373 </para><variablelist role="params">
374 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
375 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-request-connect-to-failed"><function>tp_cli_channel_request_connect_to_failed()</function></link>
376 was called
377 </simpara></listitem></varlistentry>
378 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
379 <listitem><simpara> &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The name of a D-Bus error. This can come from various sources, including the error raised by &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Connection.Interface.Requests&quot;&gt;CreateChannel&lt;/tp:dbus-ref&gt;, or an error generated to represent failure to establish the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection&lt;/tp:dbus-ref&gt;.&lt;/p&gt;
380 </simpara></listitem></varlistentry>
381 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
382 <listitem><simpara> If the first argument of the D-Bus error message was a string, that string. Otherwise, an empty string.
383 </simpara></listitem></varlistentry>
384 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
385 <listitem><simpara> User-supplied data
386 </simpara></listitem></varlistentry>
387 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
388 <listitem><simpara> User-supplied weakly referenced object
389 </simpara></listitem></varlistentry>
390 </variablelist></refsect2>
391 <refsect2 id="tp-cli-channel-request-connect-to-failed" role="function">
392 <title>tp_cli_channel_request_connect_to_failed ()</title>
393 <indexterm zone="tp-cli-channel-request-connect-to-failed"><primary sortas="tp_cli_channel_request_connect_to_failed">tp_cli_channel_request_connect_to_failed</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_request_connect_to_failed
394 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
395 <link linkend="tp-cli-channel-request-signal-callback-failed">tp_cli_channel_request_signal_callback_failed</link> callback,
396 <link linkend="gpointer">gpointer</link> user_data,
397 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
398 <link linkend="GObject">GObject</link> *weak_object,
399 <link linkend="GError">GError</link> **error);</programlisting>
400 <para>
401 Connect a handler to the signal Failed.
402 </para>
403 <para>
404 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The channel request has failed. It is no longer present, and further methods must not be called on it.&lt;/p&gt;</para>
405 <para>
406 </para><variablelist role="params">
407 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
408 <listitem><simpara> A <link linkend="TpChannelRequest"><type>TpChannelRequest</type></link> or subclass
409 </simpara></listitem></varlistentry>
410 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
411 <listitem><simpara> Callback to be called when the signal is
412 received
413 </simpara></listitem></varlistentry>
414 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
415 <listitem><simpara> User-supplied data for the callback
416 </simpara></listitem></varlistentry>
417 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
418 <listitem><simpara> Destructor for the user-supplied data, which
419 will be called when this signal is disconnected, or
420 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
421 </simpara></listitem></varlistentry>
422 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
423 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
424 if it is destroyed, this callback will automatically be
425 disconnected
426 </simpara></listitem></varlistentry>
427 <varlistentry><term><parameter>error</parameter>&#160;:</term>
428 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
429 returned
430 </simpara></listitem></varlistentry>
431 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
432 above, which can be used to disconnect the signal; or
433 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
434 or has become invalid.
435 </simpara></listitem></varlistentry>
436 </variablelist></refsect2>
437 <refsect2 id="tp-cli-channel-request-signal-callback-succeeded" role="function">
438 <title>tp_cli_channel_request_signal_callback_succeeded ()</title>
439 <indexterm zone="tp-cli-channel-request-signal-callback-succeeded"><primary sortas="tp_cli_channel_request_signal_callback_succeeded">tp_cli_channel_request_signal_callback_succeeded</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_channel_request_signal_callback_succeeded)
440 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
441 <link linkend="gpointer">gpointer</link> user_data,
442 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
443 <para>
444 Represents the signature of a callback for the signal Succeeded.</para>
445 <para>
446 </para><variablelist role="params">
447 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
448 <listitem><simpara> The proxy on which <link linkend="tp-cli-channel-request-connect-to-succeeded"><function>tp_cli_channel_request_connect_to_succeeded()</function></link>
449 was called
450 </simpara></listitem></varlistentry>
451 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
452 <listitem><simpara> User-supplied data
453 </simpara></listitem></varlistentry>
454 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
455 <listitem><simpara> User-supplied weakly referenced object
456 </simpara></listitem></varlistentry>
457 </variablelist></refsect2>
458 <refsect2 id="tp-cli-channel-request-connect-to-succeeded" role="function">
459 <title>tp_cli_channel_request_connect_to_succeeded ()</title>
460 <indexterm zone="tp-cli-channel-request-connect-to-succeeded"><primary sortas="tp_cli_channel_request_connect_to_succeeded">tp_cli_channel_request_connect_to_succeeded</primary></indexterm><programlisting><link linkend="TpProxySignalConnection">TpProxySignalConnection</link> * tp_cli_channel_request_connect_to_succeeded
461 (<link linkend="TpChannelRequest">TpChannelRequest</link> *proxy,
462 <link linkend="tp-cli-channel-request-signal-callback-succeeded">tp_cli_channel_request_signal_callback_succeeded</link> callback,
463 <link linkend="gpointer">gpointer</link> user_data,
464 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
465 <link linkend="GObject">GObject</link> *weak_object,
466 <link linkend="GError">GError</link> **error);</programlisting>
467 <para>
468 Connect a handler to the signal Succeeded.
469 </para>
470 <para>
471 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The channel request has succeeded. It is no longer present, and further methods must not be called on it.&lt;/p&gt;</para>
472 <para>
473 </para><variablelist role="params">
474 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
475 <listitem><simpara> A <link linkend="TpChannelRequest"><type>TpChannelRequest</type></link> or subclass
476 </simpara></listitem></varlistentry>
477 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
478 <listitem><simpara> Callback to be called when the signal is
479 received
480 </simpara></listitem></varlistentry>
481 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
482 <listitem><simpara> User-supplied data for the callback
483 </simpara></listitem></varlistentry>
484 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
485 <listitem><simpara> Destructor for the user-supplied data, which
486 will be called when this signal is disconnected, or
487 before this function returns <link linkend="NULL--CAPS"><literal>NULL</literal></link>
488 </simpara></listitem></varlistentry>
489 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
490 <listitem><simpara> A <link linkend="GObject"><type>GObject</type></link> which will be weakly referenced;
491 if it is destroyed, this callback will automatically be
492 disconnected
493 </simpara></listitem></varlistentry>
494 <varlistentry><term><parameter>error</parameter>&#160;:</term>
495 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, used to raise an error if <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
496 returned
497 </simpara></listitem></varlistentry>
498 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxySignalConnection"><type>TpProxySignalConnection</type></link> containing all of the
499 above, which can be used to disconnect the signal; or
500 <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the proxy does not have the desired interface
501 or has become invalid.
502 </simpara></listitem></varlistentry>
503 </variablelist></refsect2>
504
505 </refsect1>
506
507 <refsect1 id="telepathy-glib-channel-request.signal-details" role="signals">
508 <title role="signals.title">Signal Details</title>
509 <refsect2 id="TpChannelRequest-succeeded" role="signal"><title>The <literal>&quot;succeeded&quot;</literal> signal</title>
510 <indexterm zone="TpChannelRequest-succeeded"><primary sortas="TpChannelRequest::succeeded">TpChannelRequest::succeeded</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpChannelRequest">TpChannelRequest</link> *self,
511 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
512 <para>
513 Emitted when the channel request succeeds.</para>
514 <para>
515 </para><variablelist role="params">
516 <varlistentry><term><parameter>self</parameter>&#160;:</term>
517 <listitem><simpara> the channel request proxy
518 </simpara></listitem></varlistentry>
519 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
520 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
521 </variablelist></refsect2>
522 </refsect1>
523
524
525 <refsect1 id="telepathy-glib-channel-request.see-also">
526 <title>See Also</title>
527 #TpChannelDispatcher
528 </refsect1>
529
530 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-client">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-client.top_of_page">TpClient</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>TpClient</refname>
12 <refpurpose>proxy object for a client of the ChannelDispatcher</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-client.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpClient"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/client.h&gt;
21
22 <link linkend="TpClient-struct">TpClient</link>;
23 <link linkend="TpClientClass">TpClientClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-client-init-known-interfaces">tp_client_init_known_interfaces</link> (void);
25
26 <link linkend="void">void</link> (<link linkend="tp-cli-client-observer-callback-for-observe-channels">*tp_cli_client_observer_callback_for_observe_channels</link>)
27 (<link linkend="TpClient">TpClient</link> *proxy,
28 const <link linkend="GError">GError</link> *error,
29 <link linkend="gpointer">gpointer</link> user_data,
30 <link linkend="GObject">GObject</link> *weak_object);
31 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-client-observer-call-observe-channels">tp_cli_client_observer_call_observe_channels</link>
32 (<link linkend="TpClient">TpClient</link> *proxy,
33 <link linkend="gint">gint</link> timeout_ms,
34 const <link linkend="gchar">gchar</link> *in_Account,
35 const <link linkend="gchar">gchar</link> *in_Connection,
36 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
37 const <link linkend="gchar">gchar</link> *in_Dispatch_Operation,
38 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
39 <link linkend="GHashTable">GHashTable</link> *in_Observer_Info,
40 <link linkend="tp-cli-client-observer-callback-for-observe-channels">tp_cli_client_observer_callback_for_observe_channels</link> callback,
41 <link linkend="gpointer">gpointer</link> user_data,
42 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
43 <link linkend="GObject">GObject</link> *weak_object);
44
45 <link linkend="void">void</link> (<link linkend="tp-cli-client-handler-callback-for-handle-channels">*tp_cli_client_handler_callback_for_handle_channels</link>)
46 (<link linkend="TpClient">TpClient</link> *proxy,
47 const <link linkend="GError">GError</link> *error,
48 <link linkend="gpointer">gpointer</link> user_data,
49 <link linkend="GObject">GObject</link> *weak_object);
50 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-client-handler-call-handle-channels">tp_cli_client_handler_call_handle_channels</link>
51 (<link linkend="TpClient">TpClient</link> *proxy,
52 <link linkend="gint">gint</link> timeout_ms,
53 const <link linkend="gchar">gchar</link> *in_Account,
54 const <link linkend="gchar">gchar</link> *in_Connection,
55 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
56 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
57 <link linkend="guint64">guint64</link> in_User_Action_Time,
58 <link linkend="GHashTable">GHashTable</link> *in_Handler_Info,
59 <link linkend="tp-cli-client-handler-callback-for-handle-channels">tp_cli_client_handler_callback_for_handle_channels</link> callback,
60 <link linkend="gpointer">gpointer</link> user_data,
61 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
62 <link linkend="GObject">GObject</link> *weak_object);
63 <link linkend="void">void</link> (<link linkend="tp-cli-client-interface-requests-callback-for-add-request">*tp_cli_client_interface_requests_callback_for_add_request</link>)
64 (<link linkend="TpClient">TpClient</link> *proxy,
65 const <link linkend="GError">GError</link> *error,
66 <link linkend="gpointer">gpointer</link> user_data,
67 <link linkend="GObject">GObject</link> *weak_object);
68 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-client-interface-requests-call-add-request">tp_cli_client_interface_requests_call_add_request</link>
69 (<link linkend="TpClient">TpClient</link> *proxy,
70 <link linkend="gint">gint</link> timeout_ms,
71 const <link linkend="gchar">gchar</link> *in_Request,
72 <link linkend="GHashTable">GHashTable</link> *in_Properties,
73 <link linkend="tp-cli-client-interface-requests-callback-for-add-request">tp_cli_client_interface_requests_callback_for_add_request</link> callback,
74 <link linkend="gpointer">gpointer</link> user_data,
75 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
76 <link linkend="GObject">GObject</link> *weak_object);
77 <link linkend="void">void</link> (<link linkend="tp-cli-client-interface-requests-callback-for-remove-request">*tp_cli_client_interface_requests_callback_for_remove_request</link>)
78 (<link linkend="TpClient">TpClient</link> *proxy,
79 const <link linkend="GError">GError</link> *error,
80 <link linkend="gpointer">gpointer</link> user_data,
81 <link linkend="GObject">GObject</link> *weak_object);
82 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-client-interface-requests-call-remove-request">tp_cli_client_interface_requests_call_remove_request</link>
83 (<link linkend="TpClient">TpClient</link> *proxy,
84 <link linkend="gint">gint</link> timeout_ms,
85 const <link linkend="gchar">gchar</link> *in_Request,
86 const <link linkend="gchar">gchar</link> *in_Error,
87 const <link linkend="gchar">gchar</link> *in_Message,
88 <link linkend="tp-cli-client-interface-requests-callback-for-remove-request">tp_cli_client_interface_requests_callback_for_remove_request</link> callback,
89 <link linkend="gpointer">gpointer</link> user_data,
90 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
91 <link linkend="GObject">GObject</link> *weak_object);
92
93 <link linkend="void">void</link> (<link linkend="tp-cli-client-approver-callback-for-add-dispatch-operation">*tp_cli_client_approver_callback_for_add_dispatch_operation</link>)
94 (<link linkend="TpClient">TpClient</link> *proxy,
95 const <link linkend="GError">GError</link> *error,
96 <link linkend="gpointer">gpointer</link> user_data,
97 <link linkend="GObject">GObject</link> *weak_object);
98 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-client-approver-call-add-dispatch-operation">tp_cli_client_approver_call_add_dispatch_operation</link>
99 (<link linkend="TpClient">TpClient</link> *proxy,
100 <link linkend="gint">gint</link> timeout_ms,
101 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
102 const <link linkend="gchar">gchar</link> *in_DispatchOperation,
103 <link linkend="GHashTable">GHashTable</link> *in_Properties,
104 <link linkend="tp-cli-client-approver-callback-for-add-dispatch-operation">tp_cli_client_approver_callback_for_add_dispatch_operation</link> callback,
105 <link linkend="gpointer">gpointer</link> user_data,
106 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
107 <link linkend="GObject">GObject</link> *weak_object);
108 </synopsis>
109 </refsynopsisdiv>
110
111 <refsect1 id="telepathy-glib-client.object-hierarchy" role="object_hierarchy">
112 <title role="object_hierarchy.title">Object Hierarchy</title>
113 <synopsis>
114 <link linkend="GObject">GObject</link>
115 +----<link linkend="TpProxy">TpProxy</link>
116 +----TpClient
117 </synopsis>
118 </refsect1>
119
120
121
122
123
124
125
126
127 <refsect1 id="telepathy-glib-client.description" role="desc">
128 <title role="desc.title">Description</title>
129 <para>
130 Each client to which the ChannelDispatcher can send channels must implement
131 the Client interface. This object represents such a client, and is mainly
132 useful in the implementation of the ChannelDispatcher itself.</para>
133 <para>
134 </para>
135 </refsect1>
136
137 <refsect1 id="telepathy-glib-client.details" role="details">
138 <title role="details.title">Details</title>
139 <refsect2 id="TpClient-struct" role="struct">
140 <title>TpClient</title>
141 <indexterm zone="TpClient-struct" role="0.7.UNRELEASED"><primary sortas="TpClient">TpClient</primary></indexterm><programlisting>typedef struct _TpClient TpClient;</programlisting>
142 <para>
143 Each client to which the ChannelDispatcher can send channels must implement
144 the Client interface. This object represents such a client, and is mainly
145 useful in the implementation of the ChannelDispatcher itself.
146 </para>
147 <para>
148 This proxy is usable but very incomplete: accessors for D-Bus properties
149 will be added in a later version of telepathy-glib, along with a mechanism
150 similar to <link linkend="tp-connection-call-when-ready"><function>tp_connection_call_when_ready()</function></link>.
151 </para>
152 <para>
153 Many operations performed on a Client are done via D-Bus properties.
154 Until convenience methods for this are implemented, use of the generic
155 <link linkend="tp-cli-dbus-properties-call-get-all"><function>tp_cli_dbus_properties_call_get_all()</function></link> and <link linkend="tp-cli-dbus-properties-call-set"><function>tp_cli_dbus_properties_call_set()</function></link>
156 methods is recommended.</para>
157 <para>
158 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
159 <refsect2 id="TpClientClass" role="struct">
160 <title>TpClientClass</title>
161 <indexterm zone="TpClientClass"><primary sortas="TpClientClass">TpClientClass</primary></indexterm><programlisting>typedef struct {
162 } TpClientClass;
163 </programlisting>
164 <para>
165 The class of a <link linkend="TpClient"><type>TpClient</type></link>.</para>
166 <para>
167 </para></refsect2>
168 <refsect2 id="tp-client-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
169 <title>tp_client_init_known_interfaces ()</title>
170 <indexterm zone="tp-client-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_client_init_known_interfaces">tp_client_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_client_init_known_interfaces (void);</programlisting>
171 <para>
172 Ensure that the known interfaces for TpClient have been set up.
173 This is done automatically when necessary, but for correct
174 overriding of library interfaces by local extensions, you should
175 call this function before calling
176 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
177 <link linkend="TP-TYPE-CLIENT--CAPS"><literal>TP_TYPE_CLIENT</literal></link>.</para>
178 <para>
179 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
180 <refsect2 id="tp-cli-client-observer-callback-for-observe-channels" role="function">
181 <title>tp_cli_client_observer_callback_for_observe_channels ()</title>
182 <indexterm zone="tp-cli-client-observer-callback-for-observe-channels"><primary sortas="tp_cli_client_observer_callback_for_observe_channels">tp_cli_client_observer_callback_for_observe_channels</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_client_observer_callback_for_observe_channels)
183 (<link linkend="TpClient">TpClient</link> *proxy,
184 const <link linkend="GError">GError</link> *error,
185 <link linkend="gpointer">gpointer</link> user_data,
186 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
187 <para>
188 Signature of the callback called when a ObserveChannels method call
189 succeeds or fails.</para>
190 <para>
191 </para><variablelist role="params">
192 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
193 <listitem><simpara> the proxy on which the call was made
194 </simpara></listitem></varlistentry>
195 <varlistentry><term><parameter>error</parameter>&#160;:</term>
196 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
197 </simpara></listitem></varlistentry>
198 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
199 <listitem><simpara> user-supplied data
200 </simpara></listitem></varlistentry>
201 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
202 <listitem><simpara> user-supplied object
203 </simpara></listitem></varlistentry>
204 </variablelist></refsect2>
205 <refsect2 id="tp-cli-client-observer-call-observe-channels" role="function">
206 <title>tp_cli_client_observer_call_observe_channels ()</title>
207 <indexterm zone="tp-cli-client-observer-call-observe-channels"><primary sortas="tp_cli_client_observer_call_observe_channels">tp_cli_client_observer_call_observe_channels</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_client_observer_call_observe_channels
208 (<link linkend="TpClient">TpClient</link> *proxy,
209 <link linkend="gint">gint</link> timeout_ms,
210 const <link linkend="gchar">gchar</link> *in_Account,
211 const <link linkend="gchar">gchar</link> *in_Connection,
212 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
213 const <link linkend="gchar">gchar</link> *in_Dispatch_Operation,
214 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
215 <link linkend="GHashTable">GHashTable</link> *in_Observer_Info,
216 <link linkend="tp-cli-client-observer-callback-for-observe-channels">tp_cli_client_observer_callback_for_observe_channels</link> callback,
217 <link linkend="gpointer">gpointer</link> user_data,
218 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
219 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
220 <para>
221 Start a ObserveChannels method call.
222 </para>
223 <para>
224 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by the channel dispatcher when channels in which the observer has registered an interest are announced in a &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Connection.Interface.Requests&quot;&gt;NewChannels&lt;/tp:dbus-ref&gt; signal.&lt;/p&gt; &lt;p&gt;If the same NewChannels signal announces some channels that match the filter, and some that do not, then only a subset of the channels (those that do match the filter) are passed to this method.&lt;/p&gt; &lt;p&gt;If the channel dispatcher will split up the channels from a single NewChannels signal and dispatch them separately (for instance because no installed Handler can handle all of them), it will call ObserveChannels several times.&lt;/p&gt; &lt;p&gt;The observer MUST NOT return from this method call until it is ready for a handler for the channel to run (which may change the channel&apos;s state).&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The channel dispatcher must wait for observers to start up, to avoid the following race: text channel logger (observer) gets ObserveChannels, text channel handler gets &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt; channel handler starts up faster and acknowledges messages, logger never sees those messages.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The channel dispatcher SHOULD NOT change its behaviour based on whether this method succeeds or fails: there are no defined D-Bus errors for this method, and if it fails, this only indicates that an Observer is somehow broken.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The expected error response in the channel dispatcher is to log a warning, and otherwise continue as though this method had succeeded.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
225 <para>
226 </para><variablelist role="params">
227 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
228 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
229 </simpara></listitem></varlistentry>
230 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
231 <listitem><simpara> the timeout in milliseconds, or -1 to use the
232 default
233 </simpara></listitem></varlistentry>
234 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
235 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use is that of the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;AccountManager&lt;/tp:dbus-ref&gt;.
236 </simpara></listitem></varlistentry>
237 <varlistentry><term><parameter>in_Connection</parameter>&#160;:</term>
238 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Connection&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use can be derived from this object path by removing the leading &apos;/&apos; and replacing all subsequent &apos;/&apos; by &apos;.&apos;.
239 </simpara></listitem></varlistentry>
240 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
241 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel&lt;/tp:dbus-ref&gt;s and their properties. Their well-known bus names are all the same as that of the Connection.
242 </simpara></listitem></varlistentry>
243 <varlistentry><term><parameter>in_Dispatch_Operation</parameter>&#160;:</term>
244 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The path to the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt; for these channels, or the special value &apos;/&apos; if there is no ChannelDispatchOperation (because the channels were requested, not incoming).&lt;/p&gt; &lt;p&gt;If the Observer calls &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;Claim&lt;/tp:dbus-ref&gt; or &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;HandleWith&lt;/tp:dbus-ref&gt; on the dispatch operation, it MUST be careful to avoid deadlock, since these methods cannot return until the Observer has returned from &lt;tp:member-ref&gt;ObserveChannels&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This allows an Observer to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;Claim&lt;/tp:dbus-ref&gt; a set of channels without having to match up calls to this method with calls to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Approver&quot;&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt;
245 </simpara></listitem></varlistentry>
246 <varlistentry><term><parameter>in_Requests_Satisfied</parameter>&#160;:</term>
247 <listitem><simpara> Used to pass an 'in' argument: The requests satisfied by these channels. &lt;tp:rationale&gt; If the same process is an Observer and a Handler, it can be useful to be given this information as soon as possible (it will also be passed to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client&quot;&gt;Handler.HandleChannels&lt;/tp:dbus-ref&gt;). &lt;/tp:rationale&gt;
248 </simpara></listitem></varlistentry>
249 <varlistentry><term><parameter>in_Observer_Info</parameter>&#160;:</term>
250 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Additional information about these channels. No keys are currently defined.&lt;/p&gt; &lt;p&gt;If keys are defined for this dictionary, all will be optional; observers MAY safely ignore any entry in this dictionary.&lt;/p&gt;
251 </simpara></listitem></varlistentry>
252 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
253 <listitem><simpara> called when the method call succeeds or fails;
254 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
255 reply tracking
256 </simpara></listitem></varlistentry>
257 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
258 <listitem><simpara> user-supplied data passed to the callback;
259 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
260 </simpara></listitem></varlistentry>
261 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
262 <listitem><simpara> called with the user_data as argument, after the
263 call has succeeded, failed or been cancelled;
264 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
265 </simpara></listitem></varlistentry>
266 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
267 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
268 weakly referenced; if it is destroyed, this call
269 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
270 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
271 </simpara></listitem></varlistentry>
272 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
273 progress. It is borrowed from the object, and will become
274 invalid when the callback is called, the call is
275 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
276 </simpara></listitem></varlistentry>
277 </variablelist></refsect2>
278 <refsect2 id="tp-cli-client-handler-callback-for-handle-channels" role="function">
279 <title>tp_cli_client_handler_callback_for_handle_channels ()</title>
280 <indexterm zone="tp-cli-client-handler-callback-for-handle-channels"><primary sortas="tp_cli_client_handler_callback_for_handle_channels">tp_cli_client_handler_callback_for_handle_channels</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_client_handler_callback_for_handle_channels)
281 (<link linkend="TpClient">TpClient</link> *proxy,
282 const <link linkend="GError">GError</link> *error,
283 <link linkend="gpointer">gpointer</link> user_data,
284 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
285 <para>
286 Signature of the callback called when a HandleChannels method call
287 succeeds or fails.</para>
288 <para>
289 </para><variablelist role="params">
290 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
291 <listitem><simpara> the proxy on which the call was made
292 </simpara></listitem></varlistentry>
293 <varlistentry><term><parameter>error</parameter>&#160;:</term>
294 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
295 </simpara></listitem></varlistentry>
296 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
297 <listitem><simpara> user-supplied data
298 </simpara></listitem></varlistentry>
299 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
300 <listitem><simpara> user-supplied object
301 </simpara></listitem></varlistentry>
302 </variablelist></refsect2>
303 <refsect2 id="tp-cli-client-handler-call-handle-channels" role="function">
304 <title>tp_cli_client_handler_call_handle_channels ()</title>
305 <indexterm zone="tp-cli-client-handler-call-handle-channels"><primary sortas="tp_cli_client_handler_call_handle_channels">tp_cli_client_handler_call_handle_channels</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_client_handler_call_handle_channels
306 (<link linkend="TpClient">TpClient</link> *proxy,
307 <link linkend="gint">gint</link> timeout_ms,
308 const <link linkend="gchar">gchar</link> *in_Account,
309 const <link linkend="gchar">gchar</link> *in_Connection,
310 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
311 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
312 <link linkend="guint64">guint64</link> in_User_Action_Time,
313 <link linkend="GHashTable">GHashTable</link> *in_Handler_Info,
314 <link linkend="tp-cli-client-handler-callback-for-handle-channels">tp_cli_client_handler_callback_for_handle_channels</link> callback,
315 <link linkend="gpointer">gpointer</link> user_data,
316 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
317 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
318 <para>
319 Start a HandleChannels method call.
320 </para>
321 <para>
322 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by the channel dispatcher when this client should handle these channels, or when this client should present channels that it is already handling to the user (e.g. bring them into the foreground).&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Clients are expected to know what channels they&apos;re already handling, and which channel object path corresponds to which window or tab. This can easily be done using a hash table keyed by channels&apos; object paths.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This method can raise any D-Bus error. If it does, the handler is assumed to have failed or crashed, and the channel dispatcher MUST recover in an implementation-specific way; it MAY attempt to dispatch the channels to another handler, or close the channels.&lt;/p&gt; &lt;p&gt;If closing the channels, it is RECOMMENDED that the channel dispatcher attempts to close the channels using &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel.Close&lt;/tp:dbus-ref&gt;, but resorts to calling &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel.Interface.Destroyable.Destroy&lt;/tp:dbus-ref&gt; (if available) or ignoring the channel (if not) if the same handler repeatedly fails to handle channels.&lt;/p&gt; &lt;p&gt;After HandleChannels returns successfully, the client process is considered to be responsible for the channel until it its unique name disappears from the bus.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;If a process has multiple Client bus names - some temporary and some long-lived - and drops one of the temporary bus names in order to reduce the set of channels that it will handle, any channels that it is already handling should remain unaffected.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
323 <para>
324 </para><variablelist role="params">
325 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
326 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
327 </simpara></listitem></varlistentry>
328 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
329 <listitem><simpara> the timeout in milliseconds, or -1 to use the
330 default
331 </simpara></listitem></varlistentry>
332 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
333 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Account&lt;/tp:dbus-ref&gt; with which the channels are associated. The well-known bus name to use is that of the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;AccountManager&lt;/tp:dbus-ref&gt;.
334 </simpara></listitem></varlistentry>
335 <varlistentry><term><parameter>in_Connection</parameter>&#160;:</term>
336 <listitem><simpara> Used to pass an 'in' argument: The Connection with which the channels are associated. The well-known bus name to use can be derived from this object path by removing the leading &apos;/&apos; and replacing all subsequent &apos;/&apos; by &apos;.&apos;.
337 </simpara></listitem></varlistentry>
338 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
339 <listitem><simpara> Used to pass an 'in' argument: The channels and their immutable properties. Their well-known bus name is the same as that of the Connection.
340 </simpara></listitem></varlistentry>
341 <varlistentry><term><parameter>in_Requests_Satisfied</parameter>&#160;:</term>
342 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The requests satisfied by these channels.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;If the handler implements Requests, this tells it that these channels match previous &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Interface.Requests&quot;&gt;AddRequest&lt;/tp:dbus-ref&gt; calls that it may have received.&lt;/p&gt; &lt;p&gt;There can be more than one, if they were EnsureChannel requests.&lt;/p&gt; &lt;/tp:rationale&gt;
343 </simpara></listitem></varlistentry>
344 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
345 <listitem><simpara> Used to pass an 'in' argument: The time at which user action occurred, or 0 if this channel is to be handled for some reason not involving user action. Handlers SHOULD use this for focus-stealing prevention, if applicable.
346 </simpara></listitem></varlistentry>
347 <varlistentry><term><parameter>in_Handler_Info</parameter>&#160;:</term>
348 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Additional information about these channels. No keys are currently defined.&lt;/p&gt; &lt;p&gt;If keys are defined for this dictionary, all will be optional; handlers MAY safely ignore any entry in this dictionary.&lt;/p&gt;
349 </simpara></listitem></varlistentry>
350 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
351 <listitem><simpara> called when the method call succeeds or fails;
352 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
353 reply tracking
354 </simpara></listitem></varlistentry>
355 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
356 <listitem><simpara> user-supplied data passed to the callback;
357 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
358 </simpara></listitem></varlistentry>
359 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
360 <listitem><simpara> called with the user_data as argument, after the
361 call has succeeded, failed or been cancelled;
362 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
363 </simpara></listitem></varlistentry>
364 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
365 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
366 weakly referenced; if it is destroyed, this call
367 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
368 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
369 </simpara></listitem></varlistentry>
370 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
371 progress. It is borrowed from the object, and will become
372 invalid when the callback is called, the call is
373 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
374 </simpara></listitem></varlistentry>
375 </variablelist></refsect2>
376 <refsect2 id="tp-cli-client-interface-requests-callback-for-add-request" role="function">
377 <title>tp_cli_client_interface_requests_callback_for_add_request ()</title>
378 <indexterm zone="tp-cli-client-interface-requests-callback-for-add-request"><primary sortas="tp_cli_client_interface_requests_callback_for_add_request">tp_cli_client_interface_requests_callback_for_add_request</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_client_interface_requests_callback_for_add_request)
379 (<link linkend="TpClient">TpClient</link> *proxy,
380 const <link linkend="GError">GError</link> *error,
381 <link linkend="gpointer">gpointer</link> user_data,
382 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
383 <para>
384 Signature of the callback called when a AddRequest method call
385 succeeds or fails.</para>
386 <para>
387 </para><variablelist role="params">
388 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
389 <listitem><simpara> the proxy on which the call was made
390 </simpara></listitem></varlistentry>
391 <varlistentry><term><parameter>error</parameter>&#160;:</term>
392 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
393 </simpara></listitem></varlistentry>
394 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
395 <listitem><simpara> user-supplied data
396 </simpara></listitem></varlistentry>
397 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
398 <listitem><simpara> user-supplied object
399 </simpara></listitem></varlistentry>
400 </variablelist></refsect2>
401 <refsect2 id="tp-cli-client-interface-requests-call-add-request" role="function">
402 <title>tp_cli_client_interface_requests_call_add_request ()</title>
403 <indexterm zone="tp-cli-client-interface-requests-call-add-request"><primary sortas="tp_cli_client_interface_requests_call_add_request">tp_cli_client_interface_requests_call_add_request</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_client_interface_requests_call_add_request
404 (<link linkend="TpClient">TpClient</link> *proxy,
405 <link linkend="gint">gint</link> timeout_ms,
406 const <link linkend="gchar">gchar</link> *in_Request,
407 <link linkend="GHashTable">GHashTable</link> *in_Properties,
408 <link linkend="tp-cli-client-interface-requests-callback-for-add-request">tp_cli_client_interface_requests_callback_for_add_request</link> callback,
409 <link linkend="gpointer">gpointer</link> user_data,
410 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
411 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
412 <para>
413 Start a AddRequest method call.
414 </para>
415 <para>
416 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by the ChannelDispatcher to indicate that channels have been requested, and that if the request is successful, they will probably be handled by this Handler. The ChannelDispatcher SHOULD only call this method on one handler per request.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This allows the UI to start preparing to handle the channels in advance (e.g. render a window with an &amp;quot;in progress&amp;quot; message), improving perceived responsiveness.&lt;/p&gt; &lt;p&gt;The use of &amp;quot;probably&amp;quot; is because you can&apos;t necessarily tell from a channel request which handler will handle particular channels. A reasonable heuristic would be to match the request against the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandlerChannelFilter&lt;/tp:dbus-ref&gt;, and respect the preferred handler (if any).&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If the request succeeds and is given to the expected Handler, the Requests_Satisfied parameter to &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandleChannels&lt;/tp:dbus-ref&gt; can be used to match the channel to a previous AddRequest call.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This lets the UI direct the channels to the window that it already opened.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;If the request fails, the expected handler is notified by the channel dispatcher calling its &lt;tp:member-ref&gt;RemoveRequest&lt;/tp:member-ref&gt; method.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This lets the UI close the window or display the error.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The channel dispatcher SHOULD remember which handler was notified, and if the channel request succeeds, it SHOULD dispatch the channels to the expected handler, unless the channels do not match that handler&apos;s &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.Client.Handler&quot;&gt;HandlerChannelFilter&lt;/tp:dbus-ref&gt;. If the channels are not dispatched to the expected handler, the handler that was expected is notified by the channel dispatcher calling its &lt;tp:member-ref&gt;RemoveRequest&lt;/tp:member-ref&gt; method with the NotYours error.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Expected handling is for the UI to close the window it previously opened.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Handlers SHOULD NOT return an error from this method; errors returned from this method SHOULD NOT alter the channel dispatcher&apos;s behaviour.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Calls to this method are merely a notification.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
417 <para>
418 </para><variablelist role="params">
419 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
420 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
421 </simpara></listitem></varlistentry>
422 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
423 <listitem><simpara> the timeout in milliseconds, or -1 to use the
424 default
425 </simpara></listitem></varlistentry>
426 <varlistentry><term><parameter>in_Request</parameter>&#160;:</term>
427 <listitem><simpara> Used to pass an 'in' argument: The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelRequest&lt;/tp:dbus-ref&gt; object, which MUST have been returned by &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatcher&quot;&gt;CreateChannel&lt;/tp:dbus-ref&gt; or &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatcher&quot;&gt;EnsureChannel&lt;/tp:dbus-ref&gt; before this method is called. &lt;tp:rationale&gt; See those methods for the rationale of this ordering. &lt;/tp:rationale&gt;
428 </simpara></listitem></varlistentry>
429 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
430 <listitem><simpara> Used to pass an 'in' argument: &lt;p&gt;Some of the properties of the ChannelRequest. To avoid race conditions, this dictionary MUST NOT include properties whose values could subsequently change. It SHOULD include as many properties as possible, given that constraint.&lt;/p&gt; &lt;p&gt;In particular, the properties &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelRequest&quot;&gt;Requests&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelRequest&quot;&gt;UserActionTime&lt;/tp:dbus-ref&gt; MUST be included.&lt;/p&gt;
431 </simpara></listitem></varlistentry>
432 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
433 <listitem><simpara> called when the method call succeeds or fails;
434 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
435 reply tracking
436 </simpara></listitem></varlistentry>
437 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
438 <listitem><simpara> user-supplied data passed to the callback;
439 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
440 </simpara></listitem></varlistentry>
441 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
442 <listitem><simpara> called with the user_data as argument, after the
443 call has succeeded, failed or been cancelled;
444 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
445 </simpara></listitem></varlistentry>
446 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
447 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
448 weakly referenced; if it is destroyed, this call
449 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
450 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
451 </simpara></listitem></varlistentry>
452 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
453 progress. It is borrowed from the object, and will become
454 invalid when the callback is called, the call is
455 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
456 </simpara></listitem></varlistentry>
457 </variablelist></refsect2>
458 <refsect2 id="tp-cli-client-interface-requests-callback-for-remove-request" role="function">
459 <title>tp_cli_client_interface_requests_callback_for_remove_request ()</title>
460 <indexterm zone="tp-cli-client-interface-requests-callback-for-remove-request"><primary sortas="tp_cli_client_interface_requests_callback_for_remove_request">tp_cli_client_interface_requests_callback_for_remove_request</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_client_interface_requests_callback_for_remove_request)
461 (<link linkend="TpClient">TpClient</link> *proxy,
462 const <link linkend="GError">GError</link> *error,
463 <link linkend="gpointer">gpointer</link> user_data,
464 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
465 <para>
466 Signature of the callback called when a RemoveRequest method call
467 succeeds or fails.</para>
468 <para>
469 </para><variablelist role="params">
470 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
471 <listitem><simpara> the proxy on which the call was made
472 </simpara></listitem></varlistentry>
473 <varlistentry><term><parameter>error</parameter>&#160;:</term>
474 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
475 </simpara></listitem></varlistentry>
476 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
477 <listitem><simpara> user-supplied data
478 </simpara></listitem></varlistentry>
479 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
480 <listitem><simpara> user-supplied object
481 </simpara></listitem></varlistentry>
482 </variablelist></refsect2>
483 <refsect2 id="tp-cli-client-interface-requests-call-remove-request" role="function">
484 <title>tp_cli_client_interface_requests_call_remove_request ()</title>
485 <indexterm zone="tp-cli-client-interface-requests-call-remove-request"><primary sortas="tp_cli_client_interface_requests_call_remove_request">tp_cli_client_interface_requests_call_remove_request</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_client_interface_requests_call_remove_request
486 (<link linkend="TpClient">TpClient</link> *proxy,
487 <link linkend="gint">gint</link> timeout_ms,
488 const <link linkend="gchar">gchar</link> *in_Request,
489 const <link linkend="gchar">gchar</link> *in_Error,
490 const <link linkend="gchar">gchar</link> *in_Message,
491 <link linkend="tp-cli-client-interface-requests-callback-for-remove-request">tp_cli_client_interface_requests_callback_for_remove_request</link> callback,
492 <link linkend="gpointer">gpointer</link> user_data,
493 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
494 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
495 <para>
496 Start a RemoveRequest method call.
497 </para>
498 <para>
499 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by the ChannelDispatcher to indicate that a request previously passed to &lt;tp:member-ref&gt;AddRequest&lt;/tp:member-ref&gt; has failed and should be disregarded.&lt;/p&gt; &lt;p&gt;Handlers SHOULD NOT return an error from this method; errors returned from this method SHOULD NOT alter the channel dispatcher&apos;s behaviour.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;Calls to this method are merely a notification.&lt;/p&gt; &lt;/tp:rationale&gt;</para>
500 <para>
501 </para><variablelist role="params">
502 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
503 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
504 </simpara></listitem></varlistentry>
505 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
506 <listitem><simpara> the timeout in milliseconds, or -1 to use the
507 default
508 </simpara></listitem></varlistentry>
509 <varlistentry><term><parameter>in_Request</parameter>&#160;:</term>
510 <listitem><simpara> Used to pass an 'in' argument: The request that failed.
511 </simpara></listitem></varlistentry>
512 <varlistentry><term><parameter>in_Error</parameter>&#160;:</term>
513 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The name of the D-Bus error with which the request failed.&lt;/p&gt; &lt;p&gt;If this is &lt;code&gt;org.freedesktop.Telepathy.Error.NotYours&lt;/code&gt;, this indicates that the request succeeded, but all the resulting channels were given to some other handler.&lt;/p&gt;
514 </simpara></listitem></varlistentry>
515 <varlistentry><term><parameter>in_Message</parameter>&#160;:</term>
516 <listitem><simpara> Used to pass an 'in' argument: Any message supplied with the D-Bus error.
517 </simpara></listitem></varlistentry>
518 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
519 <listitem><simpara> called when the method call succeeds or fails;
520 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
521 reply tracking
522 </simpara></listitem></varlistentry>
523 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
524 <listitem><simpara> user-supplied data passed to the callback;
525 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
526 </simpara></listitem></varlistentry>
527 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
528 <listitem><simpara> called with the user_data as argument, after the
529 call has succeeded, failed or been cancelled;
530 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
531 </simpara></listitem></varlistentry>
532 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
533 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
534 weakly referenced; if it is destroyed, this call
535 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
536 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
537 </simpara></listitem></varlistentry>
538 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
539 progress. It is borrowed from the object, and will become
540 invalid when the callback is called, the call is
541 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
542 </simpara></listitem></varlistentry>
543 </variablelist></refsect2>
544 <refsect2 id="tp-cli-client-approver-callback-for-add-dispatch-operation" role="function">
545 <title>tp_cli_client_approver_callback_for_add_dispatch_operation ()</title>
546 <indexterm zone="tp-cli-client-approver-callback-for-add-dispatch-operation"><primary sortas="tp_cli_client_approver_callback_for_add_dispatch_operation">tp_cli_client_approver_callback_for_add_dispatch_operation</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_client_approver_callback_for_add_dispatch_operation)
547 (<link linkend="TpClient">TpClient</link> *proxy,
548 const <link linkend="GError">GError</link> *error,
549 <link linkend="gpointer">gpointer</link> user_data,
550 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
551 <para>
552 Signature of the callback called when a AddDispatchOperation method call
553 succeeds or fails.</para>
554 <para>
555 </para><variablelist role="params">
556 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
557 <listitem><simpara> the proxy on which the call was made
558 </simpara></listitem></varlistentry>
559 <varlistentry><term><parameter>error</parameter>&#160;:</term>
560 <listitem><simpara> <link linkend="NULL--CAPS"><literal>NULL</literal></link> on success, or an error on failure
561 </simpara></listitem></varlistentry>
562 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
563 <listitem><simpara> user-supplied data
564 </simpara></listitem></varlistentry>
565 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
566 <listitem><simpara> user-supplied object
567 </simpara></listitem></varlistentry>
568 </variablelist></refsect2>
569 <refsect2 id="tp-cli-client-approver-call-add-dispatch-operation" role="function">
570 <title>tp_cli_client_approver_call_add_dispatch_operation ()</title>
571 <indexterm zone="tp-cli-client-approver-call-add-dispatch-operation"><primary sortas="tp_cli_client_approver_call_add_dispatch_operation">tp_cli_client_approver_call_add_dispatch_operation</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_client_approver_call_add_dispatch_operation
572 (<link linkend="TpClient">TpClient</link> *proxy,
573 <link linkend="gint">gint</link> timeout_ms,
574 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
575 const <link linkend="gchar">gchar</link> *in_DispatchOperation,
576 <link linkend="GHashTable">GHashTable</link> *in_Properties,
577 <link linkend="tp-cli-client-approver-callback-for-add-dispatch-operation">tp_cli_client_approver_callback_for_add_dispatch_operation</link> callback,
578 <link linkend="gpointer">gpointer</link> user_data,
579 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy,
580 <link linkend="GObject">GObject</link> *weak_object);</programlisting>
581 <para>
582 Start a AddDispatchOperation method call.
583 </para>
584 <para>
585 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Called by the channel dispatcher when a ChannelDispatchOperation in which the approver has registered an interest is created, or when the approver starts up while such channel dispatch operations already exist.&lt;/p&gt; &lt;p&gt;The channel dispatcher SHOULD call this method on all approvers at the same time. If an approver returns an error from this method, the approver is assumed to be faulty.&lt;/p&gt; &lt;p&gt;If no approvers return from this method successfully (including situations where there are no matching approvers at all), the channel dispatcher SHOULD consider this to be an error, and recover by dispatching the channel to the most preferred handler.&lt;/p&gt; &lt;tp:rationale&gt; Processes that aren&apos;t approvers (or don&apos;t at least ensure that there is some approver) probably shouldn&apos;t be making connections anyway, so there should always be at least one approver running. &lt;/tp:rationale&gt;</para>
586 <para>
587 </para><variablelist role="params">
588 <varlistentry><term><parameter>proxy</parameter>&#160;:</term>
589 <listitem><simpara> the <link linkend="TpProxy"><type>TpProxy</type></link>
590 </simpara></listitem></varlistentry>
591 <varlistentry><term><parameter>timeout_ms</parameter>&#160;:</term>
592 <listitem><simpara> the timeout in milliseconds, or -1 to use the
593 default
594 </simpara></listitem></varlistentry>
595 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
596 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The initial value of the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation.Channels&lt;/tp:dbus-ref&gt; property, containing the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;Channel&lt;/tp:dbus-ref&gt;s to be dispatched and their properties.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This can&apos;t be signalled to the approver through the Properties parameter of this method, because Channels is not an immutable property.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;This argument always contains all of the channels in the channel dispatch operation, even if not all of them actually match the &lt;tp:member-ref&gt;ApproverChannelFilter&lt;/tp:member-ref&gt;.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;This seems the least bad way to handle such a situation; see the discussion on &lt;a href=&quot;http://bugs.freedesktop.org/show_bug.cgi?id=21090&quot;&gt;bug <link linkend="21090--CAPS"><type>21090</type></link>&lt;/a&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;The actual channels to be dispatched may reduce as channels are closed: this is signalled by &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation.ChannelLost&lt;/tp:dbus-ref&gt;. &lt;/p&gt; &lt;p&gt;Approvers SHOULD connect to ChannelLost and &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation.Finished&lt;/tp:dbus-ref&gt;. (if desired) before returning from AddDispatchOperation, since those signals are guaranteed not to be emitted until after all AddDispatchOperation calls have returned (with success or failure) or timed out.&lt;/p&gt;
597 </simpara></listitem></varlistentry>
598 <varlistentry><term><parameter>in_DispatchOperation</parameter>&#160;:</term>
599 <listitem><simpara> Used to pass an 'in' argument: &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;The &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt; to be processed.&lt;/p&gt;
600 </simpara></listitem></varlistentry>
601 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
602 <listitem><simpara> Used to pass an 'in' argument: &lt;p&gt;Properties of the channel dispatch operation. This MUST NOT include properties that could change, SHOULD include as many properties as possible given that constraint, and MUST include at least the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;Account&lt;/tp:dbus-ref&gt;, &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;Connection&lt;/tp:dbus-ref&gt; and &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy.ChannelDispatchOperation&quot;&gt;PossibleHandlers&lt;/tp:dbus-ref&gt; properties.&lt;/p&gt;
603 </simpara></listitem></varlistentry>
604 <varlistentry><term><parameter>callback</parameter>&#160;:</term>
605 <listitem><simpara> called when the method call succeeds or fails;
606 may be <link linkend="NULL--CAPS"><literal>NULL</literal></link> to make a "fire and forget" call with no
607 reply tracking
608 </simpara></listitem></varlistentry>
609 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
610 <listitem><simpara> user-supplied data passed to the callback;
611 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
612 </simpara></listitem></varlistentry>
613 <varlistentry><term><parameter>destroy</parameter>&#160;:</term>
614 <listitem><simpara> called with the user_data as argument, after the
615 call has succeeded, failed or been cancelled;
616 must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
617 </simpara></listitem></varlistentry>
618 <varlistentry><term><parameter>weak_object</parameter>&#160;:</term>
619 <listitem><simpara> If not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, a <link linkend="GObject"><type>GObject</type></link> which will be
620 weakly referenced; if it is destroyed, this call
621 will automatically be cancelled. Must be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if
622 <parameter>callback</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>
623 </simpara></listitem></varlistentry>
624 <varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="TpProxyPendingCall"><type>TpProxyPendingCall</type></link> representing the call in
625 progress. It is borrowed from the object, and will become
626 invalid when the callback is called, the call is
627 cancelled or the <link linkend="TpProxy"><type>TpProxy</type></link> becomes invalid.
628 </simpara></listitem></varlistentry>
629 </variablelist></refsect2>
630
631 </refsect1>
632
633
634
635
636 </refentry>
9292 <link linkend="gboolean">gboolean</link> <link linkend="tp-connection-manager-check-valid-protocol-name">tp_connection_manager_check_valid_protocol_name</link>
9393 (const <link linkend="gchar">gchar</link> *name,
9494 <link linkend="GError">GError</link> **error);
95 <link linkend="void">void</link> <link linkend="tp-connection-manager-init-known-interfaces">tp_connection_manager_init_known_interfaces</link>
96 (void);
9597
9698
9799 <link linkend="void">void</link> (<link linkend="tp-cli-connection-manager-callback-for-get-parameters">*tp_cli_connection_manager_callback_for_get_parameters</link>)
973975
974976 </simpara></listitem></varlistentry>
975977 </variablelist><para role="since">Since 0.7.1</para></refsect2>
978 <refsect2 id="tp-connection-manager-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
979 <title>tp_connection_manager_init_known_interfaces ()</title>
980 <indexterm zone="tp-connection-manager-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_connection_manager_init_known_interfaces">tp_connection_manager_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_connection_manager_init_known_interfaces
981 (void);</programlisting>
982 <para>
983 Ensure that the known interfaces for TpConnectionManager have been set up.
984 This is done automatically when necessary, but for correct
985 overriding of library interfaces by local extensions, you should
986 call this function before calling
987 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
988 <link linkend="TP-TYPE-CONNECTION-MANAGER--CAPS"><literal>TP_TYPE_CONNECTION_MANAGER</literal></link>.</para>
989 <para>
990 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
976991 <refsect2 id="tp-cli-connection-manager-callback-for-get-parameters" role="function">
977992 <title>tp_cli_connection_manager_callback_for_get_parameters ()</title>
978993 <indexterm zone="tp-cli-connection-manager-callback-for-get-parameters"><primary sortas="tp_cli_connection_manager_callback_for_get_parameters">tp_cli_connection_manager_callback_for_get_parameters</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_cli_connection_manager_callback_for_get_parameters)
878878 <para>
879879 This is a thin wrapper around the GetContactAttributes D-Bus method, and
880880 should be used in preference to
881 <link linkend="tp-cli-connection-interface-contacts-get-contact-attributes"><function>tp_cli_connection_interface_contacts_get_contact_attributes()</function></link>.
881 <link linkend="tp-cli-connection-interface-contacts-get-contact-attributes"><function>tp_cli_connection_interface_contacts_get_contact_attributes()</function></link>; mixing this
882 function, <link linkend="tp-connection-hold-handles"><function>tp_connection_hold_handles()</function></link>, <link linkend="tp-connection-unref-handles"><function>tp_connection_unref_handles()</function></link>, and
883 <link linkend="TpContact"><type>TpContact</type></link> with direct use of the RequestHandles, HoldHandles and
884 GetContactAttributes D-Bus methods is unwise, as <link linkend="TpConnection"><type>TpConnection</type></link> and
885 <link linkend="TpContact"><type>TpContact</type></link> perform client-side reference counting of handles.
882886 The <link linkend="TpContact"><type>TpContact</type></link> API provides a higher-level abstraction which should
883887 usually be used instead.
884888 </para>
943947 <para>
944948 If they are valid, the callback will later be called with the given
945949 handles; if not all of them are valid, the callback will be called with
946 an error.</para>
950 an error.
951 </para>
952 <para>
953 This function, along with <link linkend="tp-connection-unref-handles"><function>tp_connection_unref_handles()</function></link>,
954 <link linkend="tp-connection-get-contact-attributes"><function>tp_connection_get_contact_attributes()</function></link> and <link linkend="TpContact"><type>TpContact</type></link>, keeps a client-side
955 reference count of handles; you should not use the RequestHandles,
956 HoldHandles and GetContactAttributes D-Bus methods directly as well as these
957 functions.</para>
947958 <para>
948959 </para><variablelist role="params">
949960 <varlistentry><term><parameter>self</parameter>&#160;:</term>
9971008 <link linkend="tp-cli-connection-interface-contacts-run-get-contact-attributes"><function>tp_cli_connection_interface_contacts_run_get_contact_attributes()</function></link> directly.
9981009 Those functions should be avoided in favour of using <link linkend="TpContact"><type>TpContact</type></link>,
9991010 <link linkend="tp-connection-hold-handles"><function>tp_connection_hold_handles()</function></link>, <link linkend="tp-connection-request-handles"><function>tp_connection_request_handles()</function></link> and
1000 <link linkend="tp-connection-get-contact-attributes"><function>tp_connection_get_contact_attributes()</function></link>.
1011 <link linkend="tp-connection-get-contact-attributes"><function>tp_connection_get_contact_attributes()</function></link>, which along with this function
1012 perform client-side reference counting of handles.
10011013 </para>
10021014 <para>
10031015 If <parameter>self</parameter> has already become invalid, this function does nothing.</para>
6767 <link linkend="TpDBusDaemonNameOwnerChangedCb">TpDBusDaemonNameOwnerChangedCb</link> callback,
6868 <link linkend="gpointer">gpointer</link> user_data,
6969 <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
70 <link linkend="void">void</link> <link linkend="tp-dbus-daemon-init-known-interfaces">tp_dbus_daemon_init_known_interfaces</link>
71 (void);
7072
7173 <link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * <link linkend="tp-cli-dbus-daemon-call-add-match">tp_cli_dbus_daemon_call_add_match</link> (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *proxy,
7274 <link linkend="gint">gint</link> timeout_ms,
933935 cancelled due to <link linkend="tp-dbus-daemon-cancel-name-owner-watch"><function>tp_dbus_daemon_cancel_name_owner_watch()</function></link>
934936 </simpara></listitem></varlistentry>
935937 </variablelist><para role="since">Since 0.7.1</para></refsect2>
938 <refsect2 id="tp-dbus-daemon-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
939 <title>tp_dbus_daemon_init_known_interfaces ()</title>
940 <indexterm zone="tp-dbus-daemon-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_dbus_daemon_init_known_interfaces">tp_dbus_daemon_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_dbus_daemon_init_known_interfaces
941 (void);</programlisting>
942 <para>
943 Ensure that the known interfaces for TpDBusDaemon have been set up.
944 This is done automatically when necessary, but for correct
945 overriding of library interfaces by local extensions, you should
946 call this function before calling
947 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
948 <link linkend="TP-TYPE-DBUS-DAEMON--CAPS"><literal>TP_TYPE_DBUS_DAEMON</literal></link>.</para>
949 <para>
950 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
936951 <refsect2 id="tp-cli-dbus-daemon-call-add-match" role="function">
937952 <title>tp_cli_dbus_daemon_call_add_match ()</title>
938953 <indexterm zone="tp-cli-dbus-daemon-call-add-match"><primary sortas="tp_cli_dbus_daemon_call_add_match">tp_cli_dbus_daemon_call_add_match</primary></indexterm><programlisting><link linkend="TpProxyPendingCall">TpProxyPendingCall</link> * tp_cli_dbus_daemon_call_add_match (<link linkend="TpDBusDaemon">TpDBusDaemon</link> *proxy,
7171 (service)</listitem>
7272 <listitem><literal>handles</literal> - handle reference tracking tracking
7373 in <link linkend="TpBaseConnection"><type>TpBaseConnection</type></link> (service) and <link linkend="TpConnection"><type>TpConnection</type></link> (client)</listitem>
74 <listitem><literal>accounts</literal> - the <link linkend="TpAccountManager"><type>TpAccountManager</type></link> and
75 <link linkend="TpAccount"><type>TpAccount</type></link> objects (client)</listitem>
7476 <listitem><literal>all</literal> - all of the above</listitem>
7577 </itemizedlist></para>
7678 <para>
2424 #define <link linkend="TP-CM-OBJECT-PATH-BASE--CAPS">TP_CM_OBJECT_PATH_BASE</link>
2525 #define <link linkend="TP-CONN-BUS-NAME-BASE--CAPS">TP_CONN_BUS_NAME_BASE</link>
2626 #define <link linkend="TP-CONN-OBJECT-PATH-BASE--CAPS">TP_CONN_OBJECT_PATH_BASE</link>
27 #define <link linkend="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS">TP_ACCOUNT_MANAGER_BUS_NAME</link>
28 #define <link linkend="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS">TP_ACCOUNT_MANAGER_OBJECT_PATH</link>
29 #define <link linkend="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS">TP_ACCOUNT_OBJECT_PATH_BASE</link>
30 #define <link linkend="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS">TP_CHANNEL_DISPATCHER_BUS_NAME</link>
31 #define <link linkend="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS">TP_CHANNEL_DISPATCHER_OBJECT_PATH</link>
32 #define <link linkend="TP-CLIENT-BUS-NAME-BASE--CAPS">TP_CLIENT_BUS_NAME_BASE</link>
33 #define <link linkend="TP-CLIENT-OBJECT-PATH-BASE--CAPS">TP_CLIENT_OBJECT_PATH_BASE</link>
2734 </synopsis>
2835 </refsynopsisdiv>
2936
8895 of elements representing the account should be appended.</para>
8996 <para>
9097 </para></refsect2>
98 <refsect2 id="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS" role="macro">
99 <title>TP_ACCOUNT_MANAGER_BUS_NAME</title>
100 <indexterm zone="TP-ACCOUNT-MANAGER-BUS-NAME--CAPS"><primary sortas="TP_ACCOUNT_MANAGER_BUS_NAME">TP_ACCOUNT_MANAGER_BUS_NAME</primary></indexterm><programlisting>#define TP_ACCOUNT_MANAGER_BUS_NAME "org.freedesktop.Telepathy.AccountManager"
101 </programlisting>
102 <para>
103 The account manager's well-known bus name</para>
104 <para>
105 </para></refsect2>
106 <refsect2 id="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS" role="macro">
107 <title>TP_ACCOUNT_MANAGER_OBJECT_PATH</title>
108 <indexterm zone="TP-ACCOUNT-MANAGER-OBJECT-PATH--CAPS"><primary sortas="TP_ACCOUNT_MANAGER_OBJECT_PATH">TP_ACCOUNT_MANAGER_OBJECT_PATH</primary></indexterm><programlisting>#define TP_ACCOUNT_MANAGER_OBJECT_PATH "/org/freedesktop/Telepathy/AccountManager"
109 </programlisting>
110 <para>
111 The account manager's standard object path</para>
112 <para>
113 </para></refsect2>
114 <refsect2 id="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS" role="macro">
115 <title>TP_ACCOUNT_OBJECT_PATH_BASE</title>
116 <indexterm zone="TP-ACCOUNT-OBJECT-PATH-BASE--CAPS"><primary sortas="TP_ACCOUNT_OBJECT_PATH_BASE">TP_ACCOUNT_OBJECT_PATH_BASE</primary></indexterm><programlisting>#define TP_ACCOUNT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Account/"
117 </programlisting>
118 <para>
119 The common prefix of the object path for all Account objects.</para>
120 <para>
121 </para></refsect2>
122 <refsect2 id="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS" role="macro">
123 <title>TP_CHANNEL_DISPATCHER_BUS_NAME</title>
124 <indexterm zone="TP-CHANNEL-DISPATCHER-BUS-NAME--CAPS"><primary sortas="TP_CHANNEL_DISPATCHER_BUS_NAME">TP_CHANNEL_DISPATCHER_BUS_NAME</primary></indexterm><programlisting>#define TP_CHANNEL_DISPATCHER_BUS_NAME "org.freedesktop.Telepathy.ChannelDispatcher"
125 </programlisting>
126 <para>
127 The channel dispatcher's well-known bus name</para>
128 <para>
129 </para></refsect2>
130 <refsect2 id="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS" role="macro">
131 <title>TP_CHANNEL_DISPATCHER_OBJECT_PATH</title>
132 <indexterm zone="TP-CHANNEL-DISPATCHER-OBJECT-PATH--CAPS"><primary sortas="TP_CHANNEL_DISPATCHER_OBJECT_PATH">TP_CHANNEL_DISPATCHER_OBJECT_PATH</primary></indexterm><programlisting>#define TP_CHANNEL_DISPATCHER_OBJECT_PATH "/org/freedesktop/Telepathy/ChannelDispatcher"
133 </programlisting>
134 <para>
135 The channel dispatcher's standard object path</para>
136 <para>
137 </para></refsect2>
138 <refsect2 id="TP-CLIENT-BUS-NAME-BASE--CAPS" role="macro">
139 <title>TP_CLIENT_BUS_NAME_BASE</title>
140 <indexterm zone="TP-CLIENT-BUS-NAME-BASE--CAPS"><primary sortas="TP_CLIENT_BUS_NAME_BASE">TP_CLIENT_BUS_NAME_BASE</primary></indexterm><programlisting>#define TP_CLIENT_BUS_NAME_BASE "org.freedesktop.Telepathy.Client."
141 </programlisting>
142 <para>
143 The common prefix of the well-known bus name for any Telepathy Client.</para>
144 <para>
145 </para></refsect2>
146 <refsect2 id="TP-CLIENT-OBJECT-PATH-BASE--CAPS" role="macro">
147 <title>TP_CLIENT_OBJECT_PATH_BASE</title>
148 <indexterm zone="TP-CLIENT-OBJECT-PATH-BASE--CAPS"><primary sortas="TP_CLIENT_OBJECT_PATH_BASE">TP_CLIENT_OBJECT_PATH_BASE</primary></indexterm><programlisting>#define TP_CLIENT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Client/"
149 </programlisting>
150 <para>
151 The common prefix of the well-known object path for any Telepathy Client.</para>
152 <para>
153 </para></refsect2>
91154
92155 </refsect1>
93156
115115
116116 #define <link linkend="TP-ARRAY-TYPE-ROOM-INFO-LIST--CAPS">TP_ARRAY_TYPE_ROOM_INFO_LIST</link>
117117 #define <link linkend="TP-STRUCT-TYPE-ROOM-INFO--CAPS">TP_STRUCT_TYPE_ROOM_INFO</link>
118
119 #define <link linkend="TP-STRUCT-TYPE-AVATAR--CAPS">TP_STRUCT_TYPE_AVATAR</link>
120
121 #define <link linkend="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</link>
122 #define <link linkend="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS">TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</link>
118123 </synopsis>
119124 </refsynopsisdiv>
120125
20412046 (Undocumented)</para>
20422047 <para>
20432048 </para></refsect2>
2049 <refsect2 id="TP-STRUCT-TYPE-AVATAR--CAPS" role="macro">
2050 <title>TP_STRUCT_TYPE_AVATAR</title>
2051 <indexterm zone="TP-STRUCT-TYPE-AVATAR--CAPS"><primary sortas="TP_STRUCT_TYPE_AVATAR">TP_STRUCT_TYPE_AVATAR</primary></indexterm><programlisting>#define TP_STRUCT_TYPE_AVATAR</programlisting>
2052 <para>
2053 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt;
2054
2055
2056 &lt;p&gt;
2057 A struct containing avatar data marked with its MIME type.
2058 &lt;/p&gt;
2059
2060
2061 </para>
2062 <para>
2063 This macro expands to a call to a function
2064 that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GValueArray"><type>GValueArray</type></link>
2065 appropriate for representing a D-Bus struct
2066 with signature <literal>(ays)</literal>.
2067 </para>
2068 <para>
2069 Member 0 (D-Bus type <literal>ay</literal>,
2070 named <literal>Avatar_Data</literal>):
2071 (Undocumented)
2072 </para>
2073 <para>
2074 Member 1 (D-Bus type <literal>s</literal>,
2075 named <literal>MIME_Type</literal>):
2076 (Undocumented)</para>
2077 <para>
2078 </para></refsect2>
2079 <refsect2 id="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS" role="macro">
2080 <title>TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</title>
2081 <indexterm zone="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"><primary sortas="TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS">TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</primary></indexterm><programlisting>#define TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</programlisting>
2082 <para>
2083 Details of a channel dispatch operation.
2084
2085 </para>
2086 <para>
2087 This macro expands to a call to a function
2088 that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GValueArray"><type>GValueArray</type></link>
2089 appropriate for representing a D-Bus struct
2090 with signature <literal>(oa{sv})</literal>.
2091 </para>
2092 <para>
2093 Member 0 (D-Bus type <literal>o</literal>,
2094 named <literal>Channel_Dispatch_Operation</literal>):
2095 The object path of the &lt;tp:dbus-ref namespace=&quot;org.freedesktop.Telepathy&quot;&gt;ChannelDispatchOperation&lt;/tp:dbus-ref&gt;.
2096 </para>
2097 <para>
2098 Member 1 (D-Bus type <literal>a{sv}</literal>,
2099 type <literal>Qualified_Property_Value_Map</literal>,
2100 named <literal>Properties</literal>):
2101 &lt;tp:docstring xmlns=&quot;http://www.w3.org/1999/xhtml&quot;&gt; &lt;p&gt;Properties of the channel dispatch operation.&lt;/p&gt; &lt;p&gt;Connection managers MUST NOT include properties in this mapping if their values can change. Clients MUST ignore properties that appear in this mapping if their values can change.&lt;/p&gt; &lt;tp:rationale&gt; &lt;p&gt;The rationale is the same as for &lt;tp:type-ref&gt;Channel_Details&lt;/tp:type-ref&gt;.&lt;/p&gt; &lt;/tp:rationale&gt; &lt;p&gt;Each dictionary MUST contain at least the following keys:&lt;/p&gt; &lt;ul&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Interfaces&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Connection&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.Account&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;li&gt;&lt;tp:dbus-ref&gt;org.freedesktop.Telepathy.ChannelDispatchOperation.PossibleHandlers&lt;/tp:dbus-ref&gt;&lt;/li&gt; &lt;/ul&gt;</para>
2102 <para>
2103 </para></refsect2>
2104 <refsect2 id="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS" role="macro">
2105 <title>TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</title>
2106 <indexterm zone="TP-ARRAY-TYPE-DISPATCH-OPERATION-DETAILS-LIST--CAPS"><primary sortas="TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST">TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</primary></indexterm><programlisting>#define TP_ARRAY_TYPE_DISPATCH_OPERATION_DETAILS_LIST</programlisting>
2107 <para>
2108 Expands to a call to a function
2109 that returns the <link linkend="GType"><type>GType</type></link> of a <link linkend="GPtrArray"><type>GPtrArray</type></link>
2110 of <link linkend="TP-STRUCT-TYPE-DISPATCH-OPERATION-DETAILS--CAPS"><type>TP_STRUCT_TYPE_DISPATCH_OPERATION_DETAILS</type></link>.</para>
2111 <para>
2112 </para></refsect2>
20442113
20452114 </refsect1>
20462115
1919
2020 #include &lt;telepathy-glib/interfaces.h&gt;
2121
22 #define <link linkend="TP-IFACE-ACCOUNT--CAPS">TP_IFACE_ACCOUNT</link>
23 #define <link linkend="TP-IFACE-QUARK-ACCOUNT--CAPS">TP_IFACE_QUARK_ACCOUNT</link>
24 #define <link linkend="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS">TP_IFACE_ACCOUNT_INTERFACE_AVATAR</link>
25 #define <link linkend="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS">TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</link>
26 #define <link linkend="TP-IFACE-ACCOUNT-MANAGER--CAPS">TP_IFACE_ACCOUNT_MANAGER</link>
27 #define <link linkend="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS">TP_IFACE_QUARK_ACCOUNT_MANAGER</link>
2228 #define <link linkend="TP-IFACE-DBUS-DAEMON--CAPS">TP_IFACE_DBUS_DAEMON</link>
2329 #define <link linkend="TP-IFACE-QUARK-DBUS-DAEMON--CAPS">TP_IFACE_QUARK_DBUS_DAEMON</link>
2430 #define <link linkend="TP-IFACE-DBUS-INTROSPECTABLE--CAPS">TP_IFACE_DBUS_INTROSPECTABLE</link>
8389 #define <link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-MEDIA-SIGNALLING--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_MEDIA_SIGNALLING</link>
8490 #define <link linkend="TP-IFACE-CHANNEL-INTERFACE-MESSAGES--CAPS">TP_IFACE_CHANNEL_INTERFACE_MESSAGES</link>
8591 #define <link linkend="TP-IFACE-QUARK-CHANNEL-INTERFACE-MESSAGES--CAPS">TP_IFACE_QUARK_CHANNEL_INTERFACE_MESSAGES</link>
92 #define <link linkend="TP-IFACE-CHANNEL-DISPATCHER--CAPS">TP_IFACE_CHANNEL_DISPATCHER</link>
93 #define <link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCHER</link>
94 #define <link linkend="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</link>
95 #define <link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</link>
96 #define <link linkend="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS">TP_IFACE_CHANNEL_DISPATCH_OPERATION</link>
97 #define <link linkend="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS">TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</link>
98 #define <link linkend="TP-IFACE-CHANNEL-REQUEST--CAPS">TP_IFACE_CHANNEL_REQUEST</link>
99 #define <link linkend="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS">TP_IFACE_QUARK_CHANNEL_REQUEST</link>
86100 #define <link linkend="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS">TP_IFACE_MEDIA_SESSION_HANDLER</link>
87101 #define <link linkend="TP-IFACE-QUARK-MEDIA-SESSION-HANDLER--CAPS">TP_IFACE_QUARK_MEDIA_SESSION_HANDLER</link>
88102 #define <link linkend="TP-IFACE-MEDIA-STREAM-HANDLER--CAPS">TP_IFACE_MEDIA_STREAM_HANDLER</link>
89103 #define <link linkend="TP-IFACE-QUARK-MEDIA-STREAM-HANDLER--CAPS">TP_IFACE_QUARK_MEDIA_STREAM_HANDLER</link>
90104 #define <link linkend="TP-IFACE-PROPERTIES-INTERFACE--CAPS">TP_IFACE_PROPERTIES_INTERFACE</link>
91105 #define <link linkend="TP-IFACE-QUARK-PROPERTIES-INTERFACE--CAPS">TP_IFACE_QUARK_PROPERTIES_INTERFACE</link>
106 #define <link linkend="TP-IFACE-CLIENT--CAPS">TP_IFACE_CLIENT</link>
107 #define <link linkend="TP-IFACE-QUARK-CLIENT--CAPS">TP_IFACE_QUARK_CLIENT</link>
108 #define <link linkend="TP-IFACE-CLIENT-APPROVER--CAPS">TP_IFACE_CLIENT_APPROVER</link>
109 #define <link linkend="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS">TP_IFACE_QUARK_CLIENT_APPROVER</link>
110 #define <link linkend="TP-IFACE-CLIENT-HANDLER--CAPS">TP_IFACE_CLIENT_HANDLER</link>
111 #define <link linkend="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS">TP_IFACE_QUARK_CLIENT_HANDLER</link>
112 #define <link linkend="TP-IFACE-CLIENT-OBSERVER--CAPS">TP_IFACE_CLIENT_OBSERVER</link>
113 #define <link linkend="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS">TP_IFACE_QUARK_CLIENT_OBSERVER</link>
114 #define <link linkend="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS">TP_IFACE_CLIENT_INTERFACE_REQUESTS</link>
115 #define <link linkend="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS">TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</link>
92116 </synopsis>
93117 </refsynopsisdiv>
94118
117141
118142 <refsect1 id="telepathy-glib-interfaces.details" role="details">
119143 <title role="details.title">Details</title>
144 <refsect2 id="TP-IFACE-ACCOUNT--CAPS" role="macro">
145 <title>TP_IFACE_ACCOUNT</title>
146 <indexterm zone="TP-IFACE-ACCOUNT--CAPS"><primary sortas="TP_IFACE_ACCOUNT">TP_IFACE_ACCOUNT</primary></indexterm><programlisting>#define TP_IFACE_ACCOUNT</programlisting>
147 <para>
148 The interface name "org.freedesktop.Telepathy.Account"</para>
149 <para>
150 </para></refsect2>
151 <refsect2 id="TP-IFACE-QUARK-ACCOUNT--CAPS" role="macro">
152 <title>TP_IFACE_QUARK_ACCOUNT</title>
153 <indexterm zone="TP-IFACE-QUARK-ACCOUNT--CAPS"><primary sortas="TP_IFACE_QUARK_ACCOUNT">TP_IFACE_QUARK_ACCOUNT</primary></indexterm><programlisting>#define TP_IFACE_QUARK_ACCOUNT</programlisting>
154 <para>
155 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Account"</para>
156 <para>
157 </para></refsect2>
158 <refsect2 id="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS" role="macro">
159 <title>TP_IFACE_ACCOUNT_INTERFACE_AVATAR</title>
160 <indexterm zone="TP-IFACE-ACCOUNT-INTERFACE-AVATAR--CAPS"><primary sortas="TP_IFACE_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_ACCOUNT_INTERFACE_AVATAR</primary></indexterm><programlisting>#define TP_IFACE_ACCOUNT_INTERFACE_AVATAR</programlisting>
161 <para>
162 The interface name "org.freedesktop.Telepathy.Account.Interface.Avatar"</para>
163 <para>
164 </para></refsect2>
165 <refsect2 id="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS" role="macro">
166 <title>TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</title>
167 <indexterm zone="TP-IFACE-QUARK-ACCOUNT-INTERFACE-AVATAR--CAPS"><primary sortas="TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR">TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</primary></indexterm><programlisting>#define TP_IFACE_QUARK_ACCOUNT_INTERFACE_AVATAR</programlisting>
168 <para>
169 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Account.Interface.Avatar"</para>
170 <para>
171 </para></refsect2>
172 <refsect2 id="TP-IFACE-ACCOUNT-MANAGER--CAPS" role="macro">
173 <title>TP_IFACE_ACCOUNT_MANAGER</title>
174 <indexterm zone="TP-IFACE-ACCOUNT-MANAGER--CAPS"><primary sortas="TP_IFACE_ACCOUNT_MANAGER">TP_IFACE_ACCOUNT_MANAGER</primary></indexterm><programlisting>#define TP_IFACE_ACCOUNT_MANAGER</programlisting>
175 <para>
176 The interface name "org.freedesktop.Telepathy.AccountManager"</para>
177 <para>
178 </para></refsect2>
179 <refsect2 id="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS" role="macro">
180 <title>TP_IFACE_QUARK_ACCOUNT_MANAGER</title>
181 <indexterm zone="TP-IFACE-QUARK-ACCOUNT-MANAGER--CAPS"><primary sortas="TP_IFACE_QUARK_ACCOUNT_MANAGER">TP_IFACE_QUARK_ACCOUNT_MANAGER</primary></indexterm><programlisting>#define TP_IFACE_QUARK_ACCOUNT_MANAGER</programlisting>
182 <para>
183 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.AccountManager"</para>
184 <para>
185 </para></refsect2>
120186 <refsect2 id="TP-IFACE-DBUS-DAEMON--CAPS" role="macro">
121187 <title>TP_IFACE_DBUS_DAEMON</title>
122188 <indexterm zone="TP-IFACE-DBUS-DAEMON--CAPS"><primary sortas="TP_IFACE_DBUS_DAEMON">TP_IFACE_DBUS_DAEMON</primary></indexterm><programlisting>#define TP_IFACE_DBUS_DAEMON</programlisting>
565631 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Channel.Interface.Messages"</para>
566632 <para>
567633 </para></refsect2>
634 <refsect2 id="TP-IFACE-CHANNEL-DISPATCHER--CAPS" role="macro">
635 <title>TP_IFACE_CHANNEL_DISPATCHER</title>
636 <indexterm zone="TP-IFACE-CHANNEL-DISPATCHER--CAPS"><primary sortas="TP_IFACE_CHANNEL_DISPATCHER">TP_IFACE_CHANNEL_DISPATCHER</primary></indexterm><programlisting>#define TP_IFACE_CHANNEL_DISPATCHER</programlisting>
637 <para>
638 The interface name "org.freedesktop.Telepathy.ChannelDispatcher"</para>
639 <para>
640 </para></refsect2>
641 <refsect2 id="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS" role="macro">
642 <title>TP_IFACE_QUARK_CHANNEL_DISPATCHER</title>
643 <indexterm zone="TP-IFACE-QUARK-CHANNEL-DISPATCHER--CAPS"><primary sortas="TP_IFACE_QUARK_CHANNEL_DISPATCHER">TP_IFACE_QUARK_CHANNEL_DISPATCHER</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CHANNEL_DISPATCHER</programlisting>
644 <para>
645 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatcher"</para>
646 <para>
647 </para></refsect2>
648 <refsect2 id="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" role="macro">
649 <title>TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</title>
650 <indexterm zone="TP-IFACE-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"><primary sortas="TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</primary></indexterm><programlisting>#define TP_IFACE_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</programlisting>
651 <para>
652 The interface name "org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList"</para>
653 <para>
654 </para></refsect2>
655 <refsect2 id="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS" role="macro">
656 <title>TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</title>
657 <indexterm zone="TP-IFACE-QUARK-CHANNEL-DISPATCHER-INTERFACE-OPERATION-LIST--CAPS"><primary sortas="TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST">TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CHANNEL_DISPATCHER_INTERFACE_OPERATION_LIST</programlisting>
658 <para>
659 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList"</para>
660 <para>
661 </para></refsect2>
662 <refsect2 id="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS" role="macro">
663 <title>TP_IFACE_CHANNEL_DISPATCH_OPERATION</title>
664 <indexterm zone="TP-IFACE-CHANNEL-DISPATCH-OPERATION--CAPS"><primary sortas="TP_IFACE_CHANNEL_DISPATCH_OPERATION">TP_IFACE_CHANNEL_DISPATCH_OPERATION</primary></indexterm><programlisting>#define TP_IFACE_CHANNEL_DISPATCH_OPERATION</programlisting>
665 <para>
666 The interface name "org.freedesktop.Telepathy.ChannelDispatchOperation"</para>
667 <para>
668 </para></refsect2>
669 <refsect2 id="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS" role="macro">
670 <title>TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</title>
671 <indexterm zone="TP-IFACE-QUARK-CHANNEL-DISPATCH-OPERATION--CAPS"><primary sortas="TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION">TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION</programlisting>
672 <para>
673 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelDispatchOperation"</para>
674 <para>
675 </para></refsect2>
676 <refsect2 id="TP-IFACE-CHANNEL-REQUEST--CAPS" role="macro">
677 <title>TP_IFACE_CHANNEL_REQUEST</title>
678 <indexterm zone="TP-IFACE-CHANNEL-REQUEST--CAPS"><primary sortas="TP_IFACE_CHANNEL_REQUEST">TP_IFACE_CHANNEL_REQUEST</primary></indexterm><programlisting>#define TP_IFACE_CHANNEL_REQUEST</programlisting>
679 <para>
680 The interface name "org.freedesktop.Telepathy.ChannelRequest"</para>
681 <para>
682 </para></refsect2>
683 <refsect2 id="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS" role="macro">
684 <title>TP_IFACE_QUARK_CHANNEL_REQUEST</title>
685 <indexterm zone="TP-IFACE-QUARK-CHANNEL-REQUEST--CAPS"><primary sortas="TP_IFACE_QUARK_CHANNEL_REQUEST">TP_IFACE_QUARK_CHANNEL_REQUEST</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CHANNEL_REQUEST</programlisting>
686 <para>
687 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.ChannelRequest"</para>
688 <para>
689 </para></refsect2>
568690 <refsect2 id="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS" role="macro">
569691 <title>TP_IFACE_MEDIA_SESSION_HANDLER</title>
570692 <indexterm zone="TP-IFACE-MEDIA-SESSION-HANDLER--CAPS"><primary sortas="TP_IFACE_MEDIA_SESSION_HANDLER">TP_IFACE_MEDIA_SESSION_HANDLER</primary></indexterm><programlisting>#define TP_IFACE_MEDIA_SESSION_HANDLER</programlisting>
607729 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Properties"</para>
608730 <para>
609731 </para></refsect2>
732 <refsect2 id="TP-IFACE-CLIENT--CAPS" role="macro">
733 <title>TP_IFACE_CLIENT</title>
734 <indexterm zone="TP-IFACE-CLIENT--CAPS"><primary sortas="TP_IFACE_CLIENT">TP_IFACE_CLIENT</primary></indexterm><programlisting>#define TP_IFACE_CLIENT</programlisting>
735 <para>
736 The interface name "org.freedesktop.Telepathy.Client"</para>
737 <para>
738 </para></refsect2>
739 <refsect2 id="TP-IFACE-QUARK-CLIENT--CAPS" role="macro">
740 <title>TP_IFACE_QUARK_CLIENT</title>
741 <indexterm zone="TP-IFACE-QUARK-CLIENT--CAPS"><primary sortas="TP_IFACE_QUARK_CLIENT">TP_IFACE_QUARK_CLIENT</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CLIENT</programlisting>
742 <para>
743 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client"</para>
744 <para>
745 </para></refsect2>
746 <refsect2 id="TP-IFACE-CLIENT-APPROVER--CAPS" role="macro">
747 <title>TP_IFACE_CLIENT_APPROVER</title>
748 <indexterm zone="TP-IFACE-CLIENT-APPROVER--CAPS"><primary sortas="TP_IFACE_CLIENT_APPROVER">TP_IFACE_CLIENT_APPROVER</primary></indexterm><programlisting>#define TP_IFACE_CLIENT_APPROVER</programlisting>
749 <para>
750 The interface name "org.freedesktop.Telepathy.Client.Approver"</para>
751 <para>
752 </para></refsect2>
753 <refsect2 id="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS" role="macro">
754 <title>TP_IFACE_QUARK_CLIENT_APPROVER</title>
755 <indexterm zone="TP-IFACE-QUARK-CLIENT-APPROVER--CAPS"><primary sortas="TP_IFACE_QUARK_CLIENT_APPROVER">TP_IFACE_QUARK_CLIENT_APPROVER</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CLIENT_APPROVER</programlisting>
756 <para>
757 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Approver"</para>
758 <para>
759 </para></refsect2>
760 <refsect2 id="TP-IFACE-CLIENT-HANDLER--CAPS" role="macro">
761 <title>TP_IFACE_CLIENT_HANDLER</title>
762 <indexterm zone="TP-IFACE-CLIENT-HANDLER--CAPS"><primary sortas="TP_IFACE_CLIENT_HANDLER">TP_IFACE_CLIENT_HANDLER</primary></indexterm><programlisting>#define TP_IFACE_CLIENT_HANDLER</programlisting>
763 <para>
764 The interface name "org.freedesktop.Telepathy.Client.Handler"</para>
765 <para>
766 </para></refsect2>
767 <refsect2 id="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS" role="macro">
768 <title>TP_IFACE_QUARK_CLIENT_HANDLER</title>
769 <indexterm zone="TP-IFACE-QUARK-CLIENT-HANDLER--CAPS"><primary sortas="TP_IFACE_QUARK_CLIENT_HANDLER">TP_IFACE_QUARK_CLIENT_HANDLER</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CLIENT_HANDLER</programlisting>
770 <para>
771 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Handler"</para>
772 <para>
773 </para></refsect2>
774 <refsect2 id="TP-IFACE-CLIENT-OBSERVER--CAPS" role="macro">
775 <title>TP_IFACE_CLIENT_OBSERVER</title>
776 <indexterm zone="TP-IFACE-CLIENT-OBSERVER--CAPS"><primary sortas="TP_IFACE_CLIENT_OBSERVER">TP_IFACE_CLIENT_OBSERVER</primary></indexterm><programlisting>#define TP_IFACE_CLIENT_OBSERVER</programlisting>
777 <para>
778 The interface name "org.freedesktop.Telepathy.Client.Observer"</para>
779 <para>
780 </para></refsect2>
781 <refsect2 id="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS" role="macro">
782 <title>TP_IFACE_QUARK_CLIENT_OBSERVER</title>
783 <indexterm zone="TP-IFACE-QUARK-CLIENT-OBSERVER--CAPS"><primary sortas="TP_IFACE_QUARK_CLIENT_OBSERVER">TP_IFACE_QUARK_CLIENT_OBSERVER</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CLIENT_OBSERVER</programlisting>
784 <para>
785 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Observer"</para>
786 <para>
787 </para></refsect2>
788 <refsect2 id="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS" role="macro">
789 <title>TP_IFACE_CLIENT_INTERFACE_REQUESTS</title>
790 <indexterm zone="TP-IFACE-CLIENT-INTERFACE-REQUESTS--CAPS"><primary sortas="TP_IFACE_CLIENT_INTERFACE_REQUESTS">TP_IFACE_CLIENT_INTERFACE_REQUESTS</primary></indexterm><programlisting>#define TP_IFACE_CLIENT_INTERFACE_REQUESTS</programlisting>
791 <para>
792 The interface name "org.freedesktop.Telepathy.Client.Interface.Requests"</para>
793 <para>
794 </para></refsect2>
795 <refsect2 id="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS" role="macro">
796 <title>TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</title>
797 <indexterm zone="TP-IFACE-QUARK-CLIENT-INTERFACE-REQUESTS--CAPS"><primary sortas="TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS">TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</primary></indexterm><programlisting>#define TP_IFACE_QUARK_CLIENT_INTERFACE_REQUESTS</programlisting>
798 <para>
799 Expands to a call to a function that returns a quark for the interface name "org.freedesktop.Telepathy.Client.Interface.Requests"</para>
800 <para>
801 </para></refsect2>
610802
611803 </refsect1>
612804
2323 const <link linkend="gchar">gchar</link> *unique_name,
2424 const <link linkend="gchar">gchar</link> *object_path,
2525 <link linkend="GError">GError</link> **error);
26 <link linkend="void">void</link> <link linkend="tp-media-session-handler-init-known-interfaces">tp_media_session_handler_init_known_interfaces</link>
27 (void);
2628 <link linkend="TpMediaSessionHandler-struct">TpMediaSessionHandler</link>;
2729 <link linkend="TpMediaSessionHandlerClass">TpMediaSessionHandlerClass</link>;
2830
3032 const <link linkend="gchar">gchar</link> *unique_name,
3133 const <link linkend="gchar">gchar</link> *object_path,
3234 <link linkend="GError">GError</link> **error);
35 <link linkend="void">void</link> <link linkend="tp-media-stream-handler-init-known-interfaces">tp_media_stream_handler_init_known_interfaces</link>
36 (void);
3337 <link linkend="TpMediaStreamHandler-struct">TpMediaStreamHandler</link>;
3438 <link linkend="TpMediaStreamHandlerClass">TpMediaStreamHandlerClass</link>;
3539
511515
512516 </simpara></listitem></varlistentry>
513517 </variablelist><para role="since">Since 0.7.1</para></refsect2>
518 <refsect2 id="tp-media-session-handler-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
519 <title>tp_media_session_handler_init_known_interfaces ()</title>
520 <indexterm zone="tp-media-session-handler-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_media_session_handler_init_known_interfaces">tp_media_session_handler_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_media_session_handler_init_known_interfaces
521 (void);</programlisting>
522 <para>
523 Ensure that the known interfaces for TpMediaSessionHandler have been set up.
524 This is done automatically when necessary, but for correct
525 overriding of library interfaces by local extensions, you should
526 call this function before calling
527 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
528 <link linkend="TP-TYPE-MEDIA-SESSION-HANDLER--CAPS"><literal>TP_TYPE_MEDIA_SESSION_HANDLER</literal></link>.</para>
529 <para>
530 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
514531 <refsect2 id="TpMediaSessionHandler-struct" role="struct">
515532 <title>TpMediaSessionHandler</title>
516533 <indexterm zone="TpMediaSessionHandler-struct" role="0.7.1"><primary sortas="TpMediaSessionHandler">TpMediaSessionHandler</primary></indexterm><programlisting>typedef struct _TpMediaSessionHandler TpMediaSessionHandler;</programlisting>
552569
553570 </simpara></listitem></varlistentry>
554571 </variablelist><para role="since">Since 0.7.1</para></refsect2>
572 <refsect2 id="tp-media-stream-handler-init-known-interfaces" role="function" condition="since:0.7.UNRELEASED">
573 <title>tp_media_stream_handler_init_known_interfaces ()</title>
574 <indexterm zone="tp-media-stream-handler-init-known-interfaces" role="0.7.UNRELEASED"><primary sortas="tp_media_stream_handler_init_known_interfaces">tp_media_stream_handler_init_known_interfaces</primary></indexterm><programlisting><link linkend="void">void</link> tp_media_stream_handler_init_known_interfaces
575 (void);</programlisting>
576 <para>
577 Ensure that the known interfaces for TpMediaStreamHandler have been set up.
578 This is done automatically when necessary, but for correct
579 overriding of library interfaces by local extensions, you should
580 call this function before calling
581 <link linkend="tp-proxy-or-subclass-hook-on-interface-add"><function>tp_proxy_or_subclass_hook_on_interface_add()</function></link> with first argument
582 <link linkend="TP-TYPE-MEDIA-STREAM-HANDLER--CAPS"><literal>TP_TYPE_MEDIA_STREAM_HANDLER</literal></link>.</para>
583 <para>
584 </para><para role="since">Since 0.7.UNRELEASED</para></refsect2>
555585 <refsect2 id="TpMediaStreamHandler-struct" role="struct">
556586 <title>TpMediaStreamHandler</title>
557587 <indexterm zone="TpMediaStreamHandler-struct" role="0.7.1"><primary sortas="TpMediaStreamHandler">TpMediaStreamHandler</primary></indexterm><programlisting>typedef struct _TpMediaStreamHandler TpMediaStreamHandler;</programlisting>
4848 <synopsis>
4949 <link linkend="GObject">GObject</link>
5050 +----TpProxy
51 +----<link linkend="TpAccount">TpAccount</link>
52 +----<link linkend="TpAccountManager">TpAccountManager</link>
5153 +----<link linkend="TpChannel">TpChannel</link>
54 +----<link linkend="TpChannelDispatcher">TpChannelDispatcher</link>
55 +----<link linkend="TpChannelDispatchOperation">TpChannelDispatchOperation</link>
56 +----<link linkend="TpChannelRequest">TpChannelRequest</link>
57 +----<link linkend="TpClient">TpClient</link>
5258 +----<link linkend="TpConnection">TpConnection</link>
5359 +----<link linkend="TpConnectionManager">TpConnectionManager</link>
5460 +----<link linkend="TpDBusDaemon">TpDBusDaemon</link>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-account-manager">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-account-manager.top_of_page">Service-side Account Manager interface</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Account Manager interface</refname>
12 <refpurpose>GInterface for Telepathy AccountManager objects</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-account-manager.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcAccountManager"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-account-manager.h&gt;
21
22 <link linkend="TpSvcAccountManager-struct">TpSvcAccountManager</link>;
23 <link linkend="TpSvcAccountManagerClass">TpSvcAccountManagerClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-svc-account-manager-emit-account-removed">tp_svc_account_manager_emit_account_removed</link>
25 (<link linkend="gpointer">gpointer</link> instance,
26 const <link linkend="gchar">gchar</link> *arg_Account);
27 <link linkend="void">void</link> <link linkend="tp-svc-account-manager-emit-account-validity-changed">tp_svc_account_manager_emit_account_validity_changed</link>
28 (<link linkend="gpointer">gpointer</link> instance,
29 const <link linkend="gchar">gchar</link> *arg_Account,
30 <link linkend="gboolean">gboolean</link> arg_Valid);
31 <link linkend="void">void</link> (<link linkend="tp-svc-account-manager-create-account-impl">*tp_svc_account_manager_create_account_impl</link>)
32 (<link linkend="TpSvcAccountManager">TpSvcAccountManager</link> *self,
33 const <link linkend="gchar">gchar</link> *in_Connection_Manager,
34 const <link linkend="gchar">gchar</link> *in_Protocol,
35 const <link linkend="gchar">gchar</link> *in_Display_Name,
36 <link linkend="GHashTable">GHashTable</link> *in_Parameters,
37 <link linkend="GHashTable">GHashTable</link> *in_Properties,
38 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
39 <link linkend="void">void</link> <link linkend="tp-svc-account-manager-return-from-create-account">tp_svc_account_manager_return_from_create_account</link>
40 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
41 const <link linkend="gchar">gchar</link> *out_Account);
42 <link linkend="void">void</link> <link linkend="tp-svc-account-manager-implement-create-account">tp_svc_account_manager_implement_create_account</link>
43 (<link linkend="TpSvcAccountManagerClass">TpSvcAccountManagerClass</link> *klass,
44 <link linkend="tp-svc-account-manager-create-account-impl">tp_svc_account_manager_create_account_impl</link> impl);
45 </synopsis>
46 </refsynopsisdiv>
47
48 <refsect1 id="telepathy-glib-svc-account-manager.object-hierarchy" role="object_hierarchy">
49 <title role="object_hierarchy.title">Object Hierarchy</title>
50 <synopsis>
51 <link linkend="GInterface">GInterface</link>
52 +----TpSvcAccountManager
53 </synopsis>
54 </refsect1>
55
56
57
58
59
60
61 <refsect1 id="telepathy-glib-svc-account-manager.signals" role="signal_proto">
62 <title role="signal_proto.title">Signals</title>
63 <synopsis>
64 &quot;<link linkend="TpSvcAccountManager-account-removed">account-removed</link>&quot; : Run Last / Has Details
65 &quot;<link linkend="TpSvcAccountManager-account-validity-changed">account-validity-changed</link>&quot; : Run Last / Has Details
66 </synopsis>
67 </refsect1>
68
69
70 <refsect1 id="telepathy-glib-svc-account-manager.description" role="desc">
71 <title role="desc.title">Description</title>
72 <para>
73 The <link linkend="TpSvcAccountManager"><type>TpSvcAccountManager</type></link> interface (auto-generated from the Telepathy
74 spec) makes it easier to export an object implementing the Telepathy
75 AccountManager interface, with the correct method and signal signatures,
76 and emit signals from that object in a type-safe way.
77 </para>
78 <para>
79 You don't need these interfaces unless you're implementing a
80 Telepathy AccountManager, such as Mission Control.</para>
81 <para>
82 </para>
83 </refsect1>
84
85 <refsect1 id="telepathy-glib-svc-account-manager.details" role="details">
86 <title role="details.title">Details</title>
87 <refsect2 id="TpSvcAccountManager-struct" role="struct">
88 <title>TpSvcAccountManager</title>
89 <indexterm zone="TpSvcAccountManager-struct"><primary sortas="TpSvcAccountManager">TpSvcAccountManager</primary></indexterm><programlisting>typedef struct _TpSvcAccountManager TpSvcAccountManager;</programlisting>
90 <para>
91 Dummy typedef representing any implementation of this interface.</para>
92 <para>
93 </para></refsect2>
94 <refsect2 id="TpSvcAccountManagerClass" role="struct">
95 <title>TpSvcAccountManagerClass</title>
96 <indexterm zone="TpSvcAccountManagerClass"><primary sortas="TpSvcAccountManagerClass">TpSvcAccountManagerClass</primary></indexterm><programlisting>typedef struct _TpSvcAccountManagerClass TpSvcAccountManagerClass;</programlisting>
97 <para>
98 The class of TpSvcAccountManager.</para>
99 <para>
100 </para></refsect2>
101 <refsect2 id="tp-svc-account-manager-emit-account-removed" role="function">
102 <title>tp_svc_account_manager_emit_account_removed ()</title>
103 <indexterm zone="tp-svc-account-manager-emit-account-removed"><primary sortas="tp_svc_account_manager_emit_account_removed">tp_svc_account_manager_emit_account_removed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_manager_emit_account_removed
104 (<link linkend="gpointer">gpointer</link> instance,
105 const <link linkend="gchar">gchar</link> *arg_Account);</programlisting>
106 <para>
107 Type-safe wrapper around g_signal_emit to emit the
108 AccountRemoved signal on interface org.freedesktop.Telepathy.AccountManager.</para>
109 <para>
110 </para><variablelist role="params">
111 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
112 <listitem><simpara> The object implementing this interface
113 </simpara></listitem></varlistentry>
114 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
115 <listitem><simpara> const gchar * (FIXME, generate documentation)
116 </simpara></listitem></varlistentry>
117 </variablelist></refsect2>
118 <refsect2 id="tp-svc-account-manager-emit-account-validity-changed" role="function">
119 <title>tp_svc_account_manager_emit_account_validity_changed ()</title>
120 <indexterm zone="tp-svc-account-manager-emit-account-validity-changed"><primary sortas="tp_svc_account_manager_emit_account_validity_changed">tp_svc_account_manager_emit_account_validity_changed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_manager_emit_account_validity_changed
121 (<link linkend="gpointer">gpointer</link> instance,
122 const <link linkend="gchar">gchar</link> *arg_Account,
123 <link linkend="gboolean">gboolean</link> arg_Valid);</programlisting>
124 <para>
125 Type-safe wrapper around g_signal_emit to emit the
126 AccountValidityChanged signal on interface org.freedesktop.Telepathy.AccountManager.</para>
127 <para>
128 </para><variablelist role="params">
129 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
130 <listitem><simpara> The object implementing this interface
131 </simpara></listitem></varlistentry>
132 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
133 <listitem><simpara> const gchar * (FIXME, generate documentation)
134 </simpara></listitem></varlistentry>
135 <varlistentry><term><parameter>arg_Valid</parameter>&#160;:</term>
136 <listitem><simpara> gboolean (FIXME, generate documentation)
137 </simpara></listitem></varlistentry>
138 </variablelist></refsect2>
139 <refsect2 id="tp-svc-account-manager-create-account-impl" role="function">
140 <title>tp_svc_account_manager_create_account_impl ()</title>
141 <indexterm zone="tp-svc-account-manager-create-account-impl"><primary sortas="tp_svc_account_manager_create_account_impl">tp_svc_account_manager_create_account_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_account_manager_create_account_impl)
142 (<link linkend="TpSvcAccountManager">TpSvcAccountManager</link> *self,
143 const <link linkend="gchar">gchar</link> *in_Connection_Manager,
144 const <link linkend="gchar">gchar</link> *in_Protocol,
145 const <link linkend="gchar">gchar</link> *in_Display_Name,
146 <link linkend="GHashTable">GHashTable</link> *in_Parameters,
147 <link linkend="GHashTable">GHashTable</link> *in_Properties,
148 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
149 <para>
150 The signature of an implementation of the D-Bus method
151 CreateAccount on interface org.freedesktop.Telepathy.AccountManager.</para>
152 <para>
153 </para><variablelist role="params">
154 <varlistentry><term><parameter>self</parameter>&#160;:</term>
155 <listitem><simpara> The object implementing this interface
156 </simpara></listitem></varlistentry>
157 <varlistentry><term><parameter>in_Connection_Manager</parameter>&#160;:</term>
158 <listitem><simpara> const gchar * (FIXME, generate documentation)
159 </simpara></listitem></varlistentry>
160 <varlistentry><term><parameter>in_Protocol</parameter>&#160;:</term>
161 <listitem><simpara> const gchar * (FIXME, generate documentation)
162 </simpara></listitem></varlistentry>
163 <varlistentry><term><parameter>in_Display_Name</parameter>&#160;:</term>
164 <listitem><simpara> const gchar * (FIXME, generate documentation)
165 </simpara></listitem></varlistentry>
166 <varlistentry><term><parameter>in_Parameters</parameter>&#160;:</term>
167 <listitem><simpara> GHashTable * (FIXME, generate documentation)
168 </simpara></listitem></varlistentry>
169 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
170 <listitem><simpara> GHashTable * (FIXME, generate documentation)
171 </simpara></listitem></varlistentry>
172 <varlistentry><term><parameter>context</parameter>&#160;:</term>
173 <listitem><simpara> Used to return values or throw an error
174 </simpara></listitem></varlistentry>
175 </variablelist></refsect2>
176 <refsect2 id="tp-svc-account-manager-return-from-create-account" role="function">
177 <title>tp_svc_account_manager_return_from_create_account ()</title>
178 <indexterm zone="tp-svc-account-manager-return-from-create-account"><primary sortas="tp_svc_account_manager_return_from_create_account">tp_svc_account_manager_return_from_create_account</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_manager_return_from_create_account
179 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
180 const <link linkend="gchar">gchar</link> *out_Account);</programlisting>
181 <para>
182 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
183 This inline function exists only to provide type-safety.</para>
184 <para>
185 </para><variablelist role="params">
186 <varlistentry><term><parameter>context</parameter>&#160;:</term>
187 <listitem><simpara> The D-Bus method invocation context
188 </simpara></listitem></varlistentry>
189 <varlistentry><term><parameter>out_Account</parameter>&#160;:</term>
190 <listitem><simpara> const gchar * (FIXME, generate documentation)
191 </simpara></listitem></varlistentry>
192 </variablelist></refsect2>
193 <refsect2 id="tp-svc-account-manager-implement-create-account" role="function">
194 <title>tp_svc_account_manager_implement_create_account ()</title>
195 <indexterm zone="tp-svc-account-manager-implement-create-account"><primary sortas="tp_svc_account_manager_implement_create_account">tp_svc_account_manager_implement_create_account</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_manager_implement_create_account
196 (<link linkend="TpSvcAccountManagerClass">TpSvcAccountManagerClass</link> *klass,
197 <link linkend="tp-svc-account-manager-create-account-impl">tp_svc_account_manager_create_account_impl</link> impl);</programlisting>
198 <para>
199 Register an implementation for the CreateAccount method in the vtable
200 of an implementation of this interface. To be called from
201 the interface init function.</para>
202 <para>
203 </para><variablelist role="params">
204 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
205 <listitem><simpara> A class whose instances implement this interface
206 </simpara></listitem></varlistentry>
207 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
208 <listitem><simpara> A callback used to implement the CreateAccount D-Bus method
209 </simpara></listitem></varlistentry>
210 </variablelist></refsect2>
211
212 </refsect1>
213
214 <refsect1 id="telepathy-glib-svc-account-manager.signal-details" role="signals">
215 <title role="signals.title">Signal Details</title>
216 <refsect2 id="TpSvcAccountManager-account-removed" role="signal"><title>The <literal>&quot;account-removed&quot;</literal> signal</title>
217 <indexterm zone="TpSvcAccountManager-account-removed"><primary sortas="TpSvcAccountManager::account-removed">TpSvcAccountManager::account-removed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcAccountManager">TpSvcAccountManager</link> *arg_Account,
218 <link linkend="DBusGObjectPath">DBusGObjectPath</link> *arg1,
219 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
220 <para>
221 The AccountRemoved D-Bus signal is emitted whenever this GObject signal is.</para>
222 <para>
223 </para><variablelist role="params">
224 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
225 <listitem><simpara> const gchar * (FIXME, generate documentation)
226 </simpara></listitem></varlistentry>
227 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
228 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
229 </variablelist></refsect2><refsect2 id="TpSvcAccountManager-account-validity-changed" role="signal"><title>The <literal>&quot;account-validity-changed&quot;</literal> signal</title>
230 <indexterm zone="TpSvcAccountManager-account-validity-changed"><primary sortas="TpSvcAccountManager::account-validity-changed">TpSvcAccountManager::account-validity-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcAccountManager">TpSvcAccountManager</link> *arg_Account,
231 <link linkend="DBusGObjectPath">DBusGObjectPath</link> *arg_Valid,
232 <link linkend="gboolean">gboolean</link> arg2,
233 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
234 <para>
235 The AccountValidityChanged D-Bus signal is emitted whenever this GObject signal is.</para>
236 <para>
237 </para><variablelist role="params">
238 <varlistentry><term><parameter>arg_Account</parameter>&#160;:</term>
239 <listitem><simpara> const gchar * (FIXME, generate documentation)
240 </simpara></listitem></varlistentry>
241 <varlistentry><term><parameter>arg_Valid</parameter>&#160;:</term>
242 <listitem><simpara> gboolean (FIXME, generate documentation)
243 </simpara></listitem></varlistentry>
244 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
245 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
246 </variablelist></refsect2>
247 </refsect1>
248
249
250
251 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-account">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-account.top_of_page">Service-side Account interfaces</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Account interfaces</refname>
12 <refpurpose>GInterfaces for Telepathy Account objects</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-account.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcAccount"/><anchor id="TpSvcAccountInterfaceAvatar"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-account.h&gt;
21
22 <link linkend="TpSvcAccount-struct">TpSvcAccount</link>;
23 <link linkend="TpSvcAccountClass">TpSvcAccountClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-svc-account-emit-account-property-changed">tp_svc_account_emit_account_property_changed</link>
25 (<link linkend="gpointer">gpointer</link> instance,
26 <link linkend="GHashTable">GHashTable</link> *arg_Properties);
27 <link linkend="void">void</link> <link linkend="tp-svc-account-emit-removed">tp_svc_account_emit_removed</link> (<link linkend="gpointer">gpointer</link> instance);
28 <link linkend="void">void</link> (<link linkend="tp-svc-account-reconnect-impl">*tp_svc_account_reconnect_impl</link>) (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
29 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
30 <link linkend="void">void</link> <link linkend="tp-svc-account-return-from-reconnect">tp_svc_account_return_from_reconnect</link>
31 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
32 <link linkend="void">void</link> <link linkend="tp-svc-account-implement-reconnect">tp_svc_account_implement_reconnect</link> (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
33 <link linkend="tp-svc-account-reconnect-impl">tp_svc_account_reconnect_impl</link> impl);
34 <link linkend="void">void</link> (<link linkend="tp-svc-account-remove-impl">*tp_svc_account_remove_impl</link>) (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
35 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
36 <link linkend="void">void</link> <link linkend="tp-svc-account-return-from-remove">tp_svc_account_return_from_remove</link> (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
37 <link linkend="void">void</link> <link linkend="tp-svc-account-implement-remove">tp_svc_account_implement_remove</link> (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
38 <link linkend="tp-svc-account-remove-impl">tp_svc_account_remove_impl</link> impl);
39 <link linkend="void">void</link> (<link linkend="tp-svc-account-update-parameters-impl">*tp_svc_account_update_parameters_impl</link>)
40 (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
41 <link linkend="GHashTable">GHashTable</link> *in_Set,
42 const <link linkend="gchar">gchar</link> **in_Unset,
43 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
44 <link linkend="void">void</link> <link linkend="tp-svc-account-return-from-update-parameters">tp_svc_account_return_from_update_parameters</link>
45 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
46 const <link linkend="gchar">gchar</link> **out_Reconnect_Required);
47 <link linkend="void">void</link> <link linkend="tp-svc-account-implement-update-parameters">tp_svc_account_implement_update_parameters</link>
48 (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
49 <link linkend="tp-svc-account-update-parameters-impl">tp_svc_account_update_parameters_impl</link> impl);
50
51
52 <link linkend="TpSvcAccountInterfaceAvatar-struct">TpSvcAccountInterfaceAvatar</link>;
53 <link linkend="TpSvcAccountInterfaceAvatarClass">TpSvcAccountInterfaceAvatarClass</link>;
54 <link linkend="void">void</link> <link linkend="tp-svc-account-interface-avatar-emit-avatar-changed">tp_svc_account_interface_avatar_emit_avatar_changed</link>
55 (<link linkend="gpointer">gpointer</link> instance);
56 </synopsis>
57 </refsynopsisdiv>
58
59 <refsect1 id="telepathy-glib-svc-account.object-hierarchy" role="object_hierarchy">
60 <title role="object_hierarchy.title">Object Hierarchy</title>
61 <synopsis>
62 <link linkend="GInterface">GInterface</link>
63 +----TpSvcAccount
64 </synopsis>
65 <synopsis>
66 <link linkend="GInterface">GInterface</link>
67 +----TpSvcAccountInterfaceAvatar
68 </synopsis>
69 </refsect1>
70
71
72
73
74
75
76 <refsect1 id="telepathy-glib-svc-account.signals" role="signal_proto">
77 <title role="signal_proto.title">Signals</title>
78 <synopsis>
79 &quot;<link linkend="TpSvcAccount-account-property-changed">account-property-changed</link>&quot; : Run Last / Has Details
80 &quot;<link linkend="TpSvcAccount-removed">removed</link>&quot; : Run Last / Has Details
81 &quot;<link linkend="TpSvcAccountInterfaceAvatar-avatar-changed">avatar-changed</link>&quot; : Run Last / Has Details
82 </synopsis>
83 </refsect1>
84
85
86 <refsect1 id="telepathy-glib-svc-account.description" role="desc">
87 <title role="desc.title">Description</title>
88 <para>
89 These interfaces (auto-generated from the Telepathy spec) make it easier
90 to export objects implementing the Telepathy Account and its
91 optional interfaces, with the correct method and signal signatures,
92 and emit signals from those objects in a type-safe way.
93 </para>
94 <para>
95 You don't need these interfaces unless you're implementing a
96 Telepathy AccountManager, such as Mission Control.</para>
97 <para>
98 </para>
99 </refsect1>
100
101 <refsect1 id="telepathy-glib-svc-account.details" role="details">
102 <title role="details.title">Details</title>
103 <refsect2 id="TpSvcAccount-struct" role="struct">
104 <title>TpSvcAccount</title>
105 <indexterm zone="TpSvcAccount-struct"><primary sortas="TpSvcAccount">TpSvcAccount</primary></indexterm><programlisting>typedef struct _TpSvcAccount TpSvcAccount;</programlisting>
106 <para>
107 Dummy typedef representing any implementation of this interface.</para>
108 <para>
109 </para></refsect2>
110 <refsect2 id="TpSvcAccountClass" role="struct">
111 <title>TpSvcAccountClass</title>
112 <indexterm zone="TpSvcAccountClass"><primary sortas="TpSvcAccountClass">TpSvcAccountClass</primary></indexterm><programlisting>typedef struct _TpSvcAccountClass TpSvcAccountClass;</programlisting>
113 <para>
114 The class of TpSvcAccount.</para>
115 <para>
116 </para></refsect2>
117 <refsect2 id="tp-svc-account-emit-account-property-changed" role="function">
118 <title>tp_svc_account_emit_account_property_changed ()</title>
119 <indexterm zone="tp-svc-account-emit-account-property-changed"><primary sortas="tp_svc_account_emit_account_property_changed">tp_svc_account_emit_account_property_changed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_emit_account_property_changed
120 (<link linkend="gpointer">gpointer</link> instance,
121 <link linkend="GHashTable">GHashTable</link> *arg_Properties);</programlisting>
122 <para>
123 Type-safe wrapper around g_signal_emit to emit the
124 AccountPropertyChanged signal on interface org.freedesktop.Telepathy.Account.</para>
125 <para>
126 </para><variablelist role="params">
127 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
128 <listitem><simpara> The object implementing this interface
129 </simpara></listitem></varlistentry>
130 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
131 <listitem><simpara> GHashTable * (FIXME, generate documentation)
132 </simpara></listitem></varlistentry>
133 </variablelist></refsect2>
134 <refsect2 id="tp-svc-account-emit-removed" role="function">
135 <title>tp_svc_account_emit_removed ()</title>
136 <indexterm zone="tp-svc-account-emit-removed"><primary sortas="tp_svc_account_emit_removed">tp_svc_account_emit_removed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_emit_removed (<link linkend="gpointer">gpointer</link> instance);</programlisting>
137 <para>
138 Type-safe wrapper around g_signal_emit to emit the
139 Removed signal on interface org.freedesktop.Telepathy.Account.</para>
140 <para>
141 </para><variablelist role="params">
142 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
143 <listitem><simpara> The object implementing this interface
144 </simpara></listitem></varlistentry>
145 </variablelist></refsect2>
146 <refsect2 id="tp-svc-account-reconnect-impl" role="function">
147 <title>tp_svc_account_reconnect_impl ()</title>
148 <indexterm zone="tp-svc-account-reconnect-impl"><primary sortas="tp_svc_account_reconnect_impl">tp_svc_account_reconnect_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_account_reconnect_impl) (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
149 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
150 <para>
151 The signature of an implementation of the D-Bus method
152 Reconnect on interface org.freedesktop.Telepathy.Account.</para>
153 <para>
154 </para><variablelist role="params">
155 <varlistentry><term><parameter>self</parameter>&#160;:</term>
156 <listitem><simpara> The object implementing this interface
157 </simpara></listitem></varlistentry>
158 <varlistentry><term><parameter>context</parameter>&#160;:</term>
159 <listitem><simpara> Used to return values or throw an error
160 </simpara></listitem></varlistentry>
161 </variablelist></refsect2>
162 <refsect2 id="tp-svc-account-return-from-reconnect" role="function">
163 <title>tp_svc_account_return_from_reconnect ()</title>
164 <indexterm zone="tp-svc-account-return-from-reconnect"><primary sortas="tp_svc_account_return_from_reconnect">tp_svc_account_return_from_reconnect</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_return_from_reconnect
165 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
166 <para>
167 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
168 This inline function exists only to provide type-safety.</para>
169 <para>
170 </para><variablelist role="params">
171 <varlistentry><term><parameter>context</parameter>&#160;:</term>
172 <listitem><simpara> The D-Bus method invocation context
173 </simpara></listitem></varlistentry>
174 </variablelist></refsect2>
175 <refsect2 id="tp-svc-account-implement-reconnect" role="function">
176 <title>tp_svc_account_implement_reconnect ()</title>
177 <indexterm zone="tp-svc-account-implement-reconnect"><primary sortas="tp_svc_account_implement_reconnect">tp_svc_account_implement_reconnect</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_implement_reconnect (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
178 <link linkend="tp-svc-account-reconnect-impl">tp_svc_account_reconnect_impl</link> impl);</programlisting>
179 <para>
180 Register an implementation for the Reconnect method in the vtable
181 of an implementation of this interface. To be called from
182 the interface init function.</para>
183 <para>
184 </para><variablelist role="params">
185 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
186 <listitem><simpara> A class whose instances implement this interface
187 </simpara></listitem></varlistentry>
188 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
189 <listitem><simpara> A callback used to implement the Reconnect D-Bus method
190 </simpara></listitem></varlistentry>
191 </variablelist></refsect2>
192 <refsect2 id="tp-svc-account-remove-impl" role="function">
193 <title>tp_svc_account_remove_impl ()</title>
194 <indexterm zone="tp-svc-account-remove-impl"><primary sortas="tp_svc_account_remove_impl">tp_svc_account_remove_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_account_remove_impl) (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
195 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
196 <para>
197 The signature of an implementation of the D-Bus method
198 Remove on interface org.freedesktop.Telepathy.Account.</para>
199 <para>
200 </para><variablelist role="params">
201 <varlistentry><term><parameter>self</parameter>&#160;:</term>
202 <listitem><simpara> The object implementing this interface
203 </simpara></listitem></varlistentry>
204 <varlistentry><term><parameter>context</parameter>&#160;:</term>
205 <listitem><simpara> Used to return values or throw an error
206 </simpara></listitem></varlistentry>
207 </variablelist></refsect2>
208 <refsect2 id="tp-svc-account-return-from-remove" role="function">
209 <title>tp_svc_account_return_from_remove ()</title>
210 <indexterm zone="tp-svc-account-return-from-remove"><primary sortas="tp_svc_account_return_from_remove">tp_svc_account_return_from_remove</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_return_from_remove (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
211 <para>
212 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
213 This inline function exists only to provide type-safety.</para>
214 <para>
215 </para><variablelist role="params">
216 <varlistentry><term><parameter>context</parameter>&#160;:</term>
217 <listitem><simpara> The D-Bus method invocation context
218 </simpara></listitem></varlistentry>
219 </variablelist></refsect2>
220 <refsect2 id="tp-svc-account-implement-remove" role="function">
221 <title>tp_svc_account_implement_remove ()</title>
222 <indexterm zone="tp-svc-account-implement-remove"><primary sortas="tp_svc_account_implement_remove">tp_svc_account_implement_remove</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_implement_remove (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
223 <link linkend="tp-svc-account-remove-impl">tp_svc_account_remove_impl</link> impl);</programlisting>
224 <para>
225 Register an implementation for the Remove method in the vtable
226 of an implementation of this interface. To be called from
227 the interface init function.</para>
228 <para>
229 </para><variablelist role="params">
230 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
231 <listitem><simpara> A class whose instances implement this interface
232 </simpara></listitem></varlistentry>
233 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
234 <listitem><simpara> A callback used to implement the Remove D-Bus method
235 </simpara></listitem></varlistentry>
236 </variablelist></refsect2>
237 <refsect2 id="tp-svc-account-update-parameters-impl" role="function">
238 <title>tp_svc_account_update_parameters_impl ()</title>
239 <indexterm zone="tp-svc-account-update-parameters-impl"><primary sortas="tp_svc_account_update_parameters_impl">tp_svc_account_update_parameters_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_account_update_parameters_impl)
240 (<link linkend="TpSvcAccount">TpSvcAccount</link> *self,
241 <link linkend="GHashTable">GHashTable</link> *in_Set,
242 const <link linkend="gchar">gchar</link> **in_Unset,
243 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
244 <para>
245 The signature of an implementation of the D-Bus method
246 UpdateParameters on interface org.freedesktop.Telepathy.Account.</para>
247 <para>
248 </para><variablelist role="params">
249 <varlistentry><term><parameter>self</parameter>&#160;:</term>
250 <listitem><simpara> The object implementing this interface
251 </simpara></listitem></varlistentry>
252 <varlistentry><term><parameter>in_Set</parameter>&#160;:</term>
253 <listitem><simpara> GHashTable * (FIXME, generate documentation)
254 </simpara></listitem></varlistentry>
255 <varlistentry><term><parameter>in_Unset</parameter>&#160;:</term>
256 <listitem><simpara> const gchar ** (FIXME, generate documentation)
257 </simpara></listitem></varlistentry>
258 <varlistentry><term><parameter>context</parameter>&#160;:</term>
259 <listitem><simpara> Used to return values or throw an error
260 </simpara></listitem></varlistentry>
261 </variablelist></refsect2>
262 <refsect2 id="tp-svc-account-return-from-update-parameters" role="function">
263 <title>tp_svc_account_return_from_update_parameters ()</title>
264 <indexterm zone="tp-svc-account-return-from-update-parameters"><primary sortas="tp_svc_account_return_from_update_parameters">tp_svc_account_return_from_update_parameters</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_return_from_update_parameters
265 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
266 const <link linkend="gchar">gchar</link> **out_Reconnect_Required);</programlisting>
267 <para>
268 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
269 This inline function exists only to provide type-safety.</para>
270 <para>
271 </para><variablelist role="params">
272 <varlistentry><term><parameter>context</parameter>&#160;:</term>
273 <listitem><simpara> The D-Bus method invocation context
274 </simpara></listitem></varlistentry>
275 <varlistentry><term><parameter>out_Reconnect_Required</parameter>&#160;:</term>
276 <listitem><simpara> const gchar ** (FIXME, generate documentation)
277 </simpara></listitem></varlistentry>
278 </variablelist></refsect2>
279 <refsect2 id="tp-svc-account-implement-update-parameters" role="function">
280 <title>tp_svc_account_implement_update_parameters ()</title>
281 <indexterm zone="tp-svc-account-implement-update-parameters"><primary sortas="tp_svc_account_implement_update_parameters">tp_svc_account_implement_update_parameters</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_implement_update_parameters
282 (<link linkend="TpSvcAccountClass">TpSvcAccountClass</link> *klass,
283 <link linkend="tp-svc-account-update-parameters-impl">tp_svc_account_update_parameters_impl</link> impl);</programlisting>
284 <para>
285 Register an implementation for the UpdateParameters method in the vtable
286 of an implementation of this interface. To be called from
287 the interface init function.</para>
288 <para>
289 </para><variablelist role="params">
290 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
291 <listitem><simpara> A class whose instances implement this interface
292 </simpara></listitem></varlistentry>
293 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
294 <listitem><simpara> A callback used to implement the UpdateParameters D-Bus method
295 </simpara></listitem></varlistentry>
296 </variablelist></refsect2>
297 <refsect2 id="TpSvcAccountInterfaceAvatar-struct" role="struct">
298 <title>TpSvcAccountInterfaceAvatar</title>
299 <indexterm zone="TpSvcAccountInterfaceAvatar-struct"><primary sortas="TpSvcAccountInterfaceAvatar">TpSvcAccountInterfaceAvatar</primary></indexterm><programlisting>typedef struct _TpSvcAccountInterfaceAvatar TpSvcAccountInterfaceAvatar;</programlisting>
300 <para>
301 Dummy typedef representing any implementation of this interface.</para>
302 <para>
303 </para></refsect2>
304 <refsect2 id="TpSvcAccountInterfaceAvatarClass" role="struct">
305 <title>TpSvcAccountInterfaceAvatarClass</title>
306 <indexterm zone="TpSvcAccountInterfaceAvatarClass"><primary sortas="TpSvcAccountInterfaceAvatarClass">TpSvcAccountInterfaceAvatarClass</primary></indexterm><programlisting>typedef struct _TpSvcAccountInterfaceAvatarClass TpSvcAccountInterfaceAvatarClass;</programlisting>
307 <para>
308 The class of TpSvcAccountInterfaceAvatar.</para>
309 <para>
310 </para></refsect2>
311 <refsect2 id="tp-svc-account-interface-avatar-emit-avatar-changed" role="function">
312 <title>tp_svc_account_interface_avatar_emit_avatar_changed ()</title>
313 <indexterm zone="tp-svc-account-interface-avatar-emit-avatar-changed"><primary sortas="tp_svc_account_interface_avatar_emit_avatar_changed">tp_svc_account_interface_avatar_emit_avatar_changed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_account_interface_avatar_emit_avatar_changed
314 (<link linkend="gpointer">gpointer</link> instance);</programlisting>
315 <para>
316 Type-safe wrapper around g_signal_emit to emit the
317 AvatarChanged signal on interface org.freedesktop.Telepathy.Account.Interface.Avatar.</para>
318 <para>
319 </para><variablelist role="params">
320 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
321 <listitem><simpara> The object implementing this interface
322 </simpara></listitem></varlistentry>
323 </variablelist></refsect2>
324
325 </refsect1>
326
327 <refsect1 id="telepathy-glib-svc-account.signal-details" role="signals">
328 <title role="signals.title">Signal Details</title>
329 <refsect2 id="TpSvcAccount-account-property-changed" role="signal"><title>The <literal>&quot;account-property-changed&quot;</literal> signal</title>
330 <indexterm zone="TpSvcAccount-account-property-changed"><primary sortas="TpSvcAccount::account-property-changed">TpSvcAccount::account-property-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcAccount">TpSvcAccount</link> *arg_Properties,
331 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
332 <para>
333 The AccountPropertyChanged D-Bus signal is emitted whenever this GObject signal is.</para>
334 <para>
335 </para><variablelist role="params">
336 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
337 <listitem><simpara> GHashTable * (FIXME, generate documentation)
338 </simpara></listitem></varlistentry>
339 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
340 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
341 </variablelist></refsect2><refsect2 id="TpSvcAccount-removed" role="signal"><title>The <literal>&quot;removed&quot;</literal> signal</title>
342 <indexterm zone="TpSvcAccount-removed"><primary sortas="TpSvcAccount::removed">TpSvcAccount::removed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcAccount">TpSvcAccount</link> *arg0,
343 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
344 <para>
345 The Removed D-Bus signal is emitted whenever this GObject signal is.</para>
346 <para>
347 </para><variablelist role="params">
348 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
349 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
350 </variablelist></refsect2><refsect2 id="TpSvcAccountInterfaceAvatar-avatar-changed" role="signal"><title>The <literal>&quot;avatar-changed&quot;</literal> signal</title>
351 <indexterm zone="TpSvcAccountInterfaceAvatar-avatar-changed"><primary sortas="TpSvcAccountInterfaceAvatar::avatar-changed">TpSvcAccountInterfaceAvatar::avatar-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcAccountInterfaceAvatar">TpSvcAccountInterfaceAvatar</link> *arg0,
352 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
353 <para>
354 The AvatarChanged D-Bus signal is emitted whenever this GObject signal is.</para>
355 <para>
356 </para><variablelist role="params">
357 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
358 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
359 </variablelist></refsect2>
360 </refsect1>
361
362
363
364 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-channel-dispatch-operation">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-channel-dispatch-operation.top_of_page">Service-side Channel Dispatch Operation interface</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Channel Dispatch Operation interface</refname>
12 <refpurpose>GInterface for Telepathy ChannelDispatchOperation object</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-channel-dispatch-operation.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcChannelDispatchOperation"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-channel-dispatch-operation.h&gt;
21
22 <link linkend="TpSvcChannelDispatchOperation-struct">TpSvcChannelDispatchOperation</link>;
23 <link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-return-from-claim">tp_svc_channel_dispatch_operation_return_from_claim</link>
25 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
26 <link linkend="void">void</link> (<link linkend="tp-svc-channel-dispatch-operation-claim-impl">*tp_svc_channel_dispatch_operation_claim_impl</link>)
27 (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *self,
28 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
29 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-implement-claim">tp_svc_channel_dispatch_operation_implement_claim</link>
30 (<link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link> *klass,
31 <link linkend="tp-svc-channel-dispatch-operation-claim-impl">tp_svc_channel_dispatch_operation_claim_impl</link> impl);
32 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-return-from-handle-with">tp_svc_channel_dispatch_operation_return_from_handle_with</link>
33 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
34 <link linkend="void">void</link> (<link linkend="tp-svc-channel-dispatch-operation-handle-with-impl">*tp_svc_channel_dispatch_operation_handle_with_impl</link>)
35 (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *self,
36 const <link linkend="gchar">gchar</link> *in_Handler,
37 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
38 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-implement-handle-with">tp_svc_channel_dispatch_operation_implement_handle_with</link>
39 (<link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link> *klass,
40 <link linkend="tp-svc-channel-dispatch-operation-handle-with-impl">tp_svc_channel_dispatch_operation_handle_with_impl</link> impl);
41 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-emit-channel-lost">tp_svc_channel_dispatch_operation_emit_channel_lost</link>
42 (<link linkend="gpointer">gpointer</link> instance,
43 const <link linkend="gchar">gchar</link> *arg_Channel,
44 const <link linkend="gchar">gchar</link> *arg_Error,
45 const <link linkend="gchar">gchar</link> *arg_Message);
46 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatch-operation-emit-finished">tp_svc_channel_dispatch_operation_emit_finished</link>
47 (<link linkend="gpointer">gpointer</link> instance);
48 </synopsis>
49 </refsynopsisdiv>
50
51 <refsect1 id="telepathy-glib-svc-channel-dispatch-operation.object-hierarchy" role="object_hierarchy">
52 <title role="object_hierarchy.title">Object Hierarchy</title>
53 <synopsis>
54 <link linkend="GInterface">GInterface</link>
55 +----TpSvcChannelDispatchOperation
56 </synopsis>
57 </refsect1>
58
59
60
61
62
63
64 <refsect1 id="telepathy-glib-svc-channel-dispatch-operation.signals" role="signal_proto">
65 <title role="signal_proto.title">Signals</title>
66 <synopsis>
67 &quot;<link linkend="TpSvcChannelDispatchOperation-channel-lost">channel-lost</link>&quot; : Run Last / Has Details
68 &quot;<link linkend="TpSvcChannelDispatchOperation-finished">finished</link>&quot; : Run Last / Has Details
69 </synopsis>
70 </refsect1>
71
72
73 <refsect1 id="telepathy-glib-svc-channel-dispatch-operation.description" role="desc">
74 <title role="desc.title">Description</title>
75 <para>
76 This interface (auto-generated from the Telepathy
77 spec) makes it easier to export an object implementing the Telepathy
78 ChannelDispatchOperation interface, with the correct method and signal
79 signatures, and emit signals from that object in a type-safe way.
80 </para>
81 <para>
82 You don't need these interfaces unless you're implementing a
83 Telepathy ChannelDispatcher, such as Mission Control.</para>
84 <para>
85 </para>
86 </refsect1>
87
88 <refsect1 id="telepathy-glib-svc-channel-dispatch-operation.details" role="details">
89 <title role="details.title">Details</title>
90 <refsect2 id="TpSvcChannelDispatchOperation-struct" role="struct">
91 <title>TpSvcChannelDispatchOperation</title>
92 <indexterm zone="TpSvcChannelDispatchOperation-struct"><primary sortas="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatchOperation TpSvcChannelDispatchOperation;</programlisting>
93 <para>
94 Dummy typedef representing any implementation of this interface.</para>
95 <para>
96 </para></refsect2>
97 <refsect2 id="TpSvcChannelDispatchOperationClass" role="struct">
98 <title>TpSvcChannelDispatchOperationClass</title>
99 <indexterm zone="TpSvcChannelDispatchOperationClass"><primary sortas="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatchOperationClass TpSvcChannelDispatchOperationClass;</programlisting>
100 <para>
101 The class of TpSvcChannelDispatchOperation.</para>
102 <para>
103 </para></refsect2>
104 <refsect2 id="tp-svc-channel-dispatch-operation-return-from-claim" role="function">
105 <title>tp_svc_channel_dispatch_operation_return_from_claim ()</title>
106 <indexterm zone="tp-svc-channel-dispatch-operation-return-from-claim"><primary sortas="tp_svc_channel_dispatch_operation_return_from_claim">tp_svc_channel_dispatch_operation_return_from_claim</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_return_from_claim
107 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
108 <para>
109 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
110 This inline function exists only to provide type-safety.</para>
111 <para>
112 </para><variablelist role="params">
113 <varlistentry><term><parameter>context</parameter>&#160;:</term>
114 <listitem><simpara> The D-Bus method invocation context
115 </simpara></listitem></varlistentry>
116 </variablelist></refsect2>
117 <refsect2 id="tp-svc-channel-dispatch-operation-claim-impl" role="function">
118 <title>tp_svc_channel_dispatch_operation_claim_impl ()</title>
119 <indexterm zone="tp-svc-channel-dispatch-operation-claim-impl"><primary sortas="tp_svc_channel_dispatch_operation_claim_impl">tp_svc_channel_dispatch_operation_claim_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_dispatch_operation_claim_impl)
120 (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *self,
121 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
122 <para>
123 The signature of an implementation of the D-Bus method
124 Claim on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</para>
125 <para>
126 </para><variablelist role="params">
127 <varlistentry><term><parameter>self</parameter>&#160;:</term>
128 <listitem><simpara> The object implementing this interface
129 </simpara></listitem></varlistentry>
130 <varlistentry><term><parameter>context</parameter>&#160;:</term>
131 <listitem><simpara> Used to return values or throw an error
132 </simpara></listitem></varlistentry>
133 </variablelist></refsect2>
134 <refsect2 id="tp-svc-channel-dispatch-operation-implement-claim" role="function">
135 <title>tp_svc_channel_dispatch_operation_implement_claim ()</title>
136 <indexterm zone="tp-svc-channel-dispatch-operation-implement-claim"><primary sortas="tp_svc_channel_dispatch_operation_implement_claim">tp_svc_channel_dispatch_operation_implement_claim</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_implement_claim
137 (<link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link> *klass,
138 <link linkend="tp-svc-channel-dispatch-operation-claim-impl">tp_svc_channel_dispatch_operation_claim_impl</link> impl);</programlisting>
139 <para>
140 Register an implementation for the Claim method in the vtable
141 of an implementation of this interface. To be called from
142 the interface init function.</para>
143 <para>
144 </para><variablelist role="params">
145 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
146 <listitem><simpara> A class whose instances implement this interface
147 </simpara></listitem></varlistentry>
148 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
149 <listitem><simpara> A callback used to implement the Claim D-Bus method
150 </simpara></listitem></varlistentry>
151 </variablelist></refsect2>
152 <refsect2 id="tp-svc-channel-dispatch-operation-return-from-handle-with" role="function">
153 <title>tp_svc_channel_dispatch_operation_return_from_handle_with ()</title>
154 <indexterm zone="tp-svc-channel-dispatch-operation-return-from-handle-with"><primary sortas="tp_svc_channel_dispatch_operation_return_from_handle_with">tp_svc_channel_dispatch_operation_return_from_handle_with</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_return_from_handle_with
155 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
156 <para>
157 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
158 This inline function exists only to provide type-safety.</para>
159 <para>
160 </para><variablelist role="params">
161 <varlistentry><term><parameter>context</parameter>&#160;:</term>
162 <listitem><simpara> The D-Bus method invocation context
163 </simpara></listitem></varlistentry>
164 </variablelist></refsect2>
165 <refsect2 id="tp-svc-channel-dispatch-operation-handle-with-impl" role="function">
166 <title>tp_svc_channel_dispatch_operation_handle_with_impl ()</title>
167 <indexterm zone="tp-svc-channel-dispatch-operation-handle-with-impl"><primary sortas="tp_svc_channel_dispatch_operation_handle_with_impl">tp_svc_channel_dispatch_operation_handle_with_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_dispatch_operation_handle_with_impl)
168 (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *self,
169 const <link linkend="gchar">gchar</link> *in_Handler,
170 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
171 <para>
172 The signature of an implementation of the D-Bus method
173 HandleWith on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</para>
174 <para>
175 </para><variablelist role="params">
176 <varlistentry><term><parameter>self</parameter>&#160;:</term>
177 <listitem><simpara> The object implementing this interface
178 </simpara></listitem></varlistentry>
179 <varlistentry><term><parameter>in_Handler</parameter>&#160;:</term>
180 <listitem><simpara> const gchar * (FIXME, generate documentation)
181 </simpara></listitem></varlistentry>
182 <varlistentry><term><parameter>context</parameter>&#160;:</term>
183 <listitem><simpara> Used to return values or throw an error
184 </simpara></listitem></varlistentry>
185 </variablelist></refsect2>
186 <refsect2 id="tp-svc-channel-dispatch-operation-implement-handle-with" role="function">
187 <title>tp_svc_channel_dispatch_operation_implement_handle_with ()</title>
188 <indexterm zone="tp-svc-channel-dispatch-operation-implement-handle-with"><primary sortas="tp_svc_channel_dispatch_operation_implement_handle_with">tp_svc_channel_dispatch_operation_implement_handle_with</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_implement_handle_with
189 (<link linkend="TpSvcChannelDispatchOperationClass">TpSvcChannelDispatchOperationClass</link> *klass,
190 <link linkend="tp-svc-channel-dispatch-operation-handle-with-impl">tp_svc_channel_dispatch_operation_handle_with_impl</link> impl);</programlisting>
191 <para>
192 Register an implementation for the HandleWith method in the vtable
193 of an implementation of this interface. To be called from
194 the interface init function.</para>
195 <para>
196 </para><variablelist role="params">
197 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
198 <listitem><simpara> A class whose instances implement this interface
199 </simpara></listitem></varlistentry>
200 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
201 <listitem><simpara> A callback used to implement the HandleWith D-Bus method
202 </simpara></listitem></varlistentry>
203 </variablelist></refsect2>
204 <refsect2 id="tp-svc-channel-dispatch-operation-emit-channel-lost" role="function">
205 <title>tp_svc_channel_dispatch_operation_emit_channel_lost ()</title>
206 <indexterm zone="tp-svc-channel-dispatch-operation-emit-channel-lost"><primary sortas="tp_svc_channel_dispatch_operation_emit_channel_lost">tp_svc_channel_dispatch_operation_emit_channel_lost</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_emit_channel_lost
207 (<link linkend="gpointer">gpointer</link> instance,
208 const <link linkend="gchar">gchar</link> *arg_Channel,
209 const <link linkend="gchar">gchar</link> *arg_Error,
210 const <link linkend="gchar">gchar</link> *arg_Message);</programlisting>
211 <para>
212 Type-safe wrapper around g_signal_emit to emit the
213 ChannelLost signal on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</para>
214 <para>
215 </para><variablelist role="params">
216 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
217 <listitem><simpara> The object implementing this interface
218 </simpara></listitem></varlistentry>
219 <varlistentry><term><parameter>arg_Channel</parameter>&#160;:</term>
220 <listitem><simpara> const gchar * (FIXME, generate documentation)
221 </simpara></listitem></varlistentry>
222 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
223 <listitem><simpara> const gchar * (FIXME, generate documentation)
224 </simpara></listitem></varlistentry>
225 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
226 <listitem><simpara> const gchar * (FIXME, generate documentation)
227 </simpara></listitem></varlistentry>
228 </variablelist></refsect2>
229 <refsect2 id="tp-svc-channel-dispatch-operation-emit-finished" role="function">
230 <title>tp_svc_channel_dispatch_operation_emit_finished ()</title>
231 <indexterm zone="tp-svc-channel-dispatch-operation-emit-finished"><primary sortas="tp_svc_channel_dispatch_operation_emit_finished">tp_svc_channel_dispatch_operation_emit_finished</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatch_operation_emit_finished
232 (<link linkend="gpointer">gpointer</link> instance);</programlisting>
233 <para>
234 Type-safe wrapper around g_signal_emit to emit the
235 Finished signal on interface org.freedesktop.Telepathy.ChannelDispatchOperation.</para>
236 <para>
237 </para><variablelist role="params">
238 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
239 <listitem><simpara> The object implementing this interface
240 </simpara></listitem></varlistentry>
241 </variablelist></refsect2>
242
243 </refsect1>
244
245 <refsect1 id="telepathy-glib-svc-channel-dispatch-operation.signal-details" role="signals">
246 <title role="signals.title">Signal Details</title>
247 <refsect2 id="TpSvcChannelDispatchOperation-channel-lost" role="signal"><title>The <literal>&quot;channel-lost&quot;</literal> signal</title>
248 <indexterm zone="TpSvcChannelDispatchOperation-channel-lost"><primary sortas="TpSvcChannelDispatchOperation::channel-lost">TpSvcChannelDispatchOperation::channel-lost</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *arg_Channel,
249 <link linkend="DBusGObjectPath">DBusGObjectPath</link> *arg_Error,
250 <link linkend="gchar">gchar</link> *arg_Message,
251 <link linkend="gchar">gchar</link> *arg3,
252 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
253 <para>
254 The ChannelLost D-Bus signal is emitted whenever this GObject signal is.</para>
255 <para>
256 </para><variablelist role="params">
257 <varlistentry><term><parameter>arg_Channel</parameter>&#160;:</term>
258 <listitem><simpara> const gchar * (FIXME, generate documentation)
259 </simpara></listitem></varlistentry>
260 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
261 <listitem><simpara> const gchar * (FIXME, generate documentation)
262 </simpara></listitem></varlistentry>
263 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
264 <listitem><simpara> const gchar * (FIXME, generate documentation)
265 </simpara></listitem></varlistentry>
266 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
267 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
268 </variablelist></refsect2><refsect2 id="TpSvcChannelDispatchOperation-finished" role="signal"><title>The <literal>&quot;finished&quot;</literal> signal</title>
269 <indexterm zone="TpSvcChannelDispatchOperation-finished"><primary sortas="TpSvcChannelDispatchOperation::finished">TpSvcChannelDispatchOperation::finished</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelDispatchOperation">TpSvcChannelDispatchOperation</link> *arg0,
270 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
271 <para>
272 The Finished D-Bus signal is emitted whenever this GObject signal is.</para>
273 <para>
274 </para><variablelist role="params">
275 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
276 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
277 </variablelist></refsect2>
278 </refsect1>
279
280
281
282 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-channel-dispatcher">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-channel-dispatcher.top_of_page">Service-side Channel Dispatcher interface</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Channel Dispatcher interface</refname>
12 <refpurpose>GInterfaces for Telepathy ChannelDispatcher object</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-channel-dispatcher.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcChannelDispatcher"/><anchor id="TpSvcChannelDispatcherInterfaceOperationList"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-channel-dispatcher.h&gt;
21
22 <link linkend="TpSvcChannelDispatcher-struct">TpSvcChannelDispatcher</link>;
23 <link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-return-from-create-channel">tp_svc_channel_dispatcher_return_from_create_channel</link>
25 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
26 const <link linkend="gchar">gchar</link> *out_Request);
27 <link linkend="void">void</link> (<link linkend="tp-svc-channel-dispatcher-create-channel-impl">*tp_svc_channel_dispatcher_create_channel_impl</link>)
28 (<link linkend="TpSvcChannelDispatcher">TpSvcChannelDispatcher</link> *self,
29 const <link linkend="gchar">gchar</link> *in_Account,
30 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
31 <link linkend="gint64">gint64</link> in_User_Action_Time,
32 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
33 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
34 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-implement-create-channel">tp_svc_channel_dispatcher_implement_create_channel</link>
35 (<link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link> *klass,
36 <link linkend="tp-svc-channel-dispatcher-create-channel-impl">tp_svc_channel_dispatcher_create_channel_impl</link> impl);
37 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-return-from-ensure-channel">tp_svc_channel_dispatcher_return_from_ensure_channel</link>
38 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
39 const <link linkend="gchar">gchar</link> *out_Request);
40 <link linkend="void">void</link> (<link linkend="tp-svc-channel-dispatcher-ensure-channel-impl">*tp_svc_channel_dispatcher_ensure_channel_impl</link>)
41 (<link linkend="TpSvcChannelDispatcher">TpSvcChannelDispatcher</link> *self,
42 const <link linkend="gchar">gchar</link> *in_Account,
43 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
44 <link linkend="gint64">gint64</link> in_User_Action_Time,
45 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
46 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
47 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-implement-ensure-channel">tp_svc_channel_dispatcher_implement_ensure_channel</link>
48 (<link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link> *klass,
49 <link linkend="tp-svc-channel-dispatcher-ensure-channel-impl">tp_svc_channel_dispatcher_ensure_channel_impl</link> impl);
50
51 <link linkend="TpSvcChannelDispatcherInterfaceOperationList-struct">TpSvcChannelDispatcherInterfaceOperationList</link>;
52 <link linkend="TpSvcChannelDispatcherInterfaceOperationListClass">TpSvcChannelDispatcherInterfaceOperationListClass</link>;
53 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation">tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation</link>
54 (<link linkend="gpointer">gpointer</link> instance,
55 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
56 <link linkend="GHashTable">GHashTable</link> *arg_Properties);
57 <link linkend="void">void</link> <link linkend="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished">tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished</link>
58 (<link linkend="gpointer">gpointer</link> instance,
59 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation);
60 </synopsis>
61 </refsynopsisdiv>
62
63 <refsect1 id="telepathy-glib-svc-channel-dispatcher.object-hierarchy" role="object_hierarchy">
64 <title role="object_hierarchy.title">Object Hierarchy</title>
65 <synopsis>
66 <link linkend="GInterface">GInterface</link>
67 +----TpSvcChannelDispatcher
68 </synopsis>
69 <synopsis>
70 <link linkend="GInterface">GInterface</link>
71 +----TpSvcChannelDispatcherInterfaceOperationList
72 </synopsis>
73 </refsect1>
74
75
76
77
78
79
80 <refsect1 id="telepathy-glib-svc-channel-dispatcher.signals" role="signal_proto">
81 <title role="signal_proto.title">Signals</title>
82 <synopsis>
83 &quot;<link linkend="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished">dispatch-operation-finished</link>&quot; : Run Last / Has Details
84 &quot;<link linkend="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation">new-dispatch-operation</link>&quot; : Run Last / Has Details
85 </synopsis>
86 </refsect1>
87
88
89 <refsect1 id="telepathy-glib-svc-channel-dispatcher.description" role="desc">
90 <title role="desc.title">Description</title>
91 <para>
92 The <link linkend="TpSvcChannelDispatcher"><type>TpSvcChannelDispatcher</type></link> interface (auto-generated from the Telepathy
93 spec) makes it easier to export an object implementing the Telepathy
94 ChannelDispatcher interface, with the correct method and signal signatures,
95 and emit signals from that object in a type-safe way.
96 </para>
97 <para>
98 Similarly, <link linkend="TpSvcChannelDispatcherInterfaceOperationList"><type>TpSvcChannelDispatcherInterfaceOperationList</type></link> helps to
99 implement the optional OperationList interface.
100 </para>
101 <para>
102 You don't need these interfaces unless you're implementing a
103 Telepathy ChannelDispatcher, such as Mission Control.</para>
104 <para>
105 </para>
106 </refsect1>
107
108 <refsect1 id="telepathy-glib-svc-channel-dispatcher.details" role="details">
109 <title role="details.title">Details</title>
110 <refsect2 id="TpSvcChannelDispatcher-struct" role="struct">
111 <title>TpSvcChannelDispatcher</title>
112 <indexterm zone="TpSvcChannelDispatcher-struct"><primary sortas="TpSvcChannelDispatcher">TpSvcChannelDispatcher</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatcher TpSvcChannelDispatcher;</programlisting>
113 <para>
114 Dummy typedef representing any implementation of this interface.</para>
115 <para>
116 </para></refsect2>
117 <refsect2 id="TpSvcChannelDispatcherClass" role="struct">
118 <title>TpSvcChannelDispatcherClass</title>
119 <indexterm zone="TpSvcChannelDispatcherClass"><primary sortas="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatcherClass TpSvcChannelDispatcherClass;</programlisting>
120 <para>
121 The class of TpSvcChannelDispatcher.</para>
122 <para>
123 </para></refsect2>
124 <refsect2 id="tp-svc-channel-dispatcher-return-from-create-channel" role="function">
125 <title>tp_svc_channel_dispatcher_return_from_create_channel ()</title>
126 <indexterm zone="tp-svc-channel-dispatcher-return-from-create-channel"><primary sortas="tp_svc_channel_dispatcher_return_from_create_channel">tp_svc_channel_dispatcher_return_from_create_channel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_return_from_create_channel
127 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
128 const <link linkend="gchar">gchar</link> *out_Request);</programlisting>
129 <para>
130 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
131 This inline function exists only to provide type-safety.</para>
132 <para>
133 </para><variablelist role="params">
134 <varlistentry><term><parameter>context</parameter>&#160;:</term>
135 <listitem><simpara> The D-Bus method invocation context
136 </simpara></listitem></varlistentry>
137 <varlistentry><term><parameter>out_Request</parameter>&#160;:</term>
138 <listitem><simpara> const gchar * (FIXME, generate documentation)
139 </simpara></listitem></varlistentry>
140 </variablelist></refsect2>
141 <refsect2 id="tp-svc-channel-dispatcher-create-channel-impl" role="function">
142 <title>tp_svc_channel_dispatcher_create_channel_impl ()</title>
143 <indexterm zone="tp-svc-channel-dispatcher-create-channel-impl"><primary sortas="tp_svc_channel_dispatcher_create_channel_impl">tp_svc_channel_dispatcher_create_channel_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_dispatcher_create_channel_impl)
144 (<link linkend="TpSvcChannelDispatcher">TpSvcChannelDispatcher</link> *self,
145 const <link linkend="gchar">gchar</link> *in_Account,
146 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
147 <link linkend="gint64">gint64</link> in_User_Action_Time,
148 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
149 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
150 <para>
151 The signature of an implementation of the D-Bus method
152 CreateChannel on interface org.freedesktop.Telepathy.ChannelDispatcher.</para>
153 <para>
154 </para><variablelist role="params">
155 <varlistentry><term><parameter>self</parameter>&#160;:</term>
156 <listitem><simpara> The object implementing this interface
157 </simpara></listitem></varlistentry>
158 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
159 <listitem><simpara> const gchar * (FIXME, generate documentation)
160 </simpara></listitem></varlistentry>
161 <varlistentry><term><parameter>in_Requested_Properties</parameter>&#160;:</term>
162 <listitem><simpara> GHashTable * (FIXME, generate documentation)
163 </simpara></listitem></varlistentry>
164 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
165 <listitem><simpara> gint64 (FIXME, generate documentation)
166 </simpara></listitem></varlistentry>
167 <varlistentry><term><parameter>in_Preferred_Handler</parameter>&#160;:</term>
168 <listitem><simpara> const gchar * (FIXME, generate documentation)
169 </simpara></listitem></varlistentry>
170 <varlistentry><term><parameter>context</parameter>&#160;:</term>
171 <listitem><simpara> Used to return values or throw an error
172 </simpara></listitem></varlistentry>
173 </variablelist></refsect2>
174 <refsect2 id="tp-svc-channel-dispatcher-implement-create-channel" role="function">
175 <title>tp_svc_channel_dispatcher_implement_create_channel ()</title>
176 <indexterm zone="tp-svc-channel-dispatcher-implement-create-channel"><primary sortas="tp_svc_channel_dispatcher_implement_create_channel">tp_svc_channel_dispatcher_implement_create_channel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_implement_create_channel
177 (<link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link> *klass,
178 <link linkend="tp-svc-channel-dispatcher-create-channel-impl">tp_svc_channel_dispatcher_create_channel_impl</link> impl);</programlisting>
179 <para>
180 Register an implementation for the CreateChannel method in the vtable
181 of an implementation of this interface. To be called from
182 the interface init function.</para>
183 <para>
184 </para><variablelist role="params">
185 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
186 <listitem><simpara> A class whose instances implement this interface
187 </simpara></listitem></varlistentry>
188 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
189 <listitem><simpara> A callback used to implement the CreateChannel D-Bus method
190 </simpara></listitem></varlistentry>
191 </variablelist></refsect2>
192 <refsect2 id="tp-svc-channel-dispatcher-return-from-ensure-channel" role="function">
193 <title>tp_svc_channel_dispatcher_return_from_ensure_channel ()</title>
194 <indexterm zone="tp-svc-channel-dispatcher-return-from-ensure-channel"><primary sortas="tp_svc_channel_dispatcher_return_from_ensure_channel">tp_svc_channel_dispatcher_return_from_ensure_channel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_return_from_ensure_channel
195 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context,
196 const <link linkend="gchar">gchar</link> *out_Request);</programlisting>
197 <para>
198 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
199 This inline function exists only to provide type-safety.</para>
200 <para>
201 </para><variablelist role="params">
202 <varlistentry><term><parameter>context</parameter>&#160;:</term>
203 <listitem><simpara> The D-Bus method invocation context
204 </simpara></listitem></varlistentry>
205 <varlistentry><term><parameter>out_Request</parameter>&#160;:</term>
206 <listitem><simpara> const gchar * (FIXME, generate documentation)
207 </simpara></listitem></varlistentry>
208 </variablelist></refsect2>
209 <refsect2 id="tp-svc-channel-dispatcher-ensure-channel-impl" role="function">
210 <title>tp_svc_channel_dispatcher_ensure_channel_impl ()</title>
211 <indexterm zone="tp-svc-channel-dispatcher-ensure-channel-impl"><primary sortas="tp_svc_channel_dispatcher_ensure_channel_impl">tp_svc_channel_dispatcher_ensure_channel_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_dispatcher_ensure_channel_impl)
212 (<link linkend="TpSvcChannelDispatcher">TpSvcChannelDispatcher</link> *self,
213 const <link linkend="gchar">gchar</link> *in_Account,
214 <link linkend="GHashTable">GHashTable</link> *in_Requested_Properties,
215 <link linkend="gint64">gint64</link> in_User_Action_Time,
216 const <link linkend="gchar">gchar</link> *in_Preferred_Handler,
217 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
218 <para>
219 The signature of an implementation of the D-Bus method
220 EnsureChannel on interface org.freedesktop.Telepathy.ChannelDispatcher.</para>
221 <para>
222 </para><variablelist role="params">
223 <varlistentry><term><parameter>self</parameter>&#160;:</term>
224 <listitem><simpara> The object implementing this interface
225 </simpara></listitem></varlistentry>
226 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
227 <listitem><simpara> const gchar * (FIXME, generate documentation)
228 </simpara></listitem></varlistentry>
229 <varlistentry><term><parameter>in_Requested_Properties</parameter>&#160;:</term>
230 <listitem><simpara> GHashTable * (FIXME, generate documentation)
231 </simpara></listitem></varlistentry>
232 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
233 <listitem><simpara> gint64 (FIXME, generate documentation)
234 </simpara></listitem></varlistentry>
235 <varlistentry><term><parameter>in_Preferred_Handler</parameter>&#160;:</term>
236 <listitem><simpara> const gchar * (FIXME, generate documentation)
237 </simpara></listitem></varlistentry>
238 <varlistentry><term><parameter>context</parameter>&#160;:</term>
239 <listitem><simpara> Used to return values or throw an error
240 </simpara></listitem></varlistentry>
241 </variablelist></refsect2>
242 <refsect2 id="tp-svc-channel-dispatcher-implement-ensure-channel" role="function">
243 <title>tp_svc_channel_dispatcher_implement_ensure_channel ()</title>
244 <indexterm zone="tp-svc-channel-dispatcher-implement-ensure-channel"><primary sortas="tp_svc_channel_dispatcher_implement_ensure_channel">tp_svc_channel_dispatcher_implement_ensure_channel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_implement_ensure_channel
245 (<link linkend="TpSvcChannelDispatcherClass">TpSvcChannelDispatcherClass</link> *klass,
246 <link linkend="tp-svc-channel-dispatcher-ensure-channel-impl">tp_svc_channel_dispatcher_ensure_channel_impl</link> impl);</programlisting>
247 <para>
248 Register an implementation for the EnsureChannel method in the vtable
249 of an implementation of this interface. To be called from
250 the interface init function.</para>
251 <para>
252 </para><variablelist role="params">
253 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
254 <listitem><simpara> A class whose instances implement this interface
255 </simpara></listitem></varlistentry>
256 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
257 <listitem><simpara> A callback used to implement the EnsureChannel D-Bus method
258 </simpara></listitem></varlistentry>
259 </variablelist></refsect2>
260 <refsect2 id="TpSvcChannelDispatcherInterfaceOperationList-struct" role="struct">
261 <title>TpSvcChannelDispatcherInterfaceOperationList</title>
262 <indexterm zone="TpSvcChannelDispatcherInterfaceOperationList-struct"><primary sortas="TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatcherInterfaceOperationList TpSvcChannelDispatcherInterfaceOperationList;</programlisting>
263 <para>
264 Dummy typedef representing any implementation of this interface.</para>
265 <para>
266 </para></refsect2>
267 <refsect2 id="TpSvcChannelDispatcherInterfaceOperationListClass" role="struct">
268 <title>TpSvcChannelDispatcherInterfaceOperationListClass</title>
269 <indexterm zone="TpSvcChannelDispatcherInterfaceOperationListClass"><primary sortas="TpSvcChannelDispatcherInterfaceOperationListClass">TpSvcChannelDispatcherInterfaceOperationListClass</primary></indexterm><programlisting>typedef struct _TpSvcChannelDispatcherInterfaceOperationListClass TpSvcChannelDispatcherInterfaceOperationListClass;</programlisting>
270 <para>
271 The class of TpSvcChannelDispatcherInterfaceOperationList.</para>
272 <para>
273 </para></refsect2>
274 <refsect2 id="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation" role="function">
275 <title>tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation ()</title>
276 <indexterm zone="tp-svc-channel-dispatcher-interface-operation-list-emit-new-dispatch-operation"><primary sortas="tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation">tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation
277 (<link linkend="gpointer">gpointer</link> instance,
278 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation,
279 <link linkend="GHashTable">GHashTable</link> *arg_Properties);</programlisting>
280 <para>
281 Type-safe wrapper around g_signal_emit to emit the
282 NewDispatchOperation signal on interface org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList.</para>
283 <para>
284 </para><variablelist role="params">
285 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
286 <listitem><simpara> The object implementing this interface
287 </simpara></listitem></varlistentry>
288 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
289 <listitem><simpara> const gchar * (FIXME, generate documentation)
290 </simpara></listitem></varlistentry>
291 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
292 <listitem><simpara> GHashTable * (FIXME, generate documentation)
293 </simpara></listitem></varlistentry>
294 </variablelist></refsect2>
295 <refsect2 id="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished" role="function">
296 <title>tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished ()</title>
297 <indexterm zone="tp-svc-channel-dispatcher-interface-operation-list-emit-dispatch-operation-finished"><primary sortas="tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished">tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished
298 (<link linkend="gpointer">gpointer</link> instance,
299 const <link linkend="gchar">gchar</link> *arg_Dispatch_Operation);</programlisting>
300 <para>
301 Type-safe wrapper around g_signal_emit to emit the
302 DispatchOperationFinished signal on interface org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList.</para>
303 <para>
304 </para><variablelist role="params">
305 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
306 <listitem><simpara> The object implementing this interface
307 </simpara></listitem></varlistentry>
308 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
309 <listitem><simpara> const gchar * (FIXME, generate documentation)
310 </simpara></listitem></varlistentry>
311 </variablelist></refsect2>
312
313 </refsect1>
314
315 <refsect1 id="telepathy-glib-svc-channel-dispatcher.signal-details" role="signals">
316 <title role="signals.title">Signal Details</title>
317 <refsect2 id="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished" role="signal"><title>The <literal>&quot;dispatch-operation-finished&quot;</literal> signal</title>
318 <indexterm zone="TpSvcChannelDispatcherInterfaceOperationList-dispatch-operation-finished"><primary sortas="TpSvcChannelDispatcherInterfaceOperationList::dispatch-operation-finished">TpSvcChannelDispatcherInterfaceOperationList::dispatch-operation-finished</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</link> *arg_Dispatch_Operation,
319 <link linkend="DBusGObjectPath">DBusGObjectPath</link> *arg1,
320 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
321 <para>
322 The DispatchOperationFinished D-Bus signal is emitted whenever this GObject signal is.</para>
323 <para>
324 </para><variablelist role="params">
325 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
326 <listitem><simpara> const gchar * (FIXME, generate documentation)
327 </simpara></listitem></varlistentry>
328 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
329 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
330 </variablelist></refsect2><refsect2 id="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation" role="signal"><title>The <literal>&quot;new-dispatch-operation&quot;</literal> signal</title>
331 <indexterm zone="TpSvcChannelDispatcherInterfaceOperationList-new-dispatch-operation"><primary sortas="TpSvcChannelDispatcherInterfaceOperationList::new-dispatch-operation">TpSvcChannelDispatcherInterfaceOperationList::new-dispatch-operation</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelDispatcherInterfaceOperationList">TpSvcChannelDispatcherInterfaceOperationList</link> *arg_Dispatch_Operation,
332 <link linkend="DBusGObjectPath">DBusGObjectPath</link> *arg_Properties,
333 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
334 <para>
335 The NewDispatchOperation D-Bus signal is emitted whenever this GObject signal is.</para>
336 <para>
337 </para><variablelist role="params">
338 <varlistentry><term><parameter>arg_Dispatch_Operation</parameter>&#160;:</term>
339 <listitem><simpara> const gchar * (FIXME, generate documentation)
340 </simpara></listitem></varlistentry>
341 <varlistentry><term><parameter>arg_Properties</parameter>&#160;:</term>
342 <listitem><simpara> GHashTable * (FIXME, generate documentation)
343 </simpara></listitem></varlistentry>
344 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
345 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
346 </variablelist></refsect2>
347 </refsect1>
348
349
350
351 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-channel-request">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-channel-request.top_of_page">Service-side Channel Request interface</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Channel Request interface</refname>
12 <refpurpose>GInterface for Telepathy ChannelRequest object</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-channel-request.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcChannelRequest"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-channel-request.h&gt;
21
22 <link linkend="TpSvcChannelRequest-struct">TpSvcChannelRequest</link>;
23 <link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link>;
24 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-return-from-proceed">tp_svc_channel_request_return_from_proceed</link>
25 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
26 <link linkend="void">void</link> (<link linkend="tp-svc-channel-request-proceed-impl">*tp_svc_channel_request_proceed_impl</link>)
27 (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *self,
28 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
29 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-implement-proceed">tp_svc_channel_request_implement_proceed</link>
30 (<link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link> *klass,
31 <link linkend="tp-svc-channel-request-proceed-impl">tp_svc_channel_request_proceed_impl</link> impl);
32 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-return-from-cancel">tp_svc_channel_request_return_from_cancel</link>
33 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
34 <link linkend="void">void</link> (<link linkend="tp-svc-channel-request-cancel-impl">*tp_svc_channel_request_cancel_impl</link>)
35 (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *self,
36 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
37 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-implement-cancel">tp_svc_channel_request_implement_cancel</link>
38 (<link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link> *klass,
39 <link linkend="tp-svc-channel-request-cancel-impl">tp_svc_channel_request_cancel_impl</link> impl);
40 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-emit-failed">tp_svc_channel_request_emit_failed</link> (<link linkend="gpointer">gpointer</link> instance,
41 const <link linkend="gchar">gchar</link> *arg_Error,
42 const <link linkend="gchar">gchar</link> *arg_Message);
43 <link linkend="void">void</link> <link linkend="tp-svc-channel-request-emit-succeeded">tp_svc_channel_request_emit_succeeded</link>
44 (<link linkend="gpointer">gpointer</link> instance);
45 </synopsis>
46 </refsynopsisdiv>
47
48 <refsect1 id="telepathy-glib-svc-channel-request.object-hierarchy" role="object_hierarchy">
49 <title role="object_hierarchy.title">Object Hierarchy</title>
50 <synopsis>
51 <link linkend="GInterface">GInterface</link>
52 +----TpSvcChannelRequest
53 </synopsis>
54 </refsect1>
55
56
57
58
59
60
61 <refsect1 id="telepathy-glib-svc-channel-request.signals" role="signal_proto">
62 <title role="signal_proto.title">Signals</title>
63 <synopsis>
64 &quot;<link linkend="TpSvcChannelRequest-failed">failed</link>&quot; : Run Last / Has Details
65 &quot;<link linkend="TpSvcChannelRequest-succeeded">succeeded</link>&quot; : Run Last / Has Details
66 </synopsis>
67 </refsect1>
68
69
70 <refsect1 id="telepathy-glib-svc-channel-request.description" role="desc">
71 <title role="desc.title">Description</title>
72 <para>
73 This interface (auto-generated from the Telepathy
74 spec) makes it easier to export an object implementing the Telepathy
75 ChannelRequest interface, with the correct method and signal
76 signatures, and emit signals from that object in a type-safe way.
77 </para>
78 <para>
79 You don't need these interfaces unless you're implementing a
80 Telepathy ChannelDispatcher, such as Mission Control.</para>
81 <para>
82 </para>
83 </refsect1>
84
85 <refsect1 id="telepathy-glib-svc-channel-request.details" role="details">
86 <title role="details.title">Details</title>
87 <refsect2 id="TpSvcChannelRequest-struct" role="struct">
88 <title>TpSvcChannelRequest</title>
89 <indexterm zone="TpSvcChannelRequest-struct"><primary sortas="TpSvcChannelRequest">TpSvcChannelRequest</primary></indexterm><programlisting>typedef struct _TpSvcChannelRequest TpSvcChannelRequest;</programlisting>
90 <para>
91 Dummy typedef representing any implementation of this interface.</para>
92 <para>
93 </para></refsect2>
94 <refsect2 id="TpSvcChannelRequestClass" role="struct">
95 <title>TpSvcChannelRequestClass</title>
96 <indexterm zone="TpSvcChannelRequestClass"><primary sortas="TpSvcChannelRequestClass">TpSvcChannelRequestClass</primary></indexterm><programlisting>typedef struct _TpSvcChannelRequestClass TpSvcChannelRequestClass;</programlisting>
97 <para>
98 The class of TpSvcChannelRequest.</para>
99 <para>
100 </para></refsect2>
101 <refsect2 id="tp-svc-channel-request-return-from-proceed" role="function">
102 <title>tp_svc_channel_request_return_from_proceed ()</title>
103 <indexterm zone="tp-svc-channel-request-return-from-proceed"><primary sortas="tp_svc_channel_request_return_from_proceed">tp_svc_channel_request_return_from_proceed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_return_from_proceed
104 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
105 <para>
106 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
107 This inline function exists only to provide type-safety.</para>
108 <para>
109 </para><variablelist role="params">
110 <varlistentry><term><parameter>context</parameter>&#160;:</term>
111 <listitem><simpara> The D-Bus method invocation context
112 </simpara></listitem></varlistentry>
113 </variablelist></refsect2>
114 <refsect2 id="tp-svc-channel-request-proceed-impl" role="function">
115 <title>tp_svc_channel_request_proceed_impl ()</title>
116 <indexterm zone="tp-svc-channel-request-proceed-impl"><primary sortas="tp_svc_channel_request_proceed_impl">tp_svc_channel_request_proceed_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_request_proceed_impl)
117 (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *self,
118 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
119 <para>
120 The signature of an implementation of the D-Bus method
121 Proceed on interface org.freedesktop.Telepathy.ChannelRequest.</para>
122 <para>
123 </para><variablelist role="params">
124 <varlistentry><term><parameter>self</parameter>&#160;:</term>
125 <listitem><simpara> The object implementing this interface
126 </simpara></listitem></varlistentry>
127 <varlistentry><term><parameter>context</parameter>&#160;:</term>
128 <listitem><simpara> Used to return values or throw an error
129 </simpara></listitem></varlistentry>
130 </variablelist></refsect2>
131 <refsect2 id="tp-svc-channel-request-implement-proceed" role="function">
132 <title>tp_svc_channel_request_implement_proceed ()</title>
133 <indexterm zone="tp-svc-channel-request-implement-proceed"><primary sortas="tp_svc_channel_request_implement_proceed">tp_svc_channel_request_implement_proceed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_implement_proceed
134 (<link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link> *klass,
135 <link linkend="tp-svc-channel-request-proceed-impl">tp_svc_channel_request_proceed_impl</link> impl);</programlisting>
136 <para>
137 Register an implementation for the Proceed method in the vtable
138 of an implementation of this interface. To be called from
139 the interface init function.</para>
140 <para>
141 </para><variablelist role="params">
142 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
143 <listitem><simpara> A class whose instances implement this interface
144 </simpara></listitem></varlistentry>
145 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
146 <listitem><simpara> A callback used to implement the Proceed D-Bus method
147 </simpara></listitem></varlistentry>
148 </variablelist></refsect2>
149 <refsect2 id="tp-svc-channel-request-return-from-cancel" role="function">
150 <title>tp_svc_channel_request_return_from_cancel ()</title>
151 <indexterm zone="tp-svc-channel-request-return-from-cancel"><primary sortas="tp_svc_channel_request_return_from_cancel">tp_svc_channel_request_return_from_cancel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_return_from_cancel
152 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
153 <para>
154 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
155 This inline function exists only to provide type-safety.</para>
156 <para>
157 </para><variablelist role="params">
158 <varlistentry><term><parameter>context</parameter>&#160;:</term>
159 <listitem><simpara> The D-Bus method invocation context
160 </simpara></listitem></varlistentry>
161 </variablelist></refsect2>
162 <refsect2 id="tp-svc-channel-request-cancel-impl" role="function">
163 <title>tp_svc_channel_request_cancel_impl ()</title>
164 <indexterm zone="tp-svc-channel-request-cancel-impl"><primary sortas="tp_svc_channel_request_cancel_impl">tp_svc_channel_request_cancel_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_channel_request_cancel_impl)
165 (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *self,
166 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
167 <para>
168 The signature of an implementation of the D-Bus method
169 Cancel on interface org.freedesktop.Telepathy.ChannelRequest.</para>
170 <para>
171 </para><variablelist role="params">
172 <varlistentry><term><parameter>self</parameter>&#160;:</term>
173 <listitem><simpara> The object implementing this interface
174 </simpara></listitem></varlistentry>
175 <varlistentry><term><parameter>context</parameter>&#160;:</term>
176 <listitem><simpara> Used to return values or throw an error
177 </simpara></listitem></varlistentry>
178 </variablelist></refsect2>
179 <refsect2 id="tp-svc-channel-request-implement-cancel" role="function">
180 <title>tp_svc_channel_request_implement_cancel ()</title>
181 <indexterm zone="tp-svc-channel-request-implement-cancel"><primary sortas="tp_svc_channel_request_implement_cancel">tp_svc_channel_request_implement_cancel</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_implement_cancel
182 (<link linkend="TpSvcChannelRequestClass">TpSvcChannelRequestClass</link> *klass,
183 <link linkend="tp-svc-channel-request-cancel-impl">tp_svc_channel_request_cancel_impl</link> impl);</programlisting>
184 <para>
185 Register an implementation for the Cancel method in the vtable
186 of an implementation of this interface. To be called from
187 the interface init function.</para>
188 <para>
189 </para><variablelist role="params">
190 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
191 <listitem><simpara> A class whose instances implement this interface
192 </simpara></listitem></varlistentry>
193 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
194 <listitem><simpara> A callback used to implement the Cancel D-Bus method
195 </simpara></listitem></varlistentry>
196 </variablelist></refsect2>
197 <refsect2 id="tp-svc-channel-request-emit-failed" role="function">
198 <title>tp_svc_channel_request_emit_failed ()</title>
199 <indexterm zone="tp-svc-channel-request-emit-failed"><primary sortas="tp_svc_channel_request_emit_failed">tp_svc_channel_request_emit_failed</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_emit_failed (<link linkend="gpointer">gpointer</link> instance,
200 const <link linkend="gchar">gchar</link> *arg_Error,
201 const <link linkend="gchar">gchar</link> *arg_Message);</programlisting>
202 <para>
203 Type-safe wrapper around g_signal_emit to emit the
204 Failed signal on interface org.freedesktop.Telepathy.ChannelRequest.</para>
205 <para>
206 </para><variablelist role="params">
207 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
208 <listitem><simpara> The object implementing this interface
209 </simpara></listitem></varlistentry>
210 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
211 <listitem><simpara> const gchar * (FIXME, generate documentation)
212 </simpara></listitem></varlistentry>
213 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
214 <listitem><simpara> const gchar * (FIXME, generate documentation)
215 </simpara></listitem></varlistentry>
216 </variablelist></refsect2>
217 <refsect2 id="tp-svc-channel-request-emit-succeeded" role="function">
218 <title>tp_svc_channel_request_emit_succeeded ()</title>
219 <indexterm zone="tp-svc-channel-request-emit-succeeded"><primary sortas="tp_svc_channel_request_emit_succeeded">tp_svc_channel_request_emit_succeeded</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_channel_request_emit_succeeded
220 (<link linkend="gpointer">gpointer</link> instance);</programlisting>
221 <para>
222 Type-safe wrapper around g_signal_emit to emit the
223 Succeeded signal on interface org.freedesktop.Telepathy.ChannelRequest.</para>
224 <para>
225 </para><variablelist role="params">
226 <varlistentry><term><parameter>instance</parameter>&#160;:</term>
227 <listitem><simpara> The object implementing this interface
228 </simpara></listitem></varlistentry>
229 </variablelist></refsect2>
230
231 </refsect1>
232
233 <refsect1 id="telepathy-glib-svc-channel-request.signal-details" role="signals">
234 <title role="signals.title">Signal Details</title>
235 <refsect2 id="TpSvcChannelRequest-failed" role="signal"><title>The <literal>&quot;failed&quot;</literal> signal</title>
236 <indexterm zone="TpSvcChannelRequest-failed"><primary sortas="TpSvcChannelRequest::failed">TpSvcChannelRequest::failed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *arg_Error,
237 <link linkend="gchar">gchar</link> *arg_Message,
238 <link linkend="gchar">gchar</link> *arg2,
239 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
240 <para>
241 The Failed D-Bus signal is emitted whenever this GObject signal is.</para>
242 <para>
243 </para><variablelist role="params">
244 <varlistentry><term><parameter>arg_Error</parameter>&#160;:</term>
245 <listitem><simpara> const gchar * (FIXME, generate documentation)
246 </simpara></listitem></varlistentry>
247 <varlistentry><term><parameter>arg_Message</parameter>&#160;:</term>
248 <listitem><simpara> const gchar * (FIXME, generate documentation)
249 </simpara></listitem></varlistentry>
250 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
251 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
252 </variablelist></refsect2><refsect2 id="TpSvcChannelRequest-succeeded" role="signal"><title>The <literal>&quot;succeeded&quot;</literal> signal</title>
253 <indexterm zone="TpSvcChannelRequest-succeeded"><primary sortas="TpSvcChannelRequest::succeeded">TpSvcChannelRequest::succeeded</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="TpSvcChannelRequest">TpSvcChannelRequest</link> *arg0,
254 <link linkend="gpointer">gpointer</link> user_data) : Run Last / Has Details</programlisting>
255 <para>
256 The Succeeded D-Bus signal is emitted whenever this GObject signal is.</para>
257 <para>
258 </para><variablelist role="params">
259 <varlistentry><term><parameter>user_data</parameter>&#160;:</term>
260 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
261 </variablelist></refsect2>
262 </refsect1>
263
264
265
266 </refentry>
0 <?xml version="1.0"?>
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
3 <refentry id="telepathy-glib-svc-client">
4 <refmeta>
5 <refentrytitle role="top_of_page" id="telepathy-glib-svc-client.top_of_page">Service-side Client interfaces</refentrytitle>
6 <manvolnum>3</manvolnum>
7 <refmiscinfo>TELEPATHY-GLIB Library</refmiscinfo>
8 </refmeta>
9
10 <refnamediv>
11 <refname>Service-side Client interfaces</refname>
12 <refpurpose>interfaces used to be an Observer, Approver and Handler</refpurpose>
13 </refnamediv>
14
15 <refsynopsisdiv id="telepathy-glib-svc-client.synopsis" role="synopsis">
16 <title role="synopsis.title">Synopsis</title>
17 <anchor id="TpSvcClient"/><anchor id="TpSvcClientApprover"/><anchor id="TpSvcClientHandler"/><anchor id="TpSvcClientInterfaceRequests"/><anchor id="TpSvcClientObserver"/>
18 <synopsis>
19
20 #include &lt;telepathy-glib/svc-client.h&gt;
21
22 <link linkend="TpSvcClient-struct">TpSvcClient</link>;
23 <link linkend="TpSvcClientClass">TpSvcClientClass</link>;
24
25 <link linkend="TpSvcClientApprover-struct">TpSvcClientApprover</link>;
26 <link linkend="TpSvcClientApproverClass">TpSvcClientApproverClass</link>;
27 <link linkend="void">void</link> <link linkend="tp-svc-client-approver-return-from-add-dispatch-operation">tp_svc_client_approver_return_from_add_dispatch_operation</link>
28 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
29 <link linkend="void">void</link> (<link linkend="tp-svc-client-approver-add-dispatch-operation-impl">*tp_svc_client_approver_add_dispatch_operation_impl</link>)
30 (<link linkend="TpSvcClientApprover">TpSvcClientApprover</link> *self,
31 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
32 const <link linkend="gchar">gchar</link> *in_DispatchOperation,
33 <link linkend="GHashTable">GHashTable</link> *in_Properties,
34 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
35 <link linkend="void">void</link> <link linkend="tp-svc-client-approver-implement-add-dispatch-operation">tp_svc_client_approver_implement_add_dispatch_operation</link>
36 (<link linkend="TpSvcClientApproverClass">TpSvcClientApproverClass</link> *klass,
37 <link linkend="tp-svc-client-approver-add-dispatch-operation-impl">tp_svc_client_approver_add_dispatch_operation_impl</link> impl);
38
39 <link linkend="TpSvcClientHandler-struct">TpSvcClientHandler</link>;
40 <link linkend="TpSvcClientHandlerClass">TpSvcClientHandlerClass</link>;
41 <link linkend="void">void</link> <link linkend="tp-svc-client-handler-return-from-handle-channels">tp_svc_client_handler_return_from_handle_channels</link>
42 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
43 <link linkend="void">void</link> (<link linkend="tp-svc-client-handler-handle-channels-impl">*tp_svc_client_handler_handle_channels_impl</link>)
44 (<link linkend="TpSvcClientHandler">TpSvcClientHandler</link> *self,
45 const <link linkend="gchar">gchar</link> *in_Account,
46 const <link linkend="gchar">gchar</link> *in_Connection,
47 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
48 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
49 <link linkend="guint64">guint64</link> in_User_Action_Time,
50 <link linkend="GHashTable">GHashTable</link> *in_Handler_Info,
51 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
52 <link linkend="void">void</link> <link linkend="tp-svc-client-handler-implement-handle-channels">tp_svc_client_handler_implement_handle_channels</link>
53 (<link linkend="TpSvcClientHandlerClass">TpSvcClientHandlerClass</link> *klass,
54 <link linkend="tp-svc-client-handler-handle-channels-impl">tp_svc_client_handler_handle_channels_impl</link> impl);
55 <link linkend="TpSvcClientInterfaceRequests-struct">TpSvcClientInterfaceRequests</link>;
56 <link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link>;
57 <link linkend="void">void</link> <link linkend="tp-svc-client-interface-requests-return-from-add-request">tp_svc_client_interface_requests_return_from_add_request</link>
58 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
59 <link linkend="void">void</link> (<link linkend="tp-svc-client-interface-requests-add-request-impl">*tp_svc_client_interface_requests_add_request_impl</link>)
60 (<link linkend="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</link> *self,
61 const <link linkend="gchar">gchar</link> *in_Request,
62 <link linkend="GHashTable">GHashTable</link> *in_Properties,
63 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
64 <link linkend="void">void</link> <link linkend="tp-svc-client-interface-requests-implement-add-request">tp_svc_client_interface_requests_implement_add_request</link>
65 (<link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link> *klass,
66 <link linkend="tp-svc-client-interface-requests-add-request-impl">tp_svc_client_interface_requests_add_request_impl</link> impl);
67 <link linkend="void">void</link> <link linkend="tp-svc-client-interface-requests-return-from-remove-request">tp_svc_client_interface_requests_return_from_remove_request</link>
68 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
69 <link linkend="void">void</link> (<link linkend="tp-svc-client-interface-requests-remove-request-impl">*tp_svc_client_interface_requests_remove_request_impl</link>)
70 (<link linkend="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</link> *self,
71 const <link linkend="gchar">gchar</link> *in_Request,
72 const <link linkend="gchar">gchar</link> *in_Error,
73 const <link linkend="gchar">gchar</link> *in_Message,
74 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
75 <link linkend="void">void</link> <link linkend="tp-svc-client-interface-requests-implement-remove-request">tp_svc_client_interface_requests_implement_remove_request</link>
76 (<link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link> *klass,
77 <link linkend="tp-svc-client-interface-requests-remove-request-impl">tp_svc_client_interface_requests_remove_request_impl</link> impl);
78
79 <link linkend="TpSvcClientObserver-struct">TpSvcClientObserver</link>;
80 <link linkend="TpSvcClientObserverClass">TpSvcClientObserverClass</link>;
81 <link linkend="void">void</link> <link linkend="tp-svc-client-observer-return-from-observe-channels">tp_svc_client_observer_return_from_observe_channels</link>
82 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
83 <link linkend="void">void</link> (<link linkend="tp-svc-client-observer-observe-channels-impl">*tp_svc_client_observer_observe_channels_impl</link>)
84 (<link linkend="TpSvcClientObserver">TpSvcClientObserver</link> *self,
85 const <link linkend="gchar">gchar</link> *in_Account,
86 const <link linkend="gchar">gchar</link> *in_Connection,
87 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
88 const <link linkend="gchar">gchar</link> *in_Dispatch_Operation,
89 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
90 <link linkend="GHashTable">GHashTable</link> *in_Observer_Info,
91 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);
92 <link linkend="void">void</link> <link linkend="tp-svc-client-observer-implement-observe-channels">tp_svc_client_observer_implement_observe_channels</link>
93 (<link linkend="TpSvcClientObserverClass">TpSvcClientObserverClass</link> *klass,
94 <link linkend="tp-svc-client-observer-observe-channels-impl">tp_svc_client_observer_observe_channels_impl</link> impl);
95 </synopsis>
96 </refsynopsisdiv>
97
98 <refsect1 id="telepathy-glib-svc-client.object-hierarchy" role="object_hierarchy">
99 <title role="object_hierarchy.title">Object Hierarchy</title>
100 <synopsis>
101 <link linkend="GInterface">GInterface</link>
102 +----TpSvcClient
103 </synopsis>
104 <synopsis>
105 <link linkend="GInterface">GInterface</link>
106 +----TpSvcClientApprover
107 </synopsis>
108 <synopsis>
109 <link linkend="GInterface">GInterface</link>
110 +----TpSvcClientHandler
111 </synopsis>
112 <synopsis>
113 <link linkend="GInterface">GInterface</link>
114 +----TpSvcClientInterfaceRequests
115 </synopsis>
116 <synopsis>
117 <link linkend="GInterface">GInterface</link>
118 +----TpSvcClientObserver
119 </synopsis>
120 </refsect1>
121
122
123
124
125
126
127
128
129 <refsect1 id="telepathy-glib-svc-client.description" role="desc">
130 <title role="desc.title">Description</title>
131 <para>
132 These interfaces (auto-generated from the telepathy spec) make it easier
133 to export the objects used to implement a Telepathy client.
134 </para>
135 <para>
136 Clients such as loggers, new message notification windows and chat UIs
137 should implement some or all of the Client types (Observer, Approver and/or
138 Handler): see telepathy-spec for details.</para>
139 <para>
140 </para>
141 </refsect1>
142
143 <refsect1 id="telepathy-glib-svc-client.details" role="details">
144 <title role="details.title">Details</title>
145 <refsect2 id="TpSvcClient-struct" role="struct">
146 <title>TpSvcClient</title>
147 <indexterm zone="TpSvcClient-struct"><primary sortas="TpSvcClient">TpSvcClient</primary></indexterm><programlisting>typedef struct _TpSvcClient TpSvcClient;</programlisting>
148 <para>
149 Dummy typedef representing any implementation of this interface.</para>
150 <para>
151 </para></refsect2>
152 <refsect2 id="TpSvcClientClass" role="struct">
153 <title>TpSvcClientClass</title>
154 <indexterm zone="TpSvcClientClass"><primary sortas="TpSvcClientClass">TpSvcClientClass</primary></indexterm><programlisting>typedef struct _TpSvcClientClass TpSvcClientClass;</programlisting>
155 <para>
156 The class of TpSvcClient.</para>
157 <para>
158 </para></refsect2>
159 <refsect2 id="TpSvcClientApprover-struct" role="struct">
160 <title>TpSvcClientApprover</title>
161 <indexterm zone="TpSvcClientApprover-struct"><primary sortas="TpSvcClientApprover">TpSvcClientApprover</primary></indexterm><programlisting>typedef struct _TpSvcClientApprover TpSvcClientApprover;</programlisting>
162 <para>
163 Dummy typedef representing any implementation of this interface.</para>
164 <para>
165 </para></refsect2>
166 <refsect2 id="TpSvcClientApproverClass" role="struct">
167 <title>TpSvcClientApproverClass</title>
168 <indexterm zone="TpSvcClientApproverClass"><primary sortas="TpSvcClientApproverClass">TpSvcClientApproverClass</primary></indexterm><programlisting>typedef struct _TpSvcClientApproverClass TpSvcClientApproverClass;</programlisting>
169 <para>
170 The class of TpSvcClientApprover.</para>
171 <para>
172 </para></refsect2>
173 <refsect2 id="tp-svc-client-approver-return-from-add-dispatch-operation" role="function">
174 <title>tp_svc_client_approver_return_from_add_dispatch_operation ()</title>
175 <indexterm zone="tp-svc-client-approver-return-from-add-dispatch-operation"><primary sortas="tp_svc_client_approver_return_from_add_dispatch_operation">tp_svc_client_approver_return_from_add_dispatch_operation</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_approver_return_from_add_dispatch_operation
176 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
177 <para>
178 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
179 This inline function exists only to provide type-safety.</para>
180 <para>
181 </para><variablelist role="params">
182 <varlistentry><term><parameter>context</parameter>&#160;:</term>
183 <listitem><simpara> The D-Bus method invocation context
184 </simpara></listitem></varlistentry>
185 </variablelist></refsect2>
186 <refsect2 id="tp-svc-client-approver-add-dispatch-operation-impl" role="function">
187 <title>tp_svc_client_approver_add_dispatch_operation_impl ()</title>
188 <indexterm zone="tp-svc-client-approver-add-dispatch-operation-impl"><primary sortas="tp_svc_client_approver_add_dispatch_operation_impl">tp_svc_client_approver_add_dispatch_operation_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_client_approver_add_dispatch_operation_impl)
189 (<link linkend="TpSvcClientApprover">TpSvcClientApprover</link> *self,
190 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
191 const <link linkend="gchar">gchar</link> *in_DispatchOperation,
192 <link linkend="GHashTable">GHashTable</link> *in_Properties,
193 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
194 <para>
195 The signature of an implementation of the D-Bus method
196 AddDispatchOperation on interface org.freedesktop.Telepathy.Client.Approver.</para>
197 <para>
198 </para><variablelist role="params">
199 <varlistentry><term><parameter>self</parameter>&#160;:</term>
200 <listitem><simpara> The object implementing this interface
201 </simpara></listitem></varlistentry>
202 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
203 <listitem><simpara> const GPtrArray * (FIXME, generate documentation)
204 </simpara></listitem></varlistentry>
205 <varlistentry><term><parameter>in_DispatchOperation</parameter>&#160;:</term>
206 <listitem><simpara> const gchar * (FIXME, generate documentation)
207 </simpara></listitem></varlistentry>
208 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
209 <listitem><simpara> GHashTable * (FIXME, generate documentation)
210 </simpara></listitem></varlistentry>
211 <varlistentry><term><parameter>context</parameter>&#160;:</term>
212 <listitem><simpara> Used to return values or throw an error
213 </simpara></listitem></varlistentry>
214 </variablelist></refsect2>
215 <refsect2 id="tp-svc-client-approver-implement-add-dispatch-operation" role="function">
216 <title>tp_svc_client_approver_implement_add_dispatch_operation ()</title>
217 <indexterm zone="tp-svc-client-approver-implement-add-dispatch-operation"><primary sortas="tp_svc_client_approver_implement_add_dispatch_operation">tp_svc_client_approver_implement_add_dispatch_operation</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_approver_implement_add_dispatch_operation
218 (<link linkend="TpSvcClientApproverClass">TpSvcClientApproverClass</link> *klass,
219 <link linkend="tp-svc-client-approver-add-dispatch-operation-impl">tp_svc_client_approver_add_dispatch_operation_impl</link> impl);</programlisting>
220 <para>
221 Register an implementation for the AddDispatchOperation method in the vtable
222 of an implementation of this interface. To be called from
223 the interface init function.</para>
224 <para>
225 </para><variablelist role="params">
226 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
227 <listitem><simpara> A class whose instances implement this interface
228 </simpara></listitem></varlistentry>
229 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
230 <listitem><simpara> A callback used to implement the AddDispatchOperation D-Bus method
231 </simpara></listitem></varlistentry>
232 </variablelist></refsect2>
233 <refsect2 id="TpSvcClientHandler-struct" role="struct">
234 <title>TpSvcClientHandler</title>
235 <indexterm zone="TpSvcClientHandler-struct"><primary sortas="TpSvcClientHandler">TpSvcClientHandler</primary></indexterm><programlisting>typedef struct _TpSvcClientHandler TpSvcClientHandler;</programlisting>
236 <para>
237 Dummy typedef representing any implementation of this interface.</para>
238 <para>
239 </para></refsect2>
240 <refsect2 id="TpSvcClientHandlerClass" role="struct">
241 <title>TpSvcClientHandlerClass</title>
242 <indexterm zone="TpSvcClientHandlerClass"><primary sortas="TpSvcClientHandlerClass">TpSvcClientHandlerClass</primary></indexterm><programlisting>typedef struct _TpSvcClientHandlerClass TpSvcClientHandlerClass;</programlisting>
243 <para>
244 The class of TpSvcClientHandler.</para>
245 <para>
246 </para></refsect2>
247 <refsect2 id="tp-svc-client-handler-return-from-handle-channels" role="function">
248 <title>tp_svc_client_handler_return_from_handle_channels ()</title>
249 <indexterm zone="tp-svc-client-handler-return-from-handle-channels"><primary sortas="tp_svc_client_handler_return_from_handle_channels">tp_svc_client_handler_return_from_handle_channels</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_handler_return_from_handle_channels
250 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
251 <para>
252 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
253 This inline function exists only to provide type-safety.</para>
254 <para>
255 </para><variablelist role="params">
256 <varlistentry><term><parameter>context</parameter>&#160;:</term>
257 <listitem><simpara> The D-Bus method invocation context
258 </simpara></listitem></varlistentry>
259 </variablelist></refsect2>
260 <refsect2 id="tp-svc-client-handler-handle-channels-impl" role="function">
261 <title>tp_svc_client_handler_handle_channels_impl ()</title>
262 <indexterm zone="tp-svc-client-handler-handle-channels-impl"><primary sortas="tp_svc_client_handler_handle_channels_impl">tp_svc_client_handler_handle_channels_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_client_handler_handle_channels_impl)
263 (<link linkend="TpSvcClientHandler">TpSvcClientHandler</link> *self,
264 const <link linkend="gchar">gchar</link> *in_Account,
265 const <link linkend="gchar">gchar</link> *in_Connection,
266 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
267 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
268 <link linkend="guint64">guint64</link> in_User_Action_Time,
269 <link linkend="GHashTable">GHashTable</link> *in_Handler_Info,
270 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
271 <para>
272 The signature of an implementation of the D-Bus method
273 HandleChannels on interface org.freedesktop.Telepathy.Client.Handler.</para>
274 <para>
275 </para><variablelist role="params">
276 <varlistentry><term><parameter>self</parameter>&#160;:</term>
277 <listitem><simpara> The object implementing this interface
278 </simpara></listitem></varlistentry>
279 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
280 <listitem><simpara> const gchar * (FIXME, generate documentation)
281 </simpara></listitem></varlistentry>
282 <varlistentry><term><parameter>in_Connection</parameter>&#160;:</term>
283 <listitem><simpara> const gchar * (FIXME, generate documentation)
284 </simpara></listitem></varlistentry>
285 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
286 <listitem><simpara> const GPtrArray * (FIXME, generate documentation)
287 </simpara></listitem></varlistentry>
288 <varlistentry><term><parameter>in_Requests_Satisfied</parameter>&#160;:</term>
289 <listitem><simpara> const GPtrArray * (FIXME, generate documentation)
290 </simpara></listitem></varlistentry>
291 <varlistentry><term><parameter>in_User_Action_Time</parameter>&#160;:</term>
292 <listitem><simpara> guint64 (FIXME, generate documentation)
293 </simpara></listitem></varlistentry>
294 <varlistentry><term><parameter>in_Handler_Info</parameter>&#160;:</term>
295 <listitem><simpara> GHashTable * (FIXME, generate documentation)
296 </simpara></listitem></varlistentry>
297 <varlistentry><term><parameter>context</parameter>&#160;:</term>
298 <listitem><simpara> Used to return values or throw an error
299 </simpara></listitem></varlistentry>
300 </variablelist></refsect2>
301 <refsect2 id="tp-svc-client-handler-implement-handle-channels" role="function">
302 <title>tp_svc_client_handler_implement_handle_channels ()</title>
303 <indexterm zone="tp-svc-client-handler-implement-handle-channels"><primary sortas="tp_svc_client_handler_implement_handle_channels">tp_svc_client_handler_implement_handle_channels</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_handler_implement_handle_channels
304 (<link linkend="TpSvcClientHandlerClass">TpSvcClientHandlerClass</link> *klass,
305 <link linkend="tp-svc-client-handler-handle-channels-impl">tp_svc_client_handler_handle_channels_impl</link> impl);</programlisting>
306 <para>
307 Register an implementation for the HandleChannels method in the vtable
308 of an implementation of this interface. To be called from
309 the interface init function.</para>
310 <para>
311 </para><variablelist role="params">
312 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
313 <listitem><simpara> A class whose instances implement this interface
314 </simpara></listitem></varlistentry>
315 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
316 <listitem><simpara> A callback used to implement the HandleChannels D-Bus method
317 </simpara></listitem></varlistentry>
318 </variablelist></refsect2>
319 <refsect2 id="TpSvcClientInterfaceRequests-struct" role="struct">
320 <title>TpSvcClientInterfaceRequests</title>
321 <indexterm zone="TpSvcClientInterfaceRequests-struct"><primary sortas="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</primary></indexterm><programlisting>typedef struct _TpSvcClientInterfaceRequests TpSvcClientInterfaceRequests;</programlisting>
322 <para>
323 Dummy typedef representing any implementation of this interface.</para>
324 <para>
325 </para></refsect2>
326 <refsect2 id="TpSvcClientInterfaceRequestsClass" role="struct">
327 <title>TpSvcClientInterfaceRequestsClass</title>
328 <indexterm zone="TpSvcClientInterfaceRequestsClass"><primary sortas="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</primary></indexterm><programlisting>typedef struct _TpSvcClientInterfaceRequestsClass TpSvcClientInterfaceRequestsClass;</programlisting>
329 <para>
330 The class of TpSvcClientInterfaceRequests.</para>
331 <para>
332 </para></refsect2>
333 <refsect2 id="tp-svc-client-interface-requests-return-from-add-request" role="function">
334 <title>tp_svc_client_interface_requests_return_from_add_request ()</title>
335 <indexterm zone="tp-svc-client-interface-requests-return-from-add-request"><primary sortas="tp_svc_client_interface_requests_return_from_add_request">tp_svc_client_interface_requests_return_from_add_request</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_interface_requests_return_from_add_request
336 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
337 <para>
338 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
339 This inline function exists only to provide type-safety.</para>
340 <para>
341 </para><variablelist role="params">
342 <varlistentry><term><parameter>context</parameter>&#160;:</term>
343 <listitem><simpara> The D-Bus method invocation context
344 </simpara></listitem></varlistentry>
345 </variablelist></refsect2>
346 <refsect2 id="tp-svc-client-interface-requests-add-request-impl" role="function">
347 <title>tp_svc_client_interface_requests_add_request_impl ()</title>
348 <indexterm zone="tp-svc-client-interface-requests-add-request-impl"><primary sortas="tp_svc_client_interface_requests_add_request_impl">tp_svc_client_interface_requests_add_request_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_client_interface_requests_add_request_impl)
349 (<link linkend="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</link> *self,
350 const <link linkend="gchar">gchar</link> *in_Request,
351 <link linkend="GHashTable">GHashTable</link> *in_Properties,
352 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
353 <para>
354 The signature of an implementation of the D-Bus method
355 AddRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.</para>
356 <para>
357 </para><variablelist role="params">
358 <varlistentry><term><parameter>self</parameter>&#160;:</term>
359 <listitem><simpara> The object implementing this interface
360 </simpara></listitem></varlistentry>
361 <varlistentry><term><parameter>in_Request</parameter>&#160;:</term>
362 <listitem><simpara> const gchar * (FIXME, generate documentation)
363 </simpara></listitem></varlistentry>
364 <varlistentry><term><parameter>in_Properties</parameter>&#160;:</term>
365 <listitem><simpara> GHashTable * (FIXME, generate documentation)
366 </simpara></listitem></varlistentry>
367 <varlistentry><term><parameter>context</parameter>&#160;:</term>
368 <listitem><simpara> Used to return values or throw an error
369 </simpara></listitem></varlistentry>
370 </variablelist></refsect2>
371 <refsect2 id="tp-svc-client-interface-requests-implement-add-request" role="function">
372 <title>tp_svc_client_interface_requests_implement_add_request ()</title>
373 <indexterm zone="tp-svc-client-interface-requests-implement-add-request"><primary sortas="tp_svc_client_interface_requests_implement_add_request">tp_svc_client_interface_requests_implement_add_request</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_interface_requests_implement_add_request
374 (<link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link> *klass,
375 <link linkend="tp-svc-client-interface-requests-add-request-impl">tp_svc_client_interface_requests_add_request_impl</link> impl);</programlisting>
376 <para>
377 Register an implementation for the AddRequest method in the vtable
378 of an implementation of this interface. To be called from
379 the interface init function.</para>
380 <para>
381 </para><variablelist role="params">
382 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
383 <listitem><simpara> A class whose instances implement this interface
384 </simpara></listitem></varlistentry>
385 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
386 <listitem><simpara> A callback used to implement the AddRequest D-Bus method
387 </simpara></listitem></varlistentry>
388 </variablelist></refsect2>
389 <refsect2 id="tp-svc-client-interface-requests-return-from-remove-request" role="function">
390 <title>tp_svc_client_interface_requests_return_from_remove_request ()</title>
391 <indexterm zone="tp-svc-client-interface-requests-return-from-remove-request"><primary sortas="tp_svc_client_interface_requests_return_from_remove_request">tp_svc_client_interface_requests_return_from_remove_request</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_interface_requests_return_from_remove_request
392 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
393 <para>
394 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
395 This inline function exists only to provide type-safety.</para>
396 <para>
397 </para><variablelist role="params">
398 <varlistentry><term><parameter>context</parameter>&#160;:</term>
399 <listitem><simpara> The D-Bus method invocation context
400 </simpara></listitem></varlistentry>
401 </variablelist></refsect2>
402 <refsect2 id="tp-svc-client-interface-requests-remove-request-impl" role="function">
403 <title>tp_svc_client_interface_requests_remove_request_impl ()</title>
404 <indexterm zone="tp-svc-client-interface-requests-remove-request-impl"><primary sortas="tp_svc_client_interface_requests_remove_request_impl">tp_svc_client_interface_requests_remove_request_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_client_interface_requests_remove_request_impl)
405 (<link linkend="TpSvcClientInterfaceRequests">TpSvcClientInterfaceRequests</link> *self,
406 const <link linkend="gchar">gchar</link> *in_Request,
407 const <link linkend="gchar">gchar</link> *in_Error,
408 const <link linkend="gchar">gchar</link> *in_Message,
409 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
410 <para>
411 The signature of an implementation of the D-Bus method
412 RemoveRequest on interface org.freedesktop.Telepathy.Client.Interface.Requests.</para>
413 <para>
414 </para><variablelist role="params">
415 <varlistentry><term><parameter>self</parameter>&#160;:</term>
416 <listitem><simpara> The object implementing this interface
417 </simpara></listitem></varlistentry>
418 <varlistentry><term><parameter>in_Request</parameter>&#160;:</term>
419 <listitem><simpara> const gchar * (FIXME, generate documentation)
420 </simpara></listitem></varlistentry>
421 <varlistentry><term><parameter>in_Error</parameter>&#160;:</term>
422 <listitem><simpara> const gchar * (FIXME, generate documentation)
423 </simpara></listitem></varlistentry>
424 <varlistentry><term><parameter>in_Message</parameter>&#160;:</term>
425 <listitem><simpara> const gchar * (FIXME, generate documentation)
426 </simpara></listitem></varlistentry>
427 <varlistentry><term><parameter>context</parameter>&#160;:</term>
428 <listitem><simpara> Used to return values or throw an error
429 </simpara></listitem></varlistentry>
430 </variablelist></refsect2>
431 <refsect2 id="tp-svc-client-interface-requests-implement-remove-request" role="function">
432 <title>tp_svc_client_interface_requests_implement_remove_request ()</title>
433 <indexterm zone="tp-svc-client-interface-requests-implement-remove-request"><primary sortas="tp_svc_client_interface_requests_implement_remove_request">tp_svc_client_interface_requests_implement_remove_request</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_interface_requests_implement_remove_request
434 (<link linkend="TpSvcClientInterfaceRequestsClass">TpSvcClientInterfaceRequestsClass</link> *klass,
435 <link linkend="tp-svc-client-interface-requests-remove-request-impl">tp_svc_client_interface_requests_remove_request_impl</link> impl);</programlisting>
436 <para>
437 Register an implementation for the RemoveRequest method in the vtable
438 of an implementation of this interface. To be called from
439 the interface init function.</para>
440 <para>
441 </para><variablelist role="params">
442 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
443 <listitem><simpara> A class whose instances implement this interface
444 </simpara></listitem></varlistentry>
445 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
446 <listitem><simpara> A callback used to implement the RemoveRequest D-Bus method
447 </simpara></listitem></varlistentry>
448 </variablelist></refsect2>
449 <refsect2 id="TpSvcClientObserver-struct" role="struct">
450 <title>TpSvcClientObserver</title>
451 <indexterm zone="TpSvcClientObserver-struct"><primary sortas="TpSvcClientObserver">TpSvcClientObserver</primary></indexterm><programlisting>typedef struct _TpSvcClientObserver TpSvcClientObserver;</programlisting>
452 <para>
453 Dummy typedef representing any implementation of this interface.</para>
454 <para>
455 </para></refsect2>
456 <refsect2 id="TpSvcClientObserverClass" role="struct">
457 <title>TpSvcClientObserverClass</title>
458 <indexterm zone="TpSvcClientObserverClass"><primary sortas="TpSvcClientObserverClass">TpSvcClientObserverClass</primary></indexterm><programlisting>typedef struct _TpSvcClientObserverClass TpSvcClientObserverClass;</programlisting>
459 <para>
460 The class of TpSvcClientObserver.</para>
461 <para>
462 </para></refsect2>
463 <refsect2 id="tp-svc-client-observer-return-from-observe-channels" role="function">
464 <title>tp_svc_client_observer_return_from_observe_channels ()</title>
465 <indexterm zone="tp-svc-client-observer-return-from-observe-channels"><primary sortas="tp_svc_client_observer_return_from_observe_channels">tp_svc_client_observer_return_from_observe_channels</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_observer_return_from_observe_channels
466 (<link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
467 <para>
468 Return successfully by calling <link linkend="dbus-g-method-return"><function>dbus_g_method_return()</function></link>.
469 This inline function exists only to provide type-safety.</para>
470 <para>
471 </para><variablelist role="params">
472 <varlistentry><term><parameter>context</parameter>&#160;:</term>
473 <listitem><simpara> The D-Bus method invocation context
474 </simpara></listitem></varlistentry>
475 </variablelist></refsect2>
476 <refsect2 id="tp-svc-client-observer-observe-channels-impl" role="function">
477 <title>tp_svc_client_observer_observe_channels_impl ()</title>
478 <indexterm zone="tp-svc-client-observer-observe-channels-impl"><primary sortas="tp_svc_client_observer_observe_channels_impl">tp_svc_client_observer_observe_channels_impl</primary></indexterm><programlisting><link linkend="void">void</link> (*tp_svc_client_observer_observe_channels_impl)
479 (<link linkend="TpSvcClientObserver">TpSvcClientObserver</link> *self,
480 const <link linkend="gchar">gchar</link> *in_Account,
481 const <link linkend="gchar">gchar</link> *in_Connection,
482 const <link linkend="GPtrArray">GPtrArray</link> *in_Channels,
483 const <link linkend="gchar">gchar</link> *in_Dispatch_Operation,
484 const <link linkend="GPtrArray">GPtrArray</link> *in_Requests_Satisfied,
485 <link linkend="GHashTable">GHashTable</link> *in_Observer_Info,
486 <link linkend="DBusGMethodInvocation">DBusGMethodInvocation</link> *context);</programlisting>
487 <para>
488 The signature of an implementation of the D-Bus method
489 ObserveChannels on interface org.freedesktop.Telepathy.Client.Observer.</para>
490 <para>
491 </para><variablelist role="params">
492 <varlistentry><term><parameter>self</parameter>&#160;:</term>
493 <listitem><simpara> The object implementing this interface
494 </simpara></listitem></varlistentry>
495 <varlistentry><term><parameter>in_Account</parameter>&#160;:</term>
496 <listitem><simpara> const gchar * (FIXME, generate documentation)
497 </simpara></listitem></varlistentry>
498 <varlistentry><term><parameter>in_Connection</parameter>&#160;:</term>
499 <listitem><simpara> const gchar * (FIXME, generate documentation)
500 </simpara></listitem></varlistentry>
501 <varlistentry><term><parameter>in_Channels</parameter>&#160;:</term>
502 <listitem><simpara> const GPtrArray * (FIXME, generate documentation)
503 </simpara></listitem></varlistentry>
504 <varlistentry><term><parameter>in_Dispatch_Operation</parameter>&#160;:</term>
505 <listitem><simpara> const gchar * (FIXME, generate documentation)
506 </simpara></listitem></varlistentry>
507 <varlistentry><term><parameter>in_Requests_Satisfied</parameter>&#160;:</term>
508 <listitem><simpara> const GPtrArray * (FIXME, generate documentation)
509 </simpara></listitem></varlistentry>
510 <varlistentry><term><parameter>in_Observer_Info</parameter>&#160;:</term>
511 <listitem><simpara> GHashTable * (FIXME, generate documentation)
512 </simpara></listitem></varlistentry>
513 <varlistentry><term><parameter>context</parameter>&#160;:</term>
514 <listitem><simpara> Used to return values or throw an error
515 </simpara></listitem></varlistentry>
516 </variablelist></refsect2>
517 <refsect2 id="tp-svc-client-observer-implement-observe-channels" role="function">
518 <title>tp_svc_client_observer_implement_observe_channels ()</title>
519 <indexterm zone="tp-svc-client-observer-implement-observe-channels"><primary sortas="tp_svc_client_observer_implement_observe_channels">tp_svc_client_observer_implement_observe_channels</primary></indexterm><programlisting><link linkend="void">void</link> tp_svc_client_observer_implement_observe_channels
520 (<link linkend="TpSvcClientObserverClass">TpSvcClientObserverClass</link> *klass,
521 <link linkend="tp-svc-client-observer-observe-channels-impl">tp_svc_client_observer_observe_channels_impl</link> impl);</programlisting>
522 <para>
523 Register an implementation for the ObserveChannels method in the vtable
524 of an implementation of this interface. To be called from
525 the interface init function.</para>
526 <para>
527 </para><variablelist role="params">
528 <varlistentry><term><parameter>klass</parameter>&#160;:</term>
529 <listitem><simpara> A class whose instances implement this interface
530 </simpara></listitem></varlistentry>
531 <varlistentry><term><parameter>impl</parameter>&#160;:</term>
532 <listitem><simpara> A callback used to implement the ObserveChannels D-Bus method
533 </simpara></listitem></varlistentry>
534 </variablelist></refsect2>
535
536 </refsect1>
537
538
539
540
541 </refentry>
388388 g_message ("Sending to server: Closing stream %u",
389389 self->priv->id);
390390
391 if (self->priv->connected_event_id != 0)
392 {
393 g_source_remove (self->priv->connected_event_id);
394 }
395
396 /* this has to come last, because the MediaChannel may unref us in
397 * response to the removed signal */
391398 g_signal_emit (self, signals[SIGNAL_REMOVED], 0);
392
393 if (self->priv->connected_event_id != 0)
394 {
395 g_source_remove (self->priv->connected_event_id);
396 }
397399 }
398400 }
399401
115115 $(QUIET_GEN)$(PYTHON) $(tools_dir)/xincludator.py $< > $@
116116
117117 _gen/cli-connection-body.h _gen/cli-connection.h: _gen/connection.xml \
118 $(tools_dir)/glib-client-gen.py
118 $(tools_dir)/glib-client-gen.py Makefile.am
119119 $(QUIET_GEN)$(PYTHON) $(tools_dir)/glib-client-gen.py \
120120 --group=connection \
121121 --subclass=TpConnection \
122122 --subclass-assert=TP_IS_CONNECTION \
123123 --iface-quark-prefix=EXAMPLE_IFACE_QUARK \
124124 --tp-proxy-api=0.7.6 \
125 --generate-reentrant \
125126 $< Example_Cli _gen/cli-connection
126127
127128 _gen/svc-connection.c _gen/svc-connection.h: _gen/connection.xml \
621621 $(QUIET_GEN)$(PYTHON) $(tools_dir)/xincludator.py $< > $@
622622
623623 _gen/cli-connection-body.h _gen/cli-connection.h: _gen/connection.xml \
624 $(tools_dir)/glib-client-gen.py
624 $(tools_dir)/glib-client-gen.py Makefile.am
625625 $(QUIET_GEN)$(PYTHON) $(tools_dir)/glib-client-gen.py \
626626 --group=connection \
627627 --subclass=TpConnection \
628628 --subclass-assert=TP_IS_CONNECTION \
629629 --iface-quark-prefix=EXAMPLE_IFACE_QUARK \
630630 --tp-proxy-api=0.7.6 \
631 --generate-reentrant \
631632 $< Example_Cli _gen/cli-connection
632633
633634 _gen/svc-connection.c _gen/svc-connection.h: _gen/connection.xml \
11 <node name="/Channel_Dispatch_Operation"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
33
4 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
5 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
5 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
66 <tp:license xmlns="http://www.w3.org/1999/xhtml">
77 <p>This library is free software; you can redistribute it and/or
88 modify it under the terms of the GNU Lesser General Public
2020 MA 02110-1301, USA.</p>
2121 </tp:license>
2222
23 <interface name="org.freedesktop.Telepathy.ChannelDispatchOperation"
24 tp:causes-havoc="not yet final">
23 <interface name="org.freedesktop.Telepathy.ChannelDispatchOperation">
24 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2525
2626 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
2727 <p>A channel dispatch operation is an object in the ChannelDispatcher
2020 USA.</p>
2121 </tp:license>
2222
23 <interface name="org.freedesktop.Telepathy.ChannelDispatcher"
24 tp:causes-havoc="not yet final">
23 <interface name="org.freedesktop.Telepathy.ChannelDispatcher">
24 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2525
2626 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
2727 <p>The channel dispatcher is responsible for responding to new
11 <node name="/Channel_Dispatcher_Interface_Operation_List"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
33
4 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
5 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
5 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
66 <tp:license xmlns="http://www.w3.org/1999/xhtml">
77 <p>This library is free software; you can redistribute it and/or
88 modify it under the terms of the GNU Lesser General Public
2020 USA.</p>
2121 </tp:license>
2222
23 <interface name="org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList"
24 tp:causes-havoc="not yet final">
23 <interface name="org.freedesktop.Telepathy.ChannelDispatcher.Interface.OperationList">
24 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2525
2626 <tp:requires interface="org.freedesktop.Telepathy.ChannelDispatcher"/>
2727
2020 MA 02110-1301, USA.</p>
2121 </tp:license>
2222
23 <interface name="org.freedesktop.Telepathy.ChannelRequest"
24 tp:causes-havoc="not yet final">
23 <interface name="org.freedesktop.Telepathy.ChannelRequest">
24 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2525
2626 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
2727 <p>A channel request is an object in the ChannelDispatcher representing
00 <?xml version="1.0" ?>
11 <node name="/Client"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
3 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
55 <tp:license xmlns="http://www.w3.org/1999/xhtml">
66 <p>This library is free software; you can redistribute it and/or
77 modify it under the terms of the GNU Lesser General Public
1919 02110-1301, USA.</p>
2020 </tp:license>
2121
22 <interface name="org.freedesktop.Telepathy.Client"
23 tp:causes-havoc="not yet final">
24 <tp:added version="0.17.12">(as a draft)</tp:added>
22 <interface name="org.freedesktop.Telepathy.Client">
23 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2524
2625 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
2726 <p>Telepathy clients use connection managers, the channel dispatcher
00 <?xml version="1.0" ?>
11 <node name="/Client_Approver"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
3 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
55 <tp:license xmlns="http://www.w3.org/1999/xhtml">
66 <p>This library is free software; you can redistribute it and/or
77 modify it under the terms of the GNU Lesser General Public
1919 02110-1301, USA.</p>
2020 </tp:license>
2121
22 <interface name="org.freedesktop.Telepathy.Client.Approver"
23 tp:causes-havoc="not yet final">
24 <tp:added version="0.17.12">(as a draft)</tp:added>
22 <interface name="org.freedesktop.Telepathy.Client.Approver">
23 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2524
2625 <tp:requires interface="org.freedesktop.Telepathy.Client"/>
2726
00 <?xml version="1.0" ?>
11 <node name="/Client_Handler"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
3 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
55 <tp:license xmlns="http://www.w3.org/1999/xhtml">
66 <p>This library is free software; you can redistribute it and/or
77 modify it under the terms of the GNU Lesser General Public
1919 02110-1301, USA.</p>
2020 </tp:license>
2121
22 <interface name="org.freedesktop.Telepathy.Client.Handler"
23 tp:causes-havoc="not yet final">
24 <tp:added version="0.17.12">(as a draft)</tp:added>
22 <interface name="org.freedesktop.Telepathy.Client.Handler">
23 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2524
2625 <tp:requires interface="org.freedesktop.Telepathy.Client"/>
2726
1919 02110-1301, USA.</p>
2020 </tp:license>
2121
22 <interface name="org.freedesktop.Telepathy.Client.Interface.Requests"
23 tp:causes-havoc="not yet final">
24 <tp:added version="0.17.23">(as a draft; functionality
25 moved from Handler)</tp:added>
22 <interface name="org.freedesktop.Telepathy.Client.Interface.Requests">
23 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2624
2725 <tp:requires interface="org.freedesktop.Telepathy.Client"/>
2826 <tp:requires interface="org.freedesktop.Telepathy.Client.Handler"/>
00 <?xml version="1.0" ?>
11 <node name="/Client_Observer"
22 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3 <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
3 <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright>
4 <tp:copyright>Copyright © 2008-2009 Nokia Corporation</tp:copyright>
55 <tp:license xmlns="http://www.w3.org/1999/xhtml">
66 <p>This library is free software; you can redistribute it and/or
77 modify it under the terms of the GNU Lesser General Public
1919 02110-1301, USA.</p>
2020 </tp:license>
2121
22 <interface name="org.freedesktop.Telepathy.Client.Observer"
23 tp:causes-havoc="not yet final">
24 <tp:added version="0.17.12">(as a draft)</tp:added>
22 <interface name="org.freedesktop.Telepathy.Client.Observer">
23 <tp:added version="0.17.26">(as a stable interface)</tp:added>
2524
2625 <tp:requires interface="org.freedesktop.Telepathy.Client"/>
2726
191190 (those that do match the filter) are passed to this method.</p>
192191
193192 <p>If the channel dispatcher will split up the channels from a single
194 NewChannels signal and dispatch them separately (for instance
193 NewChannels signal and dispatch them separately (for instance
195194 because no installed Handler can handle all of them), it will call
196195 ObserveChannels several times.</p>
197196
22 xmlns:xi="http://www.w3.org/2001/XInclude">
33
44 <tp:title>Telepathy D-Bus Interface Specification</tp:title>
5 <tp:version>0.17.25</tp:version>
5 <tp:version>0.17.26</tp:version>
66
77 <tp:copyright>Copyright © 2005-2009 Collabora Limited</tp:copyright>
88 <tp:copyright>Copyright © 2005-2009 Nokia Corporation</tp:copyright>
3131 </p>
3232 </tp:docstring>
3333 <xi:include href="Connection_Manager.xml"/>
34
34
3535 <tp:section name="Connection Object">
3636 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
3737 <p>
5353 </tp:section>
5454
5555 <xi:include href="Channel_Bundle.xml"/>
56
56
5757 <tp:section name="Channel Object">
5858 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
5959 <p>
8787 <xi:include href="Channel_Type_File_Transfer.xml"/>
8888 <xi:include href="Channel_Type_Contact_Search.xml"/>
8989 </tp:section>
90
90
9191 <tp:section name="Channel Interfaces">
9292 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
9393 <p>
00 include $(top_srcdir)/tools/shave.mk
1 include $(top_srcdir)/tools/flymake.mk
12
23 tpgincludedir=$(includedir)/telepathy-1.0/telepathy-glib
34 genincludedir=$(tpgincludedir)/_gen
3334 versions/0.7.28.abi \
3435 versions/0.7.29.abi \
3536 versions/0.7.30.abi \
36 versions/0.7.31.abi
37 versions/0.7.31.abi \
38 versions/0.7.32.abi
3739
3840 EXTRA_DIST = \
3941 $(ABI_LISTS) \
42 account.xml \
43 account-manager.xml \
4044 channel.xml \
45 channel-dispatcher.xml \
46 channel-dispatch-operation.xml \
47 channel-request.xml \
48 client.xml \
4149 connection.xml \
4250 connection-manager.xml \
4351 dbus-daemon.xml \
112120 endif # !HAVE_LD_VERSION_SCRIPT
113121
114122 tpginclude_HEADERS = \
123 account.h \
124 account-manager.h \
115125 base-connection.h \
116126 base-connection-manager.h \
117127 channel.h \
118128 channel-iface.h \
129 channel-dispatcher.h \
130 channel-dispatch-operation.h \
119131 channel-factory-iface.h \
120132 channel-manager.h \
121 media-interfaces.h \
133 channel-request.h \
134 client.h \
122135 connection.h \
123136 connection-manager.h \
124137 contact.h \
147160 proxy.h \
148161 proxy-subclass.h \
149162 run.h \
163 svc-account.h \
164 svc-account-manager.h \
165 svc-channel-dispatcher.h \
166 svc-channel-dispatch-operation.h \
150167 svc-channel.h \
168 svc-channel-request.h \
169 svc-client.h \
151170 svc-connection.h \
152171 svc-connection-manager.h \
153172 svc-generic.h \
165184 _gen/interfaces-body.h \
166185 _gen/gtypes-body.h \
167186 _gen/register-dbus-glib-marshallers-body.h \
187 _gen/tp-cli-account-body.h \
188 _gen/tp-cli-account-manager-body.h \
168189 _gen/tp-cli-channel-body.h \
190 _gen/tp-cli-channel-dispatcher-body.h \
191 _gen/tp-cli-channel-dispatch-operation-body.h \
192 _gen/tp-cli-channel-request-body.h \
193 _gen/tp-cli-client-body.h \
169194 _gen/tp-cli-connection-body.h \
170195 _gen/tp-cli-connection-manager-body.h \
171196 _gen/tp-cli-dbus-daemon-body.h \
172197 _gen/tp-cli-generic-body.h \
173198 _gen/tp-cli-media-session-handler-body.h \
174199 _gen/tp-cli-media-stream-handler-body.h \
200 _gen/tp-svc-account.c \
201 _gen/tp-svc-account-manager.c \
175202 _gen/tp-svc-channel.c \
203 _gen/tp-svc-channel-dispatcher.c \
204 _gen/tp-svc-channel-dispatch-operation.c \
205 _gen/tp-svc-channel-request.c \
206 _gen/tp-svc-client.c \
176207 _gen/tp-svc-connection.c \
177208 _gen/tp-svc-connection-manager.c \
178209 _gen/tp-svc-generic.c \
184215 _gen/telepathy-enums.h \
185216 _gen/telepathy-interfaces.h \
186217 _gen/gtypes.h \
218 _gen/tp-cli-account.h \
219 _gen/tp-cli-account-manager.h \
187220 _gen/tp-cli-channel.h \
221 _gen/tp-cli-channel-dispatcher.h \
222 _gen/tp-cli-channel-dispatch-operation.h \
223 _gen/tp-cli-channel-request.h \
224 _gen/tp-cli-client.h \
188225 _gen/tp-cli-connection.h \
189226 _gen/tp-cli-connection-manager.h \
190227 _gen/tp-cli-dbus-daemon.h \
191228 _gen/tp-cli-generic.h \
192229 _gen/tp-cli-media-session-handler.h \
193230 _gen/tp-cli-media-stream-handler.h \
231 _gen/tp-svc-account.h \
232 _gen/tp-svc-account-manager.h \
194233 _gen/tp-svc-channel.h \
234 _gen/tp-svc-channel-dispatcher.h \
235 _gen/tp-svc-channel-dispatch-operation.h \
236 _gen/tp-svc-channel-request.h \
237 _gen/tp-svc-client.h \
195238 _gen/tp-svc-connection.h \
196239 _gen/tp-svc-connection-manager.h \
197240 _gen/tp-svc-generic.h \
220263
221264 libtelepathy_glib_internal_la_LIBADD = $(ALL_LIBS)
222265 libtelepathy_glib_internal_la_SOURCES = \
266 account.c \
267 account-manager.c \
223268 base-connection.c \
224269 base-connection-manager.c \
225270 channel.c \
226271 channel-group.c \
227272 channel-internal.h \
273 channel-dispatcher.c \
274 channel-dispatch-operation.c \
228275 channel-manager.c \
276 channel-request.c \
277 client.c \
229278 connection.c \
230279 connection-internal.h \
231280 connection-handles.c \
361410 subclass= ; \
362411 subclass_assert= ; \
363412 case $* in \
413 generic) \
414 maybe_reentrant=--generate-reentrant; \
415 ;; \
416 account-manager) \
417 subclass=--subclass=TpAccountManager; \
418 subclass_assert=--subclass-assert=TP_IS_ACCOUNT_MANAGER; \
419 ;; \
420 account) \
421 subclass=--subclass=TpAccount; \
422 subclass_assert=--subclass-assert=TP_IS_ACCOUNT; \
423 ;; \
364424 channel) \
365425 subclass=--subclass=TpChannel; \
366426 subclass_assert=--subclass-assert=TP_IS_CHANNEL; \
427 maybe_reentrant=--generate-reentrant; \
428 ;; \
429 channel-dispatcher) \
430 subclass=--subclass=TpChannelDispatcher; \
431 subclass_assert=--subclass-assert=TP_IS_CHANNEL_DISPATCHER; \
432 ;; \
433 channel-dispatch-operation) \
434 subclass=--subclass=TpChannelDispatchOperation; \
435 subclass_assert=--subclass-assert=TP_IS_CHANNEL_DISPATCH_OPERATION; \
436 ;; \
437 channel-request) \
438 subclass=--subclass=TpChannelRequest; \
439 subclass_assert=--subclass-assert=TP_IS_CHANNEL_REQUEST; \
440 ;; \
441 client) \
442 subclass=--subclass=TpClient; \
443 subclass_assert=--subclass-assert=TP_IS_CLIENT; \
367444 ;; \
368445 connection-manager) \
369446 subclass=--subclass=TpConnectionManager; \
370447 subclass_assert=--subclass-assert=TP_IS_CONNECTION_MANAGER \
448 maybe_reentrant=--generate-reentrant; \
371449 ;; \
372450 connection) \
373451 subclass=--subclass=TpConnection; \
374452 subclass_assert=--subclass-assert=TP_IS_CONNECTION; \
453 maybe_reentrant=--generate-reentrant; \
375454 ;; \
376455 media-session-handler) \
377456 subclass=--subclass=TpMediaSessionHandler; \
378457 subclass_assert=--subclass-assert=TP_IS_MEDIA_SESSION_HANDLER; \
458 maybe_reentrant=--generate-reentrant; \
379459 ;; \
380460 media-stream-handler) \
381461 subclass=--subclass=TpMediaStreamHandler; \
382462 subclass_assert=--subclass-assert=TP_IS_MEDIA_STREAM_HANDLER; \
463 maybe_reentrant=--generate-reentrant; \
383464 ;; \
384465 dbus-daemon) \
385466 subclass=--subclass=TpDBusDaemon; \
386467 subclass_assert=--subclass-assert=TP_IS_DBUS_DAEMON; \
468 maybe_reentrant=--generate-reentrant; \
387469 ;; \
388470 esac; \
389471 $(PYTHON) $(tools_dir)/glib-client-gen.py \
391473 --group `echo $* | tr - _` \
392474 --iface-quark-prefix=TP_IFACE_QUARK \
393475 --tp-proxy-api=0.7.6 \
476 $$maybe_reentrant \
394477 $< Tp_Cli _gen/tp-cli-$*
4141 $(srcdir)/telepathy-glib-uninstalled.pc.in \
4242 $(srcdir)/telepathy-glib.pc.in \
4343 $(top_srcdir)/tools/check-coding-style.mk \
44 $(top_srcdir)/tools/shave.mk $(tpginclude_HEADERS)
44 $(top_srcdir)/tools/flymake.mk $(top_srcdir)/tools/shave.mk \
45 $(tpginclude_HEADERS)
4546 @HAVE_LD_VERSION_SCRIPT_TRUE@am__append_1 = _gen/version-script.txt
4647 @HAVE_LD_VERSION_SCRIPT_TRUE@am__append_2 = _gen/version-script.txt _gen/abi.txt
4748 @HAVE_LD_VERSION_SCRIPT_TRUE@am__append_3 = \
7576 LTLIBRARIES = $(lib_LTLIBRARIES) $(noinst_LTLIBRARIES)
7677 am__DEPENDENCIES_1 =
7778 libtelepathy_glib_internal_la_DEPENDENCIES = $(am__DEPENDENCIES_1)
78 am_libtelepathy_glib_internal_la_OBJECTS = base-connection.lo \
79 am_libtelepathy_glib_internal_la_OBJECTS = account.lo \
80 account-manager.lo base-connection.lo \
7981 base-connection-manager.lo channel.lo channel-group.lo \
80 channel-manager.lo connection.lo connection-handles.lo \
81 connection-manager.lo contact.lo contacts-mixin.lo dbus.lo \
82 dbus-properties-mixin.lo debug.lo interfaces.lo errors.lo \
83 exportable-channel.lo group-mixin.lo gtypes.lo handle.lo \
84 handle-repo.lo handle-repo-dynamic.lo handle-repo-static.lo \
85 handle-set.lo heap.lo intset.lo channel-iface.lo \
86 channel-factory-iface.lo media-interfaces.lo message-mixin.lo \
87 presence-mixin.lo properties-mixin.lo proxy.lo \
88 proxy-methods.lo proxy-signals.lo run.lo text-mixin.lo util.lo
82 channel-dispatcher.lo channel-dispatch-operation.lo \
83 channel-manager.lo channel-request.lo client.lo connection.lo \
84 connection-handles.lo connection-manager.lo contact.lo \
85 contacts-mixin.lo dbus.lo dbus-properties-mixin.lo debug.lo \
86 interfaces.lo errors.lo exportable-channel.lo group-mixin.lo \
87 gtypes.lo handle.lo handle-repo.lo handle-repo-dynamic.lo \
88 handle-repo-static.lo handle-set.lo heap.lo intset.lo \
89 channel-iface.lo channel-factory-iface.lo media-interfaces.lo \
90 message-mixin.lo presence-mixin.lo properties-mixin.lo \
91 proxy.lo proxy-methods.lo proxy-signals.lo run.lo \
92 text-mixin.lo util.lo
8993 nodist_libtelepathy_glib_internal_la_OBJECTS = error-str.lo \
90 signals-marshal.lo tp-svc-channel.lo tp-svc-connection.lo \
94 signals-marshal.lo tp-svc-account.lo tp-svc-account-manager.lo \
95 tp-svc-channel.lo tp-svc-channel-dispatcher.lo \
96 tp-svc-channel-dispatch-operation.lo tp-svc-channel-request.lo \
97 tp-svc-client.lo tp-svc-connection.lo \
9198 tp-svc-connection-manager.lo tp-svc-generic.lo \
9299 tp-svc-media-session-handler.lo tp-svc-media-stream-handler.lo
93100 libtelepathy_glib_internal_la_OBJECTS = \
305312 versions/0.7.28.abi \
306313 versions/0.7.29.abi \
307314 versions/0.7.30.abi \
308 versions/0.7.31.abi
315 versions/0.7.31.abi \
316 versions/0.7.32.abi
309317
310318 EXTRA_DIST = \
311319 $(ABI_LISTS) \
320 account.xml \
321 account-manager.xml \
312322 channel.xml \
323 channel-dispatcher.xml \
324 channel-dispatch-operation.xml \
325 channel-request.xml \
326 client.xml \
313327 connection.xml \
314328 connection-manager.xml \
315329 dbus-daemon.xml \
348362 # don't allow undocumented ABI
349363 @HAVE_LD_VERSION_SCRIPT_TRUE@@OFFICIAL_RELEASE_TRUE@MAKE_VERSION_SCRIPT_FLAGS =
350364 tpginclude_HEADERS = \
365 account.h \
366 account-manager.h \
351367 base-connection.h \
352368 base-connection-manager.h \
353369 channel.h \
354370 channel-iface.h \
371 channel-dispatcher.h \
372 channel-dispatch-operation.h \
355373 channel-factory-iface.h \
356374 channel-manager.h \
357 media-interfaces.h \
375 channel-request.h \
376 client.h \
358377 connection.h \
359378 connection-manager.h \
360379 contact.h \
383402 proxy.h \
384403 proxy-subclass.h \
385404 run.h \
405 svc-account.h \
406 svc-account-manager.h \
407 svc-channel-dispatcher.h \
408 svc-channel-dispatch-operation.h \
386409 svc-channel.h \
410 svc-channel-request.h \
411 svc-client.h \
387412 svc-connection.h \
388413 svc-connection-manager.h \
389414 svc-generic.h \
401426 _gen/interfaces-body.h \
402427 _gen/gtypes-body.h \
403428 _gen/register-dbus-glib-marshallers-body.h \
429 _gen/tp-cli-account-body.h \
430 _gen/tp-cli-account-manager-body.h \
404431 _gen/tp-cli-channel-body.h \
432 _gen/tp-cli-channel-dispatcher-body.h \
433 _gen/tp-cli-channel-dispatch-operation-body.h \
434 _gen/tp-cli-channel-request-body.h \
435 _gen/tp-cli-client-body.h \
405436 _gen/tp-cli-connection-body.h \
406437 _gen/tp-cli-connection-manager-body.h \
407438 _gen/tp-cli-dbus-daemon-body.h \
408439 _gen/tp-cli-generic-body.h \
409440 _gen/tp-cli-media-session-handler-body.h \
410441 _gen/tp-cli-media-stream-handler-body.h \
442 _gen/tp-svc-account.c \
443 _gen/tp-svc-account-manager.c \
411444 _gen/tp-svc-channel.c \
445 _gen/tp-svc-channel-dispatcher.c \
446 _gen/tp-svc-channel-dispatch-operation.c \
447 _gen/tp-svc-channel-request.c \
448 _gen/tp-svc-client.c \
412449 _gen/tp-svc-connection.c \
413450 _gen/tp-svc-connection-manager.c \
414451 _gen/tp-svc-generic.c \
420457 _gen/telepathy-enums.h \
421458 _gen/telepathy-interfaces.h \
422459 _gen/gtypes.h \
460 _gen/tp-cli-account.h \
461 _gen/tp-cli-account-manager.h \
423462 _gen/tp-cli-channel.h \
463 _gen/tp-cli-channel-dispatcher.h \
464 _gen/tp-cli-channel-dispatch-operation.h \
465 _gen/tp-cli-channel-request.h \
466 _gen/tp-cli-client.h \
424467 _gen/tp-cli-connection.h \
425468 _gen/tp-cli-connection-manager.h \
426469 _gen/tp-cli-dbus-daemon.h \
427470 _gen/tp-cli-generic.h \
428471 _gen/tp-cli-media-session-handler.h \
429472 _gen/tp-cli-media-stream-handler.h \
473 _gen/tp-svc-account.h \
474 _gen/tp-svc-account-manager.h \
430475 _gen/tp-svc-channel.h \
476 _gen/tp-svc-channel-dispatcher.h \
477 _gen/tp-svc-channel-dispatch-operation.h \
478 _gen/tp-svc-channel-request.h \
479 _gen/tp-svc-client.h \
431480 _gen/tp-svc-connection.h \
432481 _gen/tp-svc-connection-manager.h \
433482 _gen/tp-svc-generic.h \
450499
451500 libtelepathy_glib_internal_la_LIBADD = $(ALL_LIBS)
452501 libtelepathy_glib_internal_la_SOURCES = \
502 account.c \
503 account-manager.c \
453504 base-connection.c \
454505 base-connection-manager.c \
455506 channel.c \
456507 channel-group.c \
457508 channel-internal.h \
509 channel-dispatcher.c \
510 channel-dispatch-operation.c \
458511 channel-manager.c \
512 channel-request.c \
513 client.c \
459514 connection.c \
460515 connection-internal.h \
461516 connection-handles.c \
517572
518573 .SUFFIXES:
519574 .SUFFIXES: .c .lo .o .obj
520 $(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(top_srcdir)/tools/shave.mk $(top_srcdir)/tools/check-coding-style.mk $(am__configure_deps)
575 $(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(top_srcdir)/tools/shave.mk $(top_srcdir)/tools/flymake.mk $(top_srcdir)/tools/check-coding-style.mk $(am__configure_deps)
521576 @for dep in $?; do \
522577 case '$(am__configure_deps)' in \
523578 *$$dep*) \
597652 distclean-compile:
598653 -rm -f *.tab.c
599654
655 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/account-manager.Plo@am__quote@
656 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/account.Plo@am__quote@
600657 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/base-connection-manager.Plo@am__quote@
601658 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/base-connection.Plo@am__quote@
659 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-dispatch-operation.Plo@am__quote@
660 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-dispatcher.Plo@am__quote@
602661 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-factory-iface.Plo@am__quote@
603662 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-group.Plo@am__quote@
604663 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-iface.Plo@am__quote@
605664 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-manager.Plo@am__quote@
665 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-request.Plo@am__quote@
606666 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel.Plo@am__quote@
667 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/client.Plo@am__quote@
607668 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/connection-handles.Plo@am__quote@
608669 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/connection-manager.Plo@am__quote@
609670 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/connection.Plo@am__quote@
635696 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/run.Plo@am__quote@
636697 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/signals-marshal.Plo@am__quote@
637698 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/text-mixin.Plo@am__quote@
699 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-account-manager.Plo@am__quote@
700 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-account.Plo@am__quote@
701 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-channel-dispatch-operation.Plo@am__quote@
702 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-channel-dispatcher.Plo@am__quote@
703 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-channel-request.Plo@am__quote@
638704 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-channel.Plo@am__quote@
705 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-client.Plo@am__quote@
639706 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-connection-manager.Plo@am__quote@
640707 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-connection.Plo@am__quote@
641708 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/tp-svc-generic.Plo@am__quote@
678745 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
679746 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o signals-marshal.lo `test -f '_gen/signals-marshal.c' || echo '$(srcdir)/'`_gen/signals-marshal.c
680747
748 tp-svc-account.lo: _gen/tp-svc-account.c
749 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-account.lo -MD -MP -MF "$(DEPDIR)/tp-svc-account.Tpo" -c -o tp-svc-account.lo `test -f '_gen/tp-svc-account.c' || echo '$(srcdir)/'`_gen/tp-svc-account.c; \
750 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-account.Tpo" "$(DEPDIR)/tp-svc-account.Plo"; else rm -f "$(DEPDIR)/tp-svc-account.Tpo"; exit 1; fi
751 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-account.c' object='tp-svc-account.lo' libtool=yes @AMDEPBACKSLASH@
752 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
753 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-account.lo `test -f '_gen/tp-svc-account.c' || echo '$(srcdir)/'`_gen/tp-svc-account.c
754
755 tp-svc-account-manager.lo: _gen/tp-svc-account-manager.c
756 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-account-manager.lo -MD -MP -MF "$(DEPDIR)/tp-svc-account-manager.Tpo" -c -o tp-svc-account-manager.lo `test -f '_gen/tp-svc-account-manager.c' || echo '$(srcdir)/'`_gen/tp-svc-account-manager.c; \
757 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-account-manager.Tpo" "$(DEPDIR)/tp-svc-account-manager.Plo"; else rm -f "$(DEPDIR)/tp-svc-account-manager.Tpo"; exit 1; fi
758 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-account-manager.c' object='tp-svc-account-manager.lo' libtool=yes @AMDEPBACKSLASH@
759 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
760 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-account-manager.lo `test -f '_gen/tp-svc-account-manager.c' || echo '$(srcdir)/'`_gen/tp-svc-account-manager.c
761
681762 tp-svc-channel.lo: _gen/tp-svc-channel.c
682763 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-channel.lo -MD -MP -MF "$(DEPDIR)/tp-svc-channel.Tpo" -c -o tp-svc-channel.lo `test -f '_gen/tp-svc-channel.c' || echo '$(srcdir)/'`_gen/tp-svc-channel.c; \
683764 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-channel.Tpo" "$(DEPDIR)/tp-svc-channel.Plo"; else rm -f "$(DEPDIR)/tp-svc-channel.Tpo"; exit 1; fi
684765 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-channel.c' object='tp-svc-channel.lo' libtool=yes @AMDEPBACKSLASH@
685766 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
686767 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-channel.lo `test -f '_gen/tp-svc-channel.c' || echo '$(srcdir)/'`_gen/tp-svc-channel.c
768
769 tp-svc-channel-dispatcher.lo: _gen/tp-svc-channel-dispatcher.c
770 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-channel-dispatcher.lo -MD -MP -MF "$(DEPDIR)/tp-svc-channel-dispatcher.Tpo" -c -o tp-svc-channel-dispatcher.lo `test -f '_gen/tp-svc-channel-dispatcher.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-dispatcher.c; \
771 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-channel-dispatcher.Tpo" "$(DEPDIR)/tp-svc-channel-dispatcher.Plo"; else rm -f "$(DEPDIR)/tp-svc-channel-dispatcher.Tpo"; exit 1; fi
772 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-channel-dispatcher.c' object='tp-svc-channel-dispatcher.lo' libtool=yes @AMDEPBACKSLASH@
773 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
774 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-channel-dispatcher.lo `test -f '_gen/tp-svc-channel-dispatcher.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-dispatcher.c
775
776 tp-svc-channel-dispatch-operation.lo: _gen/tp-svc-channel-dispatch-operation.c
777 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-channel-dispatch-operation.lo -MD -MP -MF "$(DEPDIR)/tp-svc-channel-dispatch-operation.Tpo" -c -o tp-svc-channel-dispatch-operation.lo `test -f '_gen/tp-svc-channel-dispatch-operation.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-dispatch-operation.c; \
778 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-channel-dispatch-operation.Tpo" "$(DEPDIR)/tp-svc-channel-dispatch-operation.Plo"; else rm -f "$(DEPDIR)/tp-svc-channel-dispatch-operation.Tpo"; exit 1; fi
779 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-channel-dispatch-operation.c' object='tp-svc-channel-dispatch-operation.lo' libtool=yes @AMDEPBACKSLASH@
780 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
781 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-channel-dispatch-operation.lo `test -f '_gen/tp-svc-channel-dispatch-operation.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-dispatch-operation.c
782
783 tp-svc-channel-request.lo: _gen/tp-svc-channel-request.c
784 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-channel-request.lo -MD -MP -MF "$(DEPDIR)/tp-svc-channel-request.Tpo" -c -o tp-svc-channel-request.lo `test -f '_gen/tp-svc-channel-request.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-request.c; \
785 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-channel-request.Tpo" "$(DEPDIR)/tp-svc-channel-request.Plo"; else rm -f "$(DEPDIR)/tp-svc-channel-request.Tpo"; exit 1; fi
786 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-channel-request.c' object='tp-svc-channel-request.lo' libtool=yes @AMDEPBACKSLASH@
787 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
788 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-channel-request.lo `test -f '_gen/tp-svc-channel-request.c' || echo '$(srcdir)/'`_gen/tp-svc-channel-request.c
789
790 tp-svc-client.lo: _gen/tp-svc-client.c
791 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-client.lo -MD -MP -MF "$(DEPDIR)/tp-svc-client.Tpo" -c -o tp-svc-client.lo `test -f '_gen/tp-svc-client.c' || echo '$(srcdir)/'`_gen/tp-svc-client.c; \
792 @am__fastdepCC_TRUE@ then mv -f "$(DEPDIR)/tp-svc-client.Tpo" "$(DEPDIR)/tp-svc-client.Plo"; else rm -f "$(DEPDIR)/tp-svc-client.Tpo"; exit 1; fi
793 @AMDEP_TRUE@@am__fastdepCC_FALSE@ source='_gen/tp-svc-client.c' object='tp-svc-client.lo' libtool=yes @AMDEPBACKSLASH@
794 @AMDEP_TRUE@@am__fastdepCC_FALSE@ DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
795 @am__fastdepCC_FALSE@ $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -c -o tp-svc-client.lo `test -f '_gen/tp-svc-client.c' || echo '$(srcdir)/'`_gen/tp-svc-client.c
687796
688797 tp-svc-connection.lo: _gen/tp-svc-connection.c
689798 @am__fastdepCC_TRUE@ if $(LIBTOOL) --tag=CC --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT tp-svc-connection.lo -MD -MP -MF "$(DEPDIR)/tp-svc-connection.Tpo" -c -o tp-svc-connection.lo `test -f '_gen/tp-svc-connection.c' || echo '$(srcdir)/'`_gen/tp-svc-connection.c; \
9641073 uninstall-libLTLIBRARIES uninstall-nodist_genincludeHEADERS \
9651074 uninstall-pkgconfigDATA uninstall-tpgincludeHEADERS
9661075
1076 check-syntax:
1077 $(CC) $(AM_CPPFLAGS) $(AM_CFLAGS) -fsyntax-only $(CHK_SOURCES)
1078
1079 .PHONY: check-syntax
9671080
9681081 @HAVE_LD_VERSION_SCRIPT_TRUE@_gen/version-script.txt: $(ABI_LISTS) _gen/abi.txt Makefile.am \
9691082 @HAVE_LD_VERSION_SCRIPT_TRUE@ $(top_srcdir)/tools/make-version-script.py
10871200 subclass= ; \
10881201 subclass_assert= ; \
10891202 case $* in \
1203 generic) \
1204 maybe_reentrant=--generate-reentrant; \
1205 ;; \
1206 account-manager) \
1207 subclass=--subclass=TpAccountManager; \
1208 subclass_assert=--subclass-assert=TP_IS_ACCOUNT_MANAGER; \
1209 ;; \
1210 account) \
1211 subclass=--subclass=TpAccount; \
1212 subclass_assert=--subclass-assert=TP_IS_ACCOUNT; \
1213 ;; \
10901214 channel) \
10911215 subclass=--subclass=TpChannel; \
10921216 subclass_assert=--subclass-assert=TP_IS_CHANNEL; \
1217 maybe_reentrant=--generate-reentrant; \
1218 ;; \
1219 channel-dispatcher) \
1220 subclass=--subclass=TpChannelDispatcher; \
1221 subclass_assert=--subclass-assert=TP_IS_CHANNEL_DISPATCHER; \
1222 ;; \
1223 channel-dispatch-operation) \
1224 subclass=--subclass=TpChannelDispatchOperation; \
1225 subclass_assert=--subclass-assert=TP_IS_CHANNEL_DISPATCH_OPERATION; \
1226 ;; \
1227 channel-request) \
1228 subclass=--subclass=TpChannelRequest; \
1229 subclass_assert=--subclass-assert=TP_IS_CHANNEL_REQUEST; \
1230 ;; \
1231 client) \
1232 subclass=--subclass=TpClient; \
1233 subclass_assert=--subclass-assert=TP_IS_CLIENT; \
10931234 ;; \
10941235 connection-manager) \
10951236 subclass=--subclass=TpConnectionManager; \
10961237 subclass_assert=--subclass-assert=TP_IS_CONNECTION_MANAGER \
1238 maybe_reentrant=--generate-reentrant; \
10971239 ;; \
10981240 connection) \
10991241 subclass=--subclass=TpConnection; \
11001242 subclass_assert=--subclass-assert=TP_IS_CONNECTION; \
1243 maybe_reentrant=--generate-reentrant; \
11011244 ;; \
11021245 media-session-handler) \
11031246 subclass=--subclass=TpMediaSessionHandler; \
11041247 subclass_assert=--subclass-assert=TP_IS_MEDIA_SESSION_HANDLER; \
1248 maybe_reentrant=--generate-reentrant; \
11051249 ;; \
11061250 media-stream-handler) \
11071251 subclass=--subclass=TpMediaStreamHandler; \
11081252 subclass_assert=--subclass-assert=TP_IS_MEDIA_STREAM_HANDLER; \
1253 maybe_reentrant=--generate-reentrant; \
11091254 ;; \
11101255 dbus-daemon) \
11111256 subclass=--subclass=TpDBusDaemon; \
11121257 subclass_assert=--subclass-assert=TP_IS_DBUS_DAEMON; \
1258 maybe_reentrant=--generate-reentrant; \
11131259 ;; \
11141260 esac; \
11151261 $(PYTHON) $(tools_dir)/glib-client-gen.py \
11171263 --group `echo $* | tr - _` \
11181264 --iface-quark-prefix=TP_IFACE_QUARK \
11191265 --tp-proxy-api=0.7.6 \
1266 $$maybe_reentrant \
11201267 $< Tp_Cli _gen/tp-cli-$*
11211268 # Tell versions [3.59,3.63) of GNU make to not export all variables.
11221269 # Otherwise a system limit (for SysV at least) may be exceeded.
0 /*
1 * account-manager.c - proxy for the Telepathy account manager
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/account-manager.h"
22
23 #include <telepathy-glib/dbus.h>
24 #include <telepathy-glib/defs.h>
25 #include <telepathy-glib/errors.h>
26 #include <telepathy-glib/interfaces.h>
27 #include <telepathy-glib/proxy-subclass.h>
28
29 #define DEBUG_FLAG TP_DEBUG_ACCOUNTS
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-account-manager-body.h"
33
34 /**
35 * SECTION:account-manager
36 * @title: TpAccountManager
37 * @short_description: proxy object for the Telepathy account manager
38 * @see_also: #TpAccount
39 *
40 * The #TpAccountManager object is used to communicate with the Telepathy
41 * AccountManager service.
42 *
43 * Since: 0.7.32
44 */
45
46 /**
47 * TpAccountManager:
48 *
49 * The Telepathy Account Manager stores real-time communication accounts and
50 * their configuration, places accounts online on request, and manipulates
51 * accounts' presence, nicknames and avatars.
52 *
53 * This proxy is usable but incomplete: GObject signals and accessors for the
54 * D-Bus properties will be added in a later version of telepathy-glib, along
55 * with a mechanism similar to tp_connection_call_when_ready().
56 *
57 * Until suitable convenience methods are implemented, the generic
58 * tp_cli_dbus_properties_call_get_all() method can be used to get the D-Bus
59 * properties.
60 *
61 * Since: 0.7.32
62 */
63
64 /**
65 * TpAccountManagerClass:
66 *
67 * The class of a #TpAccount.
68 */
69
70 struct _TpAccountManagerPrivate {
71 gpointer dummy;
72 };
73
74 G_DEFINE_TYPE (TpAccountManager, tp_account_manager, TP_TYPE_PROXY);
75
76 static void
77 tp_account_manager_init (TpAccountManager *self)
78 {
79 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_ACCOUNT_MANAGER,
80 TpAccountManagerPrivate);
81 }
82
83 static void
84 tp_account_manager_constructed (GObject *object)
85 {
86 TpAccountManager *self = TP_ACCOUNT_MANAGER (object);
87 void (*chain_up) (GObject *) =
88 ((GObjectClass *) tp_account_manager_parent_class)->constructed;
89
90 if (chain_up != NULL)
91 chain_up (object);
92
93 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
94 }
95
96 static void
97 tp_account_manager_class_init (TpAccountManagerClass *klass)
98 {
99 TpProxyClass *proxy_class = (TpProxyClass *) klass;
100 GObjectClass *object_class = (GObjectClass *) klass;
101
102 g_type_class_add_private (klass, sizeof (TpAccountManagerPrivate));
103
104 object_class->constructed = tp_account_manager_constructed;
105
106 proxy_class->interface = TP_IFACE_QUARK_ACCOUNT_MANAGER;
107 tp_account_manager_init_known_interfaces ();
108 }
109
110 /**
111 * tp_account_manager_init_known_interfaces:
112 *
113 * Ensure that the known interfaces for TpAccountManager have been set up.
114 * This is done automatically when necessary, but for correct
115 * overriding of library interfaces by local extensions, you should
116 * call this function before calling
117 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
118 * %TP_TYPE_ACCOUNT_MANAGER.
119 *
120 * Since: 0.7.32
121 */
122 void
123 tp_account_manager_init_known_interfaces (void)
124 {
125 static gsize once = 0;
126
127 if (g_once_init_enter (&once))
128 {
129 GType tp_type = TP_TYPE_ACCOUNT_MANAGER;
130
131 tp_proxy_init_known_interfaces ();
132 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
133 tp_cli_account_manager_add_signals);
134 tp_proxy_subclass_add_error_mapping (tp_type,
135 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
136
137 g_once_init_leave (&once, 1);
138 }
139 }
140
141 /**
142 * tp_account_manager_new:
143 * @bus_daemon: Proxy for the D-Bus daemon
144 *
145 * Convenience function to create a new account manager proxy.
146 *
147 * Returns: a new reference to an account manager proxy
148 */
149 TpAccountManager *
150 tp_account_manager_new (TpDBusDaemon *bus_daemon)
151 {
152 TpAccountManager *self;
153
154 g_return_val_if_fail (bus_daemon != NULL, NULL);
155
156 self = TP_ACCOUNT_MANAGER (g_object_new (TP_TYPE_ACCOUNT_MANAGER,
157 "dbus-daemon", bus_daemon,
158 "dbus-connection", ((TpProxy *) bus_daemon)->dbus_connection,
159 "bus-name", TP_ACCOUNT_MANAGER_BUS_NAME,
160 "object-path", TP_ACCOUNT_MANAGER_OBJECT_PATH,
161 NULL));
162
163 return self;
164 }
0 /*
1 * account-manager.h - proxy for the Telepathy account manager
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_ACCOUNT_MANAGER_H
22 #define TP_ACCOUNT_MANAGER_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29 typedef struct _TpAccountManager TpAccountManager;
30 typedef struct _TpAccountManagerClass TpAccountManagerClass;
31 typedef struct _TpAccountManagerPrivate TpAccountManagerPrivate;
32 typedef struct _TpAccountManagerClassPrivate TpAccountManagerClassPrivate;
33
34 struct _TpAccountManager {
35 /*<private>*/
36 TpProxy parent;
37 TpAccountManagerPrivate *priv;
38 };
39
40 struct _TpAccountManagerClass {
41 /*<private>*/
42 TpProxyClass parent_class;
43 GCallback _padding[7];
44 TpAccountManagerClassPrivate *priv;
45 };
46
47 GType tp_account_manager_get_type (void);
48
49 #define TP_TYPE_ACCOUNT_MANAGER \
50 (tp_account_manager_get_type ())
51 #define TP_ACCOUNT_MANAGER(obj) \
52 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_ACCOUNT_MANAGER, \
53 TpAccountManager))
54 #define TP_ACCOUNT_MANAGER_CLASS(klass) \
55 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_ACCOUNT_MANAGER, \
56 TpAccountManagerClass))
57 #define TP_IS_ACCOUNT_MANAGER(obj) \
58 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_ACCOUNT_MANAGER))
59 #define TP_IS_ACCOUNT_MANAGER_CLASS(klass) \
60 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_ACCOUNT_MANAGER))
61 #define TP_ACCOUNT_MANAGER_GET_CLASS(obj) \
62 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_ACCOUNT_MANAGER, \
63 TpAccountManagerClass))
64
65 TpAccountManager *tp_account_manager_new (TpDBusDaemon *bus_daemon);
66
67 void tp_account_manager_init_known_interfaces (void);
68
69 G_END_DECLS
70
71 #include <telepathy-glib/_gen/tp-cli-account-manager.h>
72
73 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>Account Manager interfaces</tp:title>
5
6 <xi:include href="../spec/Account_Manager.xml"/>
7
8 </tp:spec>
0 /*
1 * account.c - proxy for an account in the Telepathy account manager
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/account.h"
22
23 #include <telepathy-glib/dbus.h>
24 #include <telepathy-glib/defs.h>
25 #include <telepathy-glib/errors.h>
26 #include <telepathy-glib/interfaces.h>
27 #include <telepathy-glib/proxy-subclass.h>
28
29 #define DEBUG_FLAG TP_DEBUG_ACCOUNTS
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-account-body.h"
33
34 /**
35 * SECTION:account
36 * @title: TpAccount
37 * @short_description: proxy object for an account in the Telepathy account
38 * manager
39 * @see_also: #TpAccountManager
40 *
41 * The Telepathy Account Manager stores the user's configured real-time
42 * communication accounts. The #TpAccount object represents a stored account.
43 *
44 * Since: 0.7.32
45 */
46
47 /**
48 * TpAccount:
49 *
50 * The Telepathy Account Manager stores the user's configured real-time
51 * communication accounts. This object represents a stored account.
52 *
53 * If this account is deleted from the account manager, the
54 * #TpProxy::invalidated signal will be emitted
55 * with the domain %TP_DBUS_ERRORS and the error code
56 * %TP_DBUS_ERROR_OBJECT_REMOVED.
57 *
58 * This proxy is usable but very incomplete: accessors for the
59 * Account's D-Bus properties will be added in a later version of
60 * telepathy-glib, along with a mechanism similar to
61 * tp_connection_call_when_ready().
62 *
63 * Most operations performed on an Account are done via D-Bus properties.
64 * Until convenience methods for this are implemented, use of the generic
65 * tp_cli_dbus_properties_call_get_all() and tp_cli_dbus_properties_call_set()
66 * methods is recommended.
67 *
68 * Other useful auto-generated method wrappers on an Account include
69 * tp_cli_account_call_remove(), tp_cli_account_call_update_parameters() and
70 * tp_cli_account_call_reconnect().
71 *
72 * Since: 0.7.32
73 */
74
75 /**
76 * TpAccountClass:
77 *
78 * The class of a #TpAccount.
79 */
80
81 struct _TpAccountPrivate {
82 gpointer dummy;
83 };
84
85 G_DEFINE_TYPE (TpAccount, tp_account, TP_TYPE_PROXY);
86
87 static void
88 tp_account_init (TpAccount *self)
89 {
90 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_ACCOUNT,
91 TpAccountPrivate);
92 }
93
94 static void
95 tp_account_removed_cb (TpAccount *self,
96 gpointer unused G_GNUC_UNUSED,
97 GObject *object G_GNUC_UNUSED)
98 {
99 GError e = { TP_DBUS_ERRORS, TP_DBUS_ERROR_OBJECT_REMOVED,
100 "Account removed" };
101
102 tp_proxy_invalidate ((TpProxy *) self, &e);
103 }
104
105 static void
106 tp_account_constructed (GObject *object)
107 {
108 TpAccount *self = TP_ACCOUNT (object);
109 void (*chain_up) (GObject *) =
110 ((GObjectClass *) tp_account_parent_class)->constructed;
111 GError *error = NULL;
112 TpProxySignalConnection *sc;
113
114 if (chain_up != NULL)
115 chain_up (object);
116
117 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
118
119 sc = tp_cli_account_connect_to_removed (self, tp_account_removed_cb,
120 NULL, NULL, NULL, &error);
121
122 if (sc == NULL)
123 {
124 g_critical ("Couldn't connect to Removed: %s", error->message);
125 g_error_free (error);
126 g_assert_not_reached ();
127 return;
128 }
129 }
130
131 static void
132 tp_account_class_init (TpAccountClass *klass)
133 {
134 TpProxyClass *proxy_class = (TpProxyClass *) klass;
135 GObjectClass *object_class = (GObjectClass *) klass;
136
137 g_type_class_add_private (klass, sizeof (TpAccountPrivate));
138
139 object_class->constructed = tp_account_constructed;
140
141 proxy_class->interface = TP_IFACE_QUARK_ACCOUNT;
142 tp_account_init_known_interfaces ();
143 }
144
145 /**
146 * tp_account_init_known_interfaces:
147 *
148 * Ensure that the known interfaces for TpAccount have been set up.
149 * This is done automatically when necessary, but for correct
150 * overriding of library interfaces by local extensions, you should
151 * call this function before calling
152 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
153 * %TP_TYPE_ACCOUNT.
154 *
155 * Since: 0.7.32
156 */
157 void
158 tp_account_init_known_interfaces (void)
159 {
160 static gsize once = 0;
161
162 if (g_once_init_enter (&once))
163 {
164 GType tp_type = TP_TYPE_ACCOUNT;
165
166 tp_proxy_init_known_interfaces ();
167 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
168 tp_cli_account_add_signals);
169 tp_proxy_subclass_add_error_mapping (tp_type,
170 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
171
172 g_once_init_leave (&once, 1);
173 }
174 }
175
176 /**
177 * tp_account_new:
178 * @bus_daemon: Proxy for the D-Bus daemon
179 * @object_path: The non-NULL object path of this account
180 * @error: Used to raise an error if @object_path is not valid
181 *
182 * Convenience function to create a new account proxy.
183 *
184 * Returns: a new reference to an account proxy, or %NULL if @object_path is
185 * not valid
186 */
187 TpAccount *
188 tp_account_new (TpDBusDaemon *bus_daemon,
189 const gchar *object_path,
190 GError **error)
191 {
192 TpAccount *self;
193
194 g_return_val_if_fail (bus_daemon != NULL, NULL);
195 g_return_val_if_fail (object_path != NULL, NULL);
196 g_return_val_if_fail (error == NULL || *error == NULL, NULL);
197
198 if (!tp_dbus_check_valid_object_path (object_path, error))
199 return NULL;
200
201 if (!g_str_has_prefix (object_path, TP_ACCOUNT_OBJECT_PATH_BASE))
202 {
203 g_set_error (error, TP_ERRORS, TP_ERROR_INVALID_ARGUMENT,
204 "Account path does not start with the right prefix: %s",
205 object_path);
206 return NULL;
207 }
208
209 self = TP_ACCOUNT (g_object_new (TP_TYPE_ACCOUNT,
210 "dbus-daemon", bus_daemon,
211 "dbus-connection", ((TpProxy *) bus_daemon)->dbus_connection,
212 "bus-name", TP_ACCOUNT_MANAGER_BUS_NAME,
213 "object-path", object_path,
214 NULL));
215
216 return self;
217 }
0 /*
1 * account-manager.h - proxy for an account in the Telepathy account manager
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_ACCOUNT_H
22 #define TP_ACCOUNT_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29 typedef struct _TpAccount TpAccount;
30 typedef struct _TpAccountClass TpAccountClass;
31 typedef struct _TpAccountPrivate TpAccountPrivate;
32 typedef struct _TpAccountClassPrivate TpAccountClassPrivate;
33
34 struct _TpAccount {
35 /*<private>*/
36 TpProxy parent;
37 TpAccountPrivate *priv;
38 };
39
40 struct _TpAccountClass {
41 /*<private>*/
42 TpProxyClass parent_class;
43 GCallback _padding[7];
44 TpAccountClassPrivate *priv;
45 };
46
47 GType tp_account_get_type (void);
48
49 #define TP_TYPE_ACCOUNT \
50 (tp_account_get_type ())
51 #define TP_ACCOUNT(obj) \
52 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_ACCOUNT, \
53 TpAccount))
54 #define TP_ACCOUNT_CLASS(klass) \
55 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_ACCOUNT, \
56 TpAccountClass))
57 #define TP_IS_ACCOUNT(obj) \
58 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_ACCOUNT))
59 #define TP_IS_ACCOUNT_CLASS(klass) \
60 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_ACCOUNT))
61 #define TP_ACCOUNT_GET_CLASS(obj) \
62 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_ACCOUNT, \
63 TpAccountClass))
64
65 TpAccount *tp_account_new (TpDBusDaemon *bus_daemon, const gchar *object_path,
66 GError **error);
67
68 void tp_account_init_known_interfaces (void);
69
70 G_END_DECLS
71
72 #include <telepathy-glib/_gen/tp-cli-account.h>
73
74 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>Account interfaces</tp:title>
5
6 <xi:include href="../spec/Account.xml"/>
7
8 <xi:include href="../spec/Account_Interface_Avatar.xml"/>
9
10 </tp:spec>
0 /*
1 * channel-dispatch-operation.c - proxy for incoming channels seeking approval
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/channel-dispatch-operation.h"
22
23 #include <telepathy-glib/defs.h>
24 #include <telepathy-glib/errors.h>
25 #include <telepathy-glib/interfaces.h>
26 #include <telepathy-glib/proxy-subclass.h>
27
28 #define DEBUG_FLAG TP_DEBUG_DISPATCHER
29 #include "telepathy-glib/dbus-internal.h"
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-channel-dispatch-operation-body.h"
33
34 /**
35 * SECTION:channel-dispatch-operation
36 * @title: TpChannelDispatchOperation
37 * @short_description: proxy object for a to the Telepathy channel
38 * dispatcher
39 * @see_also: #TpChannelDispatcher
40 *
41 * One of the channel dispatcher's functions is to offer incoming channels to
42 * Approver clients for approval. Approvers respond to the channel dispatcher
43 * via a #TpChannelDispatchOperation object.
44 */
45
46 /**
47 * TpChannelDispatchOperation:
48 *
49 * One of the channel dispatcher's functions is to offer incoming channels to
50 * Approver clients for approval. An approver should generally ask the user
51 * whether they want to participate in the requested communication channels
52 * (join the chat or chatroom, answer the call, accept the file transfer, or
53 * whatever is appropriate). A collection of channels offered in this way
54 * is represented by a ChannelDispatchOperation object.
55 *
56 * If the user wishes to accept the communication channels, the approver
57 * should call tp_cli_channel_dispatch_operation_call_handle_with() to
58 * indicate the user's or approver's preferred handler for the channels (the
59 * empty string indicates no particular preference, and will cause any
60 * suitable handler to be used).
61 *
62 * If the user wishes to reject the communication channels, or if the user
63 * accepts the channels and the approver will handle them itself, the approver
64 * should call tp_cli_channel_dispatch_operation_call_claim(). If this method
65 * succeeds, the approver immediately has control over the channels as their
66 * primary handler, and may do anything with them (in particular, it may close
67 * them in whatever way seems most appropriate).
68 *
69 * There are various situations in which the channel dispatch operation will
70 * be closed, causing the #TpProxy::invalidated signal to be emitted. If this
71 * happens, the approver should stop prompting the user.
72 *
73 * Because all approvers are launched simultaneously, the user might respond
74 * to another approver; if this happens, the invalidated signal will be
75 * emitted with the domain %TP_DBUS_ERRORS and the error code
76 * %TP_DBUS_ERROR_OBJECT_REMOVED.
77 *
78 * If a channel closes, the D-Bus signal ChannelLost is emitted; this class
79 * doesn't (yet) have a GObject binding for this signal, but you can use
80 * tp_cli_channel_dispatch_operation_connect_to_channel_lost(). If all channels
81 * close, there is nothing more to dispatch, so the invalidated signal will be
82 * emitted with the domain %TP_DBUS_ERRORS and the error code
83 * %TP_DBUS_ERROR_OBJECT_REMOVED.
84 *
85 * If the channel dispatcher crashes or exits, the invalidated
86 * signal will be emitted with the domain %TP_DBUS_ERRORS and the error code
87 * %TP_DBUS_ERROR_NAME_OWNER_LOST. In a high-quality implementation, the
88 * dispatcher should be restarted, at which point it will create new
89 * channel dispatch operations for any undispatched channels, and the approver
90 * will be notified again.
91 *
92 * This proxy is usable but incomplete: accessors for the D-Bus properties will
93 * be added in a later version of telepathy-glib, along with a mechanism
94 * similar to tp_connection_call_when_ready().
95 *
96 * Since: 0.7.32
97 */
98
99 /**
100 * TpChannelDispatchOperationClass:
101 *
102 * The class of a #TpChannelDispatchOperation.
103 */
104
105 struct _TpChannelDispatchOperationPrivate {
106 gpointer dummy;
107 };
108
109 G_DEFINE_TYPE (TpChannelDispatchOperation, tp_channel_dispatch_operation,
110 TP_TYPE_PROXY);
111
112 static void
113 tp_channel_dispatch_operation_init (TpChannelDispatchOperation *self)
114 {
115 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
116 TP_TYPE_CHANNEL_DISPATCH_OPERATION, TpChannelDispatchOperationPrivate);
117 }
118
119 static void
120 tp_channel_dispatch_operation_finished_cb (TpChannelDispatchOperation *self,
121 gpointer unused G_GNUC_UNUSED,
122 GObject *object G_GNUC_UNUSED)
123 {
124 GError e = { TP_DBUS_ERRORS, TP_DBUS_ERROR_OBJECT_REMOVED,
125 "ChannelDispatchOperation finished and was removed" };
126
127 tp_proxy_invalidate ((TpProxy *) self, &e);
128 }
129
130 static void
131 tp_channel_dispatch_operation_constructed (GObject *object)
132 {
133 TpChannelDispatchOperation *self = TP_CHANNEL_DISPATCH_OPERATION (object);
134 void (*chain_up) (GObject *) =
135 ((GObjectClass *) tp_channel_dispatch_operation_parent_class)->constructed;
136 GError *error = NULL;
137 TpProxySignalConnection *sc;
138
139 if (chain_up != NULL)
140 chain_up (object);
141
142 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
143
144 sc = tp_cli_channel_dispatch_operation_connect_to_finished (self,
145 tp_channel_dispatch_operation_finished_cb, NULL, NULL, NULL, &error);
146
147 if (sc == NULL)
148 {
149 g_critical ("Couldn't connect to Finished: %s", error->message);
150 g_error_free (error);
151 g_assert_not_reached ();
152 return;
153 }
154 }
155
156 static void
157 tp_channel_dispatch_operation_class_init (TpChannelDispatchOperationClass *klass)
158 {
159 TpProxyClass *proxy_class = (TpProxyClass *) klass;
160 GObjectClass *object_class = (GObjectClass *) klass;
161
162 g_type_class_add_private (klass, sizeof (TpChannelDispatchOperationPrivate));
163
164 object_class->constructed = tp_channel_dispatch_operation_constructed;
165
166 proxy_class->interface = TP_IFACE_QUARK_CHANNEL_DISPATCH_OPERATION;
167 proxy_class->must_have_unique_name = TRUE;
168
169 tp_channel_dispatch_operation_init_known_interfaces ();
170 }
171
172 /**
173 * tp_channel_dispatch_operation_init_known_interfaces:
174 *
175 * Ensure that the known interfaces for TpChannelDispatchOperation have been
176 * set up. This is done automatically when necessary, but for correct
177 * overriding of library interfaces by local extensions, you should
178 * call this function before calling
179 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
180 * %TP_TYPE_CHANNEL_DISPATCH_OPERATION.
181 *
182 * Since: 0.7.32
183 */
184 void
185 tp_channel_dispatch_operation_init_known_interfaces (void)
186 {
187 static gsize once = 0;
188
189 if (g_once_init_enter (&once))
190 {
191 GType tp_type = TP_TYPE_CHANNEL_DISPATCH_OPERATION;
192
193 tp_proxy_init_known_interfaces ();
194 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
195 tp_cli_channel_dispatch_operation_add_signals);
196 tp_proxy_subclass_add_error_mapping (tp_type,
197 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
198
199 g_once_init_leave (&once, 1);
200 }
201 }
202
203 /**
204 * tp_channel_dispatch_operation_new:
205 * @bus_daemon: Proxy for the D-Bus daemon
206 * @object_path: The non-NULL object path of this channel dispatch operation
207 * @immutable_properties: As many as are known of the immutable D-Bus
208 * properties of this channel dispatch operation, or %NULL if none are known
209 * @error: Used to raise an error if %NULL is returned
210 *
211 * Convenience function to create a new channel dispatch operation proxy.
212 *
213 * The @immutable_properties argument is not yet used.
214 *
215 * Returns: a new reference to an channel dispatch operation proxy, or %NULL if
216 * @object_path is not syntactically valid or the channel dispatcher is not
217 * running
218 */
219 TpChannelDispatchOperation *
220 tp_channel_dispatch_operation_new (TpDBusDaemon *bus_daemon,
221 const gchar *object_path,
222 GHashTable *immutable_properties G_GNUC_UNUSED,
223 GError **error)
224 {
225 TpChannelDispatchOperation *self;
226 gchar *unique_name;
227
228 g_return_val_if_fail (bus_daemon != NULL, NULL);
229 g_return_val_if_fail (object_path != NULL, NULL);
230 g_return_val_if_fail (error == NULL || *error == NULL, NULL);
231
232 if (!tp_dbus_check_valid_object_path (object_path, error))
233 return NULL;
234
235 if (!_tp_dbus_daemon_get_name_owner (bus_daemon, -1,
236 TP_CHANNEL_DISPATCHER_BUS_NAME, &unique_name, error))
237 return NULL;
238
239 self = TP_CHANNEL_DISPATCH_OPERATION (g_object_new (
240 TP_TYPE_CHANNEL_DISPATCH_OPERATION,
241 "dbus-daemon", bus_daemon,
242 "dbus-connection", ((TpProxy *) bus_daemon)->dbus_connection,
243 "bus-name", unique_name,
244 "object-path", object_path,
245 NULL));
246
247 g_free (unique_name);
248
249 return self;
250 }
0 /*
1 * channel-dispatch-operation.h - proxy for channels awaiting approval
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_CHANNEL_DISPATCH_OPERATION_H
22 #define TP_CHANNEL_DISPATCH_OPERATION_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29 typedef struct _TpChannelDispatchOperation
30 TpChannelDispatchOperation;
31 typedef struct _TpChannelDispatchOperationClass
32 TpChannelDispatchOperationClass;
33 typedef struct _TpChannelDispatchOperationPrivate
34 TpChannelDispatchOperationPrivate;
35 typedef struct _TpChannelDispatchOperationClassPrivate
36 TpChannelDispatchOperationClassPrivate;
37
38 struct _TpChannelDispatchOperation {
39 /*<private>*/
40 TpProxy parent;
41 TpChannelDispatchOperationPrivate *priv;
42 };
43
44 struct _TpChannelDispatchOperationClass {
45 /*<private>*/
46 TpProxyClass parent_class;
47 GCallback _padding[7];
48 TpChannelDispatchOperationClassPrivate *priv;
49 };
50
51 GType tp_channel_dispatch_operation_get_type (void);
52
53 #define TP_TYPE_CHANNEL_DISPATCH_OPERATION \
54 (tp_channel_dispatch_operation_get_type ())
55 #define TP_CHANNEL_DISPATCH_OPERATION(obj) \
56 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_CHANNEL_DISPATCH_OPERATION, \
57 TpChannelDispatchOperation))
58 #define TP_CHANNEL_DISPATCH_OPERATION_CLASS(klass) \
59 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_CHANNEL_DISPATCH_OPERATION, \
60 TpChannelDispatchOperationClass))
61 #define TP_IS_CHANNEL_DISPATCH_OPERATION(obj) \
62 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_CHANNEL_DISPATCH_OPERATION))
63 #define TP_IS_CHANNEL_DISPATCH_OPERATION_CLASS(klass) \
64 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_CHANNEL_DISPATCH_OPERATION))
65 #define TP_CHANNEL_DISPATCH_OPERATION_GET_CLASS(obj) \
66 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_CHANNEL_DISPATCH_OPERATION, \
67 TpChannelDispatchOperationClass))
68
69 TpChannelDispatchOperation *tp_channel_dispatch_operation_new (
70 TpDBusDaemon *bus_daemon, const gchar *object_path,
71 GHashTable *immutable_properties, GError **error);
72
73 void tp_channel_dispatch_operation_init_known_interfaces (void);
74
75 G_END_DECLS
76
77 #include <telepathy-glib/_gen/tp-cli-channel-dispatch-operation.h>
78
79 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>CDO interfaces</tp:title>
5
6 <xi:include href="../spec/Channel_Dispatch_Operation.xml"/>
7
8 </tp:spec>
0 /*
1 * channel-dispatcher.c - proxy for the Telepathy channel dispatcher
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/channel-dispatcher.h"
22
23 #include <telepathy-glib/dbus.h>
24 #include <telepathy-glib/defs.h>
25 #include <telepathy-glib/errors.h>
26 #include <telepathy-glib/interfaces.h>
27 #include <telepathy-glib/proxy-subclass.h>
28
29 #define DEBUG_FLAG TP_DEBUG_DISPATCHER
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-channel-dispatcher-body.h"
33
34 /**
35 * SECTION:channel-dispatcher
36 * @title: TpChannelDispatcher
37 * @short_description: proxy object for the Telepathy channel dispatcher
38 * @see_also: #TpChannelDispatchOperation, #TpChannelRequest
39 *
40 * The #TpChannelDispatcher object can be used to communicate with any
41 * implementation of the Telepathy ChannelDispatcher service to request
42 * new channels.
43 */
44
45 /**
46 * TpChannelDispatcher:
47 *
48 * The Channel Dispatcher's main D-Bus API is used to request channels,
49 * which is done by calling tp_cli_channel_dispatcher_call_create_channel() or
50 * tp_cli_channel_dispatcher_call_ensure_channel() as appropriate.
51 *
52 * The Telepathy Channel Dispatcher is also responsible for responding to new
53 * channels and launching client processes to handle them. However, clients
54 * that can work with incoming channels do not have to call methods
55 * on the channel dispatcher: instead, they must register with the channel
56 * dispatcher passively, by taking a bus name starting with
57 * %TP_CLIENT_BUS_NAME_BASE and implementing the #TpSvcClient interface.
58 * See the Telepathy D-Bus Interface Specification for details.
59 *
60 * This proxy is usable but incomplete: convenience methods will be added in
61 * a later version of telepathy-glib, along with a mechanism similar to
62 * tp_connection_call_when_ready().
63 *
64 * Since: 0.7.32
65 */
66
67 /**
68 * TpChannelDispatcherClass:
69 *
70 * The class of a #TpChannelDispatcher.
71 */
72
73 struct _TpChannelDispatcherPrivate {
74 gpointer dummy;
75 };
76
77 G_DEFINE_TYPE (TpChannelDispatcher, tp_channel_dispatcher, TP_TYPE_PROXY);
78
79 static void
80 tp_channel_dispatcher_init (TpChannelDispatcher *self)
81 {
82 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_CHANNEL_DISPATCHER,
83 TpChannelDispatcherPrivate);
84 }
85
86 static void
87 tp_channel_dispatcher_constructed (GObject *object)
88 {
89 TpChannelDispatcher *self = TP_CHANNEL_DISPATCHER (object);
90 void (*chain_up) (GObject *) =
91 ((GObjectClass *) tp_channel_dispatcher_parent_class)->constructed;
92
93 if (chain_up != NULL)
94 chain_up (object);
95
96 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
97 }
98
99 static void
100 tp_channel_dispatcher_class_init (TpChannelDispatcherClass *klass)
101 {
102 TpProxyClass *proxy_class = (TpProxyClass *) klass;
103 GObjectClass *object_class = (GObjectClass *) klass;
104
105 g_type_class_add_private (klass, sizeof (TpChannelDispatcherPrivate));
106
107 object_class->constructed = tp_channel_dispatcher_constructed;
108
109 proxy_class->interface = TP_IFACE_QUARK_CHANNEL_DISPATCHER;
110 tp_channel_dispatcher_init_known_interfaces ();
111 }
112
113 /**
114 * tp_channel_dispatcher_init_known_interfaces:
115 *
116 * Ensure that the known interfaces for TpChannelDispatcher have been set up.
117 * This is done automatically when necessary, but for correct
118 * overriding of library interfaces by local extensions, you should
119 * call this function before calling
120 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
121 * %TP_TYPE_CHANNEL_DISPATCHER.
122 *
123 * Since: 0.7.32
124 */
125 void
126 tp_channel_dispatcher_init_known_interfaces (void)
127 {
128 static gsize once = 0;
129
130 if (g_once_init_enter (&once))
131 {
132 GType tp_type = TP_TYPE_CHANNEL_DISPATCHER;
133
134 tp_proxy_init_known_interfaces ();
135 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
136 tp_cli_channel_dispatcher_add_signals);
137 tp_proxy_subclass_add_error_mapping (tp_type,
138 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
139
140 g_once_init_leave (&once, 1);
141 }
142 }
143
144 /**
145 * tp_channel_dispatcher_new:
146 * @bus_daemon: Proxy for the D-Bus daemon
147 *
148 * Convenience function to create a new channel dispatcher proxy.
149 *
150 * Returns: a new reference to a channel dispatcher proxy
151 */
152 TpChannelDispatcher *
153 tp_channel_dispatcher_new (TpDBusDaemon *bus_daemon)
154 {
155 TpChannelDispatcher *self;
156
157 g_return_val_if_fail (bus_daemon != NULL, NULL);
158
159 self = TP_CHANNEL_DISPATCHER (g_object_new (TP_TYPE_CHANNEL_DISPATCHER,
160 "dbus-daemon", bus_daemon,
161 "dbus-connection", ((TpProxy *) bus_daemon)->dbus_connection,
162 "bus-name", TP_CHANNEL_DISPATCHER_BUS_NAME,
163 "object-path", TP_CHANNEL_DISPATCHER_OBJECT_PATH,
164 NULL));
165
166 return self;
167 }
0 /*
1 * channel-dispatcher.h - proxy for the Telepathy channel dispatcher
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_CHANNEL_DISPATCHER_H
22 #define TP_CHANNEL_DISPATCHER_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29
30 typedef struct _TpChannelDispatcher TpChannelDispatcher;
31 typedef struct _TpChannelDispatcherClass TpChannelDispatcherClass;
32 typedef struct _TpChannelDispatcherPrivate TpChannelDispatcherPrivate;
33 typedef struct _TpChannelDispatcherClassPrivate TpChannelDispatcherClassPrivate;
34
35 struct _TpChannelDispatcher {
36 /*<private>*/
37 TpProxy parent;
38 TpChannelDispatcherPrivate *priv;
39 };
40
41 struct _TpChannelDispatcherClass {
42 /*<private>*/
43 TpProxyClass parent_class;
44 GCallback _padding[7];
45 TpChannelDispatcherClassPrivate *priv;
46 };
47
48 GType tp_channel_dispatcher_get_type (void);
49
50 #define TP_TYPE_CHANNEL_DISPATCHER \
51 (tp_channel_dispatcher_get_type ())
52 #define TP_CHANNEL_DISPATCHER(obj) \
53 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_CHANNEL_DISPATCHER, \
54 TpChannelDispatcher))
55 #define TP_CHANNEL_DISPATCHER_CLASS(klass) \
56 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_CHANNEL_DISPATCHER, \
57 TpChannelDispatcherClass))
58 #define TP_IS_CHANNEL_DISPATCHER(obj) \
59 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_CHANNEL_DISPATCHER))
60 #define TP_IS_CHANNEL_DISPATCHER_CLASS(klass) \
61 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_CHANNEL_DISPATCHER))
62 #define TP_CHANNEL_DISPATCHER_GET_CLASS(obj) \
63 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_CHANNEL_DISPATCHER, \
64 TpChannelDispatcherClass))
65
66 TpChannelDispatcher *tp_channel_dispatcher_new (TpDBusDaemon *bus_daemon);
67
68 void tp_channel_dispatcher_init_known_interfaces (void);
69
70 G_END_DECLS
71
72 #include <telepathy-glib/_gen/tp-cli-channel-dispatcher.h>
73
74 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>Channel Dispatcher interfaces</tp:title>
5
6 <xi:include href="../spec/Channel_Dispatcher.xml"/>
7 <xi:include href="../spec/Channel_Dispatcher_Interface_Operation_List.xml"/>
8
9 </tp:spec>
0 /*
1 * channel-request.c - proxy for a request to the Telepathy channel dispatcher
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/channel-request.h"
22
23 #include <telepathy-glib/defs.h>
24 #include <telepathy-glib/errors.h>
25 #include <telepathy-glib/interfaces.h>
26 #include <telepathy-glib/proxy-subclass.h>
27
28 #define DEBUG_FLAG TP_DEBUG_DISPATCHER
29 #include "telepathy-glib/dbus-internal.h"
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-channel-request-body.h"
33
34 /**
35 * SECTION:channel-request
36 * @title: TpChannelRequest
37 * @short_description: proxy object for a request to the Telepathy channel
38 * dispatcher
39 * @see_also: #TpChannelDispatcher
40 *
41 * Requesting a channel from the channel dispatcher can take some time, so an
42 * object is created in the channel dispatcher to represent each request.
43 * Objects of the #TpChannelRequest class provide access to one of those
44 * objects.
45 */
46
47 /**
48 * TpChannelRequest:
49 *
50 * Requesting a channel from the channel dispatcher can take some time, so an
51 * object is created in the channel dispatcher to represent each request. This
52 * proxy represents one of those objects.
53 *
54 * Any client can call tp_cli_channel_request_call_cancel() at any time to
55 * attempt to cancel the request.
56 *
57 * On success, the #TpChannelRequest::succeeded signal will be emitted.
58 * Immediately after that, the #TpProxy::invalidated signal will be emitted,
59 * with the domain %TP_DBUS_ERRORS and the error code
60 * %TP_DBUS_ERROR_OBJECT_REMOVED (this is not an error condition, it merely
61 * indicates that the channel request no longer exists).
62 *
63 * On failure, the #TpProxy::invalidated signal will be emitted with some
64 * other suitable error, usually from the %TP_ERRORS domain.
65 *
66 * If the channel dispatcher crashes or exits, the #TpProxy::invalidated
67 * signal will be emitted with the domain %TP_DBUS_ERRORS and the error code
68 * %TP_DBUS_ERROR_NAME_OWNER_LOST.
69 *
70 * This proxy is usable but incomplete: accessors for the Account,
71 * UserActionTime, PreferredHandler, Requests and Interfaces properties will
72 * be added in a later version of telepathy-glib, along with a mechanism
73 * similar to tp_connection_call_when_ready().
74 *
75 * Until suitable convenience methods are implemented, the generic
76 * tp_cli_dbus_properties_call_get_all() method can be used to get those
77 * properties.
78 *
79 * Since: 0.7.32
80 */
81
82 /**
83 * TpChannelRequestClass:
84 *
85 * The class of a #TpChannelRequest.
86 */
87
88 static guint signal_id_succeeded = 0;
89
90 struct _TpChannelRequestPrivate {
91 gpointer dummy;
92 };
93
94 G_DEFINE_TYPE (TpChannelRequest, tp_channel_request, TP_TYPE_PROXY);
95
96 static void
97 tp_channel_request_init (TpChannelRequest *self)
98 {
99 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_CHANNEL_REQUEST,
100 TpChannelRequestPrivate);
101 }
102
103 static void
104 tp_channel_request_failed_cb (TpChannelRequest *self,
105 const gchar *error_name,
106 const gchar *message,
107 gpointer unused G_GNUC_UNUSED,
108 GObject *object G_GNUC_UNUSED)
109 {
110 GError *error = NULL;
111
112 tp_proxy_dbus_error_to_gerror (self, error_name, message, &error);
113 tp_proxy_invalidate ((TpProxy *) self, error);
114 g_error_free (error);
115 }
116
117 static void
118 tp_channel_request_succeeded_cb (TpChannelRequest *self,
119 gpointer unused G_GNUC_UNUSED,
120 GObject *object G_GNUC_UNUSED)
121 {
122 GError e = { TP_DBUS_ERRORS, TP_DBUS_ERROR_OBJECT_REMOVED,
123 "ChannelRequest succeeded and was removed" };
124
125 g_signal_emit (self, signal_id_succeeded, 0);
126 tp_proxy_invalidate ((TpProxy *) self, &e);
127 }
128
129 static void
130 tp_channel_request_constructed (GObject *object)
131 {
132 TpChannelRequest *self = TP_CHANNEL_REQUEST (object);
133 void (*chain_up) (GObject *) =
134 ((GObjectClass *) tp_channel_request_parent_class)->constructed;
135 GError *error = NULL;
136 TpProxySignalConnection *sc;
137
138 if (chain_up != NULL)
139 chain_up (object);
140
141 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
142
143 sc = tp_cli_channel_request_connect_to_failed (self,
144 tp_channel_request_failed_cb, NULL, NULL, NULL, &error);
145
146 if (sc == NULL)
147 {
148 g_critical ("Couldn't connect to Failed: %s", error->message);
149 g_error_free (error);
150 g_assert_not_reached ();
151 return;
152 }
153
154 sc = tp_cli_channel_request_connect_to_succeeded (self,
155 tp_channel_request_succeeded_cb, NULL, NULL, NULL, &error);
156
157 if (sc == NULL)
158 {
159 g_critical ("Couldn't connect to Succeeded: %s", error->message);
160 g_error_free (error);
161 g_assert_not_reached ();
162 return;
163 }
164 }
165
166 static void
167 tp_channel_request_class_init (TpChannelRequestClass *klass)
168 {
169 TpProxyClass *proxy_class = (TpProxyClass *) klass;
170 GObjectClass *object_class = (GObjectClass *) klass;
171
172 g_type_class_add_private (klass, sizeof (TpChannelRequestPrivate));
173
174 object_class->constructed = tp_channel_request_constructed;
175
176 proxy_class->interface = TP_IFACE_QUARK_CHANNEL_REQUEST;
177 tp_channel_request_init_known_interfaces ();
178 proxy_class->must_have_unique_name = TRUE;
179
180 /**
181 * TpChannelRequest::succeeded:
182 * @self: the channel request proxy
183 *
184 * Emitted when the channel request succeeds.
185 */
186 signal_id_succeeded = g_signal_new ("succeeded",
187 G_OBJECT_CLASS_TYPE (klass),
188 G_SIGNAL_RUN_LAST | G_SIGNAL_DETAILED,
189 0,
190 NULL, NULL,
191 g_cclosure_marshal_VOID__VOID,
192 G_TYPE_NONE, 0);
193 }
194
195 /**
196 * tp_channel_request_init_known_interfaces:
197 *
198 * Ensure that the known interfaces for TpChannelRequest have been set up.
199 * This is done automatically when necessary, but for correct
200 * overriding of library interfaces by local extensions, you should
201 * call this function before calling
202 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
203 * %TP_TYPE_CHANNEL_REQUEST.
204 *
205 * Since: 0.7.32
206 */
207 void
208 tp_channel_request_init_known_interfaces (void)
209 {
210 static gsize once = 0;
211
212 if (g_once_init_enter (&once))
213 {
214 GType tp_type = TP_TYPE_CHANNEL_REQUEST;
215
216 tp_proxy_init_known_interfaces ();
217 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
218 tp_cli_channel_request_add_signals);
219 tp_proxy_subclass_add_error_mapping (tp_type,
220 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
221
222 g_once_init_leave (&once, 1);
223 }
224 }
225
226 /**
227 * tp_channel_request_new:
228 * @bus_daemon: Proxy for the D-Bus daemon
229 * @object_path: The non-NULL object path of this channel request
230 * @immutable_properties: As many as are known of the immutable D-Bus
231 * properties of this channel request, or %NULL if none are known
232 * @error: Used to raise an error if %NULL is returned
233 *
234 * Convenience function to create a new channel request proxy.
235 *
236 * If the channel request was newly created, the client making the request
237 * is responsible for calling tp_cli_channel_request_call_proceed() when it
238 * is ready for the channel request to proceed.
239 *
240 * The @immutable_properties argument is not yet used.
241 *
242 * Returns: a new reference to an channel request proxy, or %NULL if
243 * @object_path is not syntactically valid or the channel dispatcher is
244 * not running
245 */
246 TpChannelRequest *
247 tp_channel_request_new (TpDBusDaemon *bus_daemon,
248 const gchar *object_path,
249 GHashTable *immutable_properties G_GNUC_UNUSED,
250 GError **error)
251 {
252 TpChannelRequest *self;
253 gchar *unique_name;
254
255 g_return_val_if_fail (bus_daemon != NULL, NULL);
256 g_return_val_if_fail (object_path != NULL, NULL);
257 g_return_val_if_fail (error == NULL || *error == NULL, NULL);
258
259 if (!tp_dbus_check_valid_object_path (object_path, error))
260 return NULL;
261
262 if (!_tp_dbus_daemon_get_name_owner (bus_daemon, -1,
263 TP_CHANNEL_DISPATCHER_BUS_NAME, &unique_name, error))
264 return NULL;
265
266 self = TP_CHANNEL_REQUEST (g_object_new (TP_TYPE_CHANNEL_REQUEST,
267 "dbus-daemon", bus_daemon,
268 "dbus-connection", ((TpProxy *) bus_daemon)->dbus_connection,
269 "bus-name", unique_name,
270 "object-path", object_path,
271 NULL));
272
273 g_free (unique_name);
274
275 return self;
276 }
0 /*
1 * channel-request.h - proxy for a request to the channel dispatcher
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_CHANNEL_REQUEST_H
22 #define TP_CHANNEL_REQUEST_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29 typedef struct _TpChannelRequest TpChannelRequest;
30 typedef struct _TpChannelRequestClass TpChannelRequestClass;
31 typedef struct _TpChannelRequestPrivate TpChannelRequestPrivate;
32 typedef struct _TpChannelRequestClassPrivate TpChannelRequestClassPrivate;
33
34 struct _TpChannelRequest {
35 /*<private>*/
36 TpProxy parent;
37 TpChannelRequestPrivate *priv;
38 };
39
40 struct _TpChannelRequestClass {
41 /*<private>*/
42 TpProxyClass parent_class;
43 GCallback _padding[7];
44 TpChannelRequestClassPrivate *priv;
45 };
46
47 GType tp_channel_request_get_type (void);
48
49 #define TP_TYPE_CHANNEL_REQUEST \
50 (tp_channel_request_get_type ())
51 #define TP_CHANNEL_REQUEST(obj) \
52 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_CHANNEL_REQUEST, \
53 TpChannelRequest))
54 #define TP_CHANNEL_REQUEST_CLASS(klass) \
55 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_CHANNEL_REQUEST, \
56 TpChannelRequestClass))
57 #define TP_IS_CHANNEL_REQUEST(obj) \
58 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_CHANNEL_REQUEST))
59 #define TP_IS_CHANNEL_REQUEST_CLASS(klass) \
60 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_CHANNEL_REQUEST))
61 #define TP_CHANNEL_REQUEST_GET_CLASS(obj) \
62 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_CHANNEL_REQUEST, \
63 TpChannelRequestClass))
64
65 TpChannelRequest *tp_channel_request_new (TpDBusDaemon *bus_daemon,
66 const gchar *object_path, GHashTable *immutable_properties,
67 GError **error);
68
69 void tp_channel_request_init_known_interfaces (void);
70
71 G_END_DECLS
72
73 #include <telepathy-glib/_gen/tp-cli-channel-request.h>
74
75 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>CR interfaces</tp:title>
5
6 <xi:include href="../spec/Channel_Request.xml"/>
7
8 </tp:spec>
10191019
10201020 DEBUG ("%p", self);
10211021
1022 if (self->priv->connection == NULL)
1023 goto finally;
1024
10221025 if (self->priv->conn_invalidated_id != 0)
10231026 g_signal_handler_disconnect (self->priv->connection,
10241027 self->priv->conn_invalidated_id);
10281031 g_object_unref (self->priv->connection);
10291032 self->priv->connection = NULL;
10301033
1034 finally:
10311035 ((GObjectClass *) tp_channel_parent_class)->dispose (object);
10321036 }
10331037
0 /*
1 * client.c - proxy for a Telepathy client
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "telepathy-glib/client.h"
22
23 #include <telepathy-glib/dbus.h>
24 #include <telepathy-glib/defs.h>
25 #include <telepathy-glib/errors.h>
26 #include <telepathy-glib/interfaces.h>
27 #include <telepathy-glib/proxy-subclass.h>
28
29 #define DEBUG_FLAG TP_DEBUG_DISPATCHER
30 #include "telepathy-glib/debug-internal.h"
31
32 #include "telepathy-glib/_gen/tp-cli-client-body.h"
33
34 /**
35 * SECTION:client
36 * @title: TpClient
37 * @short_description: proxy object for a client of the ChannelDispatcher
38 *
39 * Each client to which the ChannelDispatcher can send channels must implement
40 * the Client interface. This object represents such a client, and is mainly
41 * useful in the implementation of the ChannelDispatcher itself.
42 *
43 * Since: 0.7.32
44 */
45
46 /**
47 * TpClient:
48 *
49 * Each client to which the ChannelDispatcher can send channels must implement
50 * the Client interface. This object represents such a client, and is mainly
51 * useful in the implementation of the ChannelDispatcher itself.
52 *
53 * This proxy is usable but very incomplete: accessors for D-Bus properties
54 * will be added in a later version of telepathy-glib, along with a mechanism
55 * similar to tp_connection_call_when_ready().
56 *
57 * Many operations performed on a Client are done via D-Bus properties.
58 * Until convenience methods for this are implemented, use of the generic
59 * tp_cli_dbus_properties_call_get_all() and tp_cli_dbus_properties_call_set()
60 * methods is recommended.
61 *
62 * Since: 0.7.32
63 */
64
65 /**
66 * TpClientClass:
67 *
68 * The class of a #TpClient.
69 */
70
71 struct _TpClientPrivate {
72 gpointer dummy;
73 };
74
75 G_DEFINE_TYPE (TpClient, tp_client, TP_TYPE_PROXY);
76
77 static void
78 tp_client_init (TpClient *self)
79 {
80 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_CLIENT,
81 TpClientPrivate);
82 }
83
84 static void
85 tp_client_constructed (GObject *object)
86 {
87 TpClient *self = TP_CLIENT (object);
88 void (*chain_up) (GObject *) =
89 ((GObjectClass *) tp_client_parent_class)->constructed;
90
91 if (chain_up != NULL)
92 chain_up (object);
93
94 g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
95 }
96
97 static void
98 tp_client_class_init (TpClientClass *klass)
99 {
100 TpProxyClass *proxy_class = (TpProxyClass *) klass;
101 GObjectClass *object_class = (GObjectClass *) klass;
102
103 g_type_class_add_private (klass, sizeof (TpClientPrivate));
104
105 object_class->constructed = tp_client_constructed;
106
107 proxy_class->interface = TP_IFACE_QUARK_CLIENT;
108 tp_client_init_known_interfaces ();
109 }
110
111 /**
112 * tp_client_init_known_interfaces:
113 *
114 * Ensure that the known interfaces for TpClient have been set up.
115 * This is done automatically when necessary, but for correct
116 * overriding of library interfaces by local extensions, you should
117 * call this function before calling
118 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
119 * %TP_TYPE_CLIENT.
120 *
121 * Since: 0.7.32
122 */
123 void
124 tp_client_init_known_interfaces (void)
125 {
126 static gsize once = 0;
127
128 if (g_once_init_enter (&once))
129 {
130 GType tp_type = TP_TYPE_CLIENT;
131
132 tp_proxy_init_known_interfaces ();
133 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
134 tp_cli_client_add_signals);
135 tp_proxy_subclass_add_error_mapping (tp_type,
136 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
137
138 g_once_init_leave (&once, 1);
139 }
140 }
0 /*
1 * client.h - proxy for a Telepathy client
2 *
3 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
4 * Copyright (C) 2009 Nokia Corporation
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef TP_CLIENT_H
22 #define TP_CLIENT_H
23
24 #include <telepathy-glib/proxy.h>
25 #include <telepathy-glib/dbus.h>
26
27 G_BEGIN_DECLS
28
29 typedef struct _TpClient TpClient;
30 typedef struct _TpClientClass TpClientClass;
31 typedef struct _TpClientPrivate TpClientPrivate;
32 typedef struct _TpClientClassPrivate TpClientClassPrivate;
33
34 struct _TpClient {
35 /*<private>*/
36 TpProxy parent;
37 TpClientPrivate *priv;
38 };
39
40 struct _TpClientClass {
41 /*<private>*/
42 TpProxyClass parent_class;
43 GCallback _padding[7];
44 TpClientClassPrivate *priv;
45 };
46
47 GType tp_client_get_type (void);
48
49 #define TP_TYPE_CLIENT \
50 (tp_client_get_type ())
51 #define TP_CLIENT(obj) \
52 (G_TYPE_CHECK_INSTANCE_CAST ((obj), TP_TYPE_CLIENT, \
53 TpClient))
54 #define TP_CLIENT_CLASS(klass) \
55 (G_TYPE_CHECK_CLASS_CAST ((klass), TP_TYPE_CLIENT, \
56 TpClientClass))
57 #define TP_IS_CLIENT(obj) \
58 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), TP_TYPE_CLIENT))
59 #define TP_IS_CLIENT_CLASS(klass) \
60 (G_TYPE_CHECK_CLASS_TYPE ((klass), TP_TYPE_CLIENT))
61 #define TP_CLIENT_GET_CLASS(obj) \
62 (G_TYPE_INSTANCE_GET_CLASS ((obj), TP_TYPE_CLIENT, \
63 TpClientClass))
64
65 void tp_client_init_known_interfaces (void);
66
67 G_END_DECLS
68
69 #include <telepathy-glib/_gen/tp-cli-client.h>
70
71 #endif
0 <tp:spec
1 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
2 xmlns:xi="http://www.w3.org/2001/XInclude">
3
4 <tp:title>Client interfaces</tp:title>
5
6 <xi:include href="../spec/Client.xml"/>
7 <xi:include href="../spec/Client_Observer.xml"/>
8 <xi:include href="../spec/Client_Approver.xml"/>r
9 <xi:include href="../spec/Client_Handler.xml"/>
10 <xi:include href="../spec/Client_Interface_Requests.xml"/>
11
12 </tp:spec>
276276 * tp_cli_connection_interface_contacts_run_get_contact_attributes() directly.
277277 * Those functions should be avoided in favour of using #TpContact,
278278 * tp_connection_hold_handles(), tp_connection_request_handles() and
279 * tp_connection_get_contact_attributes().
279 * tp_connection_get_contact_attributes(), which along with this function
280 * perform client-side reference counting of handles.
280281 *
281282 * If @self has already become invalid, this function does nothing.
282283 */
461462 * If they are valid, the callback will later be called with the given
462463 * handles; if not all of them are valid, the callback will be called with
463464 * an error.
465 *
466 * This function, along with tp_connection_unref_handles(),
467 * tp_connection_get_contact_attributes() and #TpContact, keeps a client-side
468 * reference count of handles; you should not use the RequestHandles,
469 * HoldHandles and GetContactAttributes D-Bus methods directly as well as these
470 * functions.
464471 */
465472 void
466473 tp_connection_hold_handles (TpConnection *self,
742749 *
743750 * This is a thin wrapper around the GetContactAttributes D-Bus method, and
744751 * should be used in preference to
745 * tp_cli_connection_interface_contacts_get_contact_attributes().
752 * tp_cli_connection_interface_contacts_get_contact_attributes(); mixing this
753 * function, tp_connection_hold_handles(), tp_connection_unref_handles(), and
754 * #TpContact with direct use of the RequestHandles, HoldHandles and
755 * GetContactAttributes D-Bus methods is unwise, as #TpConnection and
756 * #TpContact perform client-side reference counting of handles.
746757 * The #TpContact API provides a higher-level abstraction which should
747758 * usually be used instead.
748759 *
3737 TpConnectionStatusReason status_reason;
3838 GError *connection_error /* initialized statically */;
3939
40 TpConnectionAliasFlags alias_flags;
41
4240 /* GArray of GQuark */
4341 GArray *contact_attribute_interfaces;
4442
822822 g_value_take_string (value, s);
823823 return (s != NULL);
824824
825 case 'y':
825826 case 'q':
826827 case 'u':
827828 case 't':
840841 return TRUE;
841842 }
842843
844 if (sig[0] == 'y')
845 {
846 if (v > G_MAXUINT8)
847 {
848 return FALSE;
849 }
850
851 g_value_set_uchar (value, v);
852 return TRUE;
853 }
854
843855 if (v > G_MAXUINT32 || (sig[0] == 'q' && v > G_MAXUINT16))
844856 return FALSE;
845857
883895 case 'o':
884896 s = g_key_file_get_string (file, group, key, NULL);
885897
898 if (s == NULL || !tp_dbus_check_valid_object_path (s, NULL))
899 {
900 g_free (s);
901 return FALSE;
902 }
903
886904 g_value_take_boxed (value, s);
887
888 if (s[0] != '/')
889 return FALSE;
890905
891906 return TRUE;
892907
13821397 }
13831398 }
13841399
1400 /**
1401 * tp_connection_manager_init_known_interfaces:
1402 *
1403 * Ensure that the known interfaces for TpConnectionManager have been set up.
1404 * This is done automatically when necessary, but for correct
1405 * overriding of library interfaces by local extensions, you should
1406 * call this function before calling
1407 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
1408 * %TP_TYPE_CONNECTION_MANAGER.
1409 *
1410 * Since: 0.7.32
1411 */
1412 void
1413 tp_connection_manager_init_known_interfaces (void)
1414 {
1415 static gsize once = 0;
1416
1417 if (g_once_init_enter (&once))
1418 {
1419 GType tp_type = TP_TYPE_CONNECTION_MANAGER;
1420
1421 tp_proxy_init_known_interfaces ();
1422 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
1423 tp_cli_connection_manager_add_signals);
1424 tp_proxy_subclass_add_error_mapping (tp_type,
1425 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
1426
1427 g_once_init_leave (&once, 1);
1428 }
1429 }
1430
13851431 static void
13861432 tp_connection_manager_class_init (TpConnectionManagerClass *klass)
13871433 {
1388 GType tp_type = TP_TYPE_CONNECTION_MANAGER;
13891434 TpProxyClass *proxy_class = (TpProxyClass *) klass;
13901435 GObjectClass *object_class = (GObjectClass *) klass;
13911436 GParamSpec *param_spec;
1437
1438 tp_connection_manager_init_known_interfaces ();
13921439
13931440 g_type_class_add_private (klass, sizeof (TpConnectionManagerPrivate));
13941441
13991446 object_class->finalize = tp_connection_manager_finalize;
14001447
14011448 proxy_class->interface = TP_IFACE_QUARK_CONNECTION_MANAGER;
1402 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
1403 tp_cli_connection_manager_add_signals);
1404 tp_proxy_subclass_add_error_mapping (tp_type,
1405 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
14061449
14071450 /**
14081451 * TpConnectionManager:info-source:
165165 gboolean tp_connection_manager_param_get_default (
166166 const TpConnectionManagerParam *param, GValue *value);
167167
168 void tp_connection_manager_init_known_interfaces (void);
169
168170 G_END_DECLS
169171
170172 #include <telepathy-glib/_gen/tp-cli-connection-manager.h>
180180 g_array_remove_index (self->priv->introspect_needed, i);
181181 next (self);
182182 }
183 }
184
185 static void
186 got_aliasing_flags (TpConnection *self,
187 guint flags,
188 const GError *error,
189 gpointer user_data,
190 GObject *weak_object)
191 {
192 if (error == NULL)
193 {
194 DEBUG ("Introspected aliasing flags: 0x%x", flags);
195 self->priv->alias_flags = flags;
196 }
197 else
198 {
199 DEBUG ("GetAliasFlags(): %s", error->message);
200 }
201
202 tp_connection_continue_introspection (self);
203 }
204
205 static void
206 introspect_aliasing (TpConnection *self)
207 {
208 g_assert (self->priv->introspect_needed != NULL);
209
210 tp_cli_connection_interface_aliasing_call_get_alias_flags
211 (self, -1, got_aliasing_flags, NULL, NULL, NULL);
212183 }
213184
214185 static void
385356 func = introspect_contacts;
386357 g_array_append_val (self->priv->introspect_needed, func);
387358 }
388 else if (q == TP_IFACE_QUARK_CONNECTION_INTERFACE_ALIASING)
389 {
390 /* call GetAliasFlags */
391 func = introspect_aliasing;
392 g_array_append_val (self->priv->introspect_needed,
393 func);
394 }
395 #if 0
396 else if (q == TP_IFACE_QUARK_CONNECTION_INTERFACE_AVATARS)
397 {
398 /* call GetAvatarRequirements */
399 func = introspect_avatars;
400 g_array_append_val (self->priv->introspect_needed,
401 func);
402 }
403 else if (q == TP_IFACE_QUARK_CONNECTION_INTERFACE_PRESENCE)
404 {
405 /* call GetStatuses */
406 func = introspect_presence;
407 g_array_append_val (self->priv->introspect_needed,
408 func);
409 }
410 /* if Privacy was stable, we'd also queue GetPrivacyModes
411 * here */
412 #endif
413359 }
414360 else
415361 {
713659 static void
714660 tp_connection_class_init (TpConnectionClass *klass)
715661 {
716 GType tp_type = TP_TYPE_CONNECTION;
717662 GParamSpec *param_spec;
718663 TpProxyClass *proxy_class = (TpProxyClass *) klass;
719664 GObjectClass *object_class = (GObjectClass *) klass;
665
666 tp_connection_init_known_interfaces ();
720667
721668 g_type_class_add_private (klass, sizeof (TpConnectionPrivate));
722669
729676 /* If you change this, you must also change TpChannel to stop asserting
730677 * that its connection has a unique name */
731678 proxy_class->must_have_unique_name = TRUE;
732 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
733 tp_cli_connection_add_signals);
734 tp_proxy_subclass_add_error_mapping (tp_type,
735 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
736679
737680 /**
738681 * TpConnection:status:
12631263 G_OBJECT_CLASS (tp_dbus_daemon_parent_class)->dispose (object);
12641264 }
12651265
1266 /**
1267 * tp_dbus_daemon_init_known_interfaces:
1268 *
1269 * Ensure that the known interfaces for TpDBusDaemon have been set up.
1270 * This is done automatically when necessary, but for correct
1271 * overriding of library interfaces by local extensions, you should
1272 * call this function before calling
1273 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
1274 * %TP_TYPE_DBUS_DAEMON.
1275 *
1276 * Since: 0.7.32
1277 */
1278 void
1279 tp_dbus_daemon_init_known_interfaces (void)
1280 {
1281 static gsize once = 0;
1282
1283 if (g_once_init_enter (&once))
1284 {
1285 tp_proxy_init_known_interfaces ();
1286 tp_proxy_or_subclass_hook_on_interface_add (TP_TYPE_DBUS_DAEMON,
1287 tp_cli_dbus_daemon_add_signals);
1288
1289 g_once_init_leave (&once, 1);
1290 }
1291 }
1292
12661293 static void
12671294 tp_dbus_daemon_class_init (TpDBusDaemonClass *klass)
12681295 {
12691296 TpProxyClass *proxy_class = (TpProxyClass *) klass;
12701297 GObjectClass *object_class = (GObjectClass *) klass;
12711298
1299 tp_dbus_daemon_init_known_interfaces ();
1300
12721301 g_type_class_add_private (klass, sizeof (TpDBusDaemonPrivate));
12731302
12741303 object_class->constructor = tp_dbus_daemon_constructor;
12751304 object_class->dispose = tp_dbus_daemon_dispose;
12761305
12771306 proxy_class->interface = TP_IFACE_QUARK_DBUS_DAEMON;
1278 tp_proxy_or_subclass_hook_on_interface_add (TP_TYPE_DBUS_DAEMON,
1279 tp_cli_dbus_daemon_add_signals);
12801307 }
12811308
12821309 /* Auto-generated implementation of _tp_register_dbus_glib_marshallers */
5252 TpDBusDaemon *tp_dbus_daemon_dup (GError **error);
5353
5454 TpDBusDaemon *tp_dbus_daemon_new (DBusGConnection *connection);
55
56 void tp_dbus_daemon_init_known_interfaces (void);
5557
5658 typedef void (*TpDBusDaemonNameOwnerChangedCb) (TpDBusDaemon *bus_daemon,
5759 const gchar *name, const gchar *new_owner, gpointer user_data);
159161 void tp_asv_set_strv (GHashTable *asv, const gchar *key, gchar **value);
160162 void tp_asv_dump (GHashTable *asv);
161163
164 #ifndef TP_DISABLE_DEPRECATED
165 DBusGProxy * tp_get_bus_proxy (void) G_GNUC_DEPRECATED;
166 #endif
167
162168 G_END_DECLS
163169
164170 #include <telepathy-glib/_gen/tp-cli-dbus-daemon.h>
165171
166 #ifndef TP_DISABLE_DEPRECATED
167 DBusGProxy * tp_get_bus_proxy (void) G_GNUC_DEPRECATED;
168 #endif
169
170172 #endif /* __TELEPATHY_DBUS_H__ */
2424 TP_DEBUG_CHANNEL = 1 << 8,
2525 TP_DEBUG_PROXY = 1 << 9,
2626 TP_DEBUG_HANDLES = 1 << 10,
27 TP_DEBUG_CONTACTS = 1 << 11
27 TP_DEBUG_CONTACTS = 1 << 11,
28 TP_DEBUG_ACCOUNTS = 1 << 12,
29 TP_DEBUG_DISPATCHER = 1 << 13
2830 } TpDebugFlags;
2931
3032 gboolean _tp_debug_flag_is_set (TpDebugFlags flag);
4747 * (service)</listitem>
4848 * <listitem><literal>handles</literal> - handle reference tracking tracking
4949 * in #TpBaseConnection (service) and #TpConnection (client)</listitem>
50 * <listitem><literal>accounts</literal> - the #TpAccountManager and
51 * #TpAccount objects (client)</listitem>
5052 * <listitem><literal>all</literal> - all of the above</listitem>
5153 * </itemizedlist>
5254 */
105107 { "proxy", TP_DEBUG_PROXY },
106108 { "handles", TP_DEBUG_HANDLES },
107109 { "contacts", TP_DEBUG_CONTACTS },
110 { "accounts", TP_DEBUG_ACCOUNTS },
111 { "dispatcher", TP_DEBUG_DISPATCHER },
108112 { 0, }
109113 };
110114
00 /*
11 * defs.h - miscellaneous definitions
22 *
3 * Copyright (C) 2007 Collabora Ltd.
4 * Copyright (C) 2007 Nokia Corporation
3 * Copyright (C) 2007-2009 Collabora Ltd.
4 * Copyright (C) 2007-2009 Nokia Corporation
55 *
66 * This library is free software; you can redistribute it and/or
77 * modify it under the terms of the GNU Lesser General Public
5656 */
5757 #define TP_CONN_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Connection/"
5858
59 /**
60 * TP_ACCOUNT_MANAGER_BUS_NAME:
61 *
62 * The account manager's well-known bus name
63 */
64 #define TP_ACCOUNT_MANAGER_BUS_NAME "org.freedesktop.Telepathy.AccountManager"
65
66 /**
67 * TP_ACCOUNT_MANAGER_OBJECT_PATH:
68 *
69 * The account manager's standard object path
70 */
71 #define TP_ACCOUNT_MANAGER_OBJECT_PATH "/org/freedesktop/Telepathy/AccountManager"
72
73 /**
74 * TP_ACCOUNT_OBJECT_PATH_BASE:
75 *
76 * The common prefix of the object path for all Account objects.
77 */
78 #define TP_ACCOUNT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Account/"
79
80 /**
81 * TP_CHANNEL_DISPATCHER_BUS_NAME:
82 *
83 * The channel dispatcher's well-known bus name
84 */
85 #define TP_CHANNEL_DISPATCHER_BUS_NAME "org.freedesktop.Telepathy.ChannelDispatcher"
86
87 /**
88 * TP_CHANNEL_DISPATCHER_OBJECT_PATH:
89 *
90 * The channel dispatcher's standard object path
91 */
92 #define TP_CHANNEL_DISPATCHER_OBJECT_PATH "/org/freedesktop/Telepathy/ChannelDispatcher"
93
94 /**
95 * TP_CLIENT_BUS_NAME_BASE:
96 *
97 * The common prefix of the well-known bus name for any Telepathy Client.
98 */
99 #define TP_CLIENT_BUS_NAME_BASE "org.freedesktop.Telepathy.Client."
100
101 /**
102 * TP_CLIENT_OBJECT_PATH_BASE
103 *
104 * The common prefix of the well-known object path for any Telepathy Client.
105 */
106 #define TP_CLIENT_OBJECT_PATH_BASE "/org/freedesktop/Telepathy/Client/"
107
59108 G_END_DECLS
60109 #endif
198198 */
199199
200200 /**
201 * SECTION:svc-account
202 * @title: Service-side Account interfaces
203 * @short_description: GInterfaces for Telepathy Account objects
204 *
205 * These interfaces (auto-generated from the Telepathy spec) make it easier
206 * to export objects implementing the Telepathy Account and its
207 * optional interfaces, with the correct method and signal signatures,
208 * and emit signals from those objects in a type-safe way.
209 *
210 * You don't need these interfaces unless you're implementing a
211 * Telepathy AccountManager, such as Mission Control.
212 */
213
214 /**
215 * SECTION:svc-account-manager
216 * @title: Service-side Account Manager interface
217 * @short_description: GInterface for Telepathy AccountManager objects
218 *
219 * The #TpSvcAccountManager interface (auto-generated from the Telepathy
220 * spec) makes it easier to export an object implementing the Telepathy
221 * AccountManager interface, with the correct method and signal signatures,
222 * and emit signals from that object in a type-safe way.
223 *
224 * You don't need these interfaces unless you're implementing a
225 * Telepathy AccountManager, such as Mission Control.
226 */
227
228 /**
229 * SECTION:svc-channel-dispatcher
230 * @title: Service-side Channel Dispatcher interface
231 * @short_description: GInterfaces for Telepathy ChannelDispatcher object
232 *
233 * The #TpSvcChannelDispatcher interface (auto-generated from the Telepathy
234 * spec) makes it easier to export an object implementing the Telepathy
235 * ChannelDispatcher interface, with the correct method and signal signatures,
236 * and emit signals from that object in a type-safe way.
237 *
238 * Similarly, #TpSvcChannelDispatcherInterfaceOperationList helps to
239 * implement the optional OperationList interface.
240 *
241 * You don't need these interfaces unless you're implementing a
242 * Telepathy ChannelDispatcher, such as Mission Control.
243 */
244
245 /**
246 * SECTION:svc-channel-dispatch-operation
247 * @title: Service-side Channel Dispatch Operation interface
248 * @short_description: GInterface for Telepathy ChannelDispatchOperation object
249 *
250 * This interface (auto-generated from the Telepathy
251 * spec) makes it easier to export an object implementing the Telepathy
252 * ChannelDispatchOperation interface, with the correct method and signal
253 * signatures, and emit signals from that object in a type-safe way.
254 *
255 * You don't need these interfaces unless you're implementing a
256 * Telepathy ChannelDispatcher, such as Mission Control.
257 */
258
259 /**
260 * SECTION:svc-channel-request
261 * @title: Service-side Channel Request interface
262 * @short_description: GInterface for Telepathy ChannelRequest object
263 *
264 * This interface (auto-generated from the Telepathy
265 * spec) makes it easier to export an object implementing the Telepathy
266 * ChannelRequest interface, with the correct method and signal
267 * signatures, and emit signals from that object in a type-safe way.
268 *
269 * You don't need these interfaces unless you're implementing a
270 * Telepathy ChannelDispatcher, such as Mission Control.
271 */
272
273 /**
274 * SECTION:svc-channel-dispatcher
275 * @title: Service-side Channel Dispatcher interface
276 * @short_description: GInterfaces for Telepathy ChannelDispatcher object
277 *
278 * The #TpSvcChannelDispatcher interface (auto-generated from the Telepathy
279 * spec) makes it easier to export an object implementing the Telepathy
280 * ChannelDispatcher interface, with the correct method and signal signatures,
281 * and emit signals from that object in a type-safe way.
282 *
283 * Similarly, #TpSvcChannelDispatcherInterfaceOperationList helps to
284 * implement the optional OperationList interface.
285 *
286 * You don't need these interfaces unless you're implementing a
287 * Telepathy ChannelDispatcher, such as Mission Control.
288 */
289
290 /**
201291 * SECTION:svc-media-interfaces
202292 * @title: Service-side media streaming helper interfaces
203293 * @short_description: media session and media stream
207297 * to export the objects used to implement #TpSvcChannelTypeStreamedMedia,
208298 * with the correct method and signal signatures, and emit signals from those
209299 * objects.
300 */
301
302 /**
303 * SECTION:svc-client
304 * @title: Service-side Client interfaces
305 * @short_description: interfaces used to be an Observer, Approver and Handler
306 *
307 * These interfaces (auto-generated from the telepathy spec) make it easier
308 * to export the objects used to implement a Telepathy client.
309 *
310 * Clients such as loggers, new message notification windows and chat UIs
311 * should implement some or all of the Client types (Observer, Approver and/or
312 * Handler): see telepathy-spec for details.
210313 */
211314
212315 /**
7878 static void
7979 tp_media_stream_handler_class_init (TpMediaStreamHandlerClass *klass)
8080 {
81 GType tp_type = TP_TYPE_MEDIA_STREAM_HANDLER;
8281 TpProxyClass *proxy_class = (TpProxyClass *) klass;
8382
8483 proxy_class->must_have_unique_name = TRUE;
8584 proxy_class->interface = TP_IFACE_QUARK_MEDIA_STREAM_HANDLER;
86 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
87 tp_cli_media_stream_handler_add_signals);
88 tp_proxy_subclass_add_error_mapping (tp_type,
89 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
85 tp_media_stream_handler_init_known_interfaces ();
9086 }
9187
9288 /**
166162 static void
167163 tp_media_session_handler_class_init (TpMediaSessionHandlerClass *klass)
168164 {
169 GType tp_type = TP_TYPE_MEDIA_SESSION_HANDLER;
170165 TpProxyClass *proxy_class = (TpProxyClass *) klass;
171166
172167 proxy_class->must_have_unique_name = TRUE;
173168 proxy_class->interface = TP_IFACE_QUARK_MEDIA_SESSION_HANDLER;
174 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
175 tp_cli_media_session_handler_add_signals);
176 tp_proxy_subclass_add_error_mapping (tp_type,
177 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
169 tp_media_session_handler_init_known_interfaces ();
178170 }
179171
180172 /**
215207 finally:
216208 return ret;
217209 }
210
211 /**
212 * tp_media_stream_handler_init_known_interfaces:
213 *
214 * Ensure that the known interfaces for TpMediaStreamHandler have been set up.
215 * This is done automatically when necessary, but for correct
216 * overriding of library interfaces by local extensions, you should
217 * call this function before calling
218 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
219 * %TP_TYPE_MEDIA_STREAM_HANDLER.
220 *
221 * Since: 0.7.32
222 */
223 void
224 tp_media_stream_handler_init_known_interfaces (void)
225 {
226 static gsize once = 0;
227
228 if (g_once_init_enter (&once))
229 {
230 GType tp_type = TP_TYPE_MEDIA_STREAM_HANDLER;
231
232 tp_proxy_init_known_interfaces ();
233 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
234 tp_cli_media_stream_handler_add_signals);
235 tp_proxy_subclass_add_error_mapping (tp_type,
236 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
237
238 g_once_init_leave (&once, 1);
239 }
240 }
241
242 /**
243 * tp_media_session_handler_init_known_interfaces:
244 *
245 * Ensure that the known interfaces for TpMediaSessionHandler have been set up.
246 * This is done automatically when necessary, but for correct
247 * overriding of library interfaces by local extensions, you should
248 * call this function before calling
249 * tp_proxy_or_subclass_hook_on_interface_add() with first argument
250 * %TP_TYPE_MEDIA_SESSION_HANDLER.
251 *
252 * Since: 0.7.32
253 */
254 void
255 tp_media_session_handler_init_known_interfaces (void)
256 {
257 static gsize once = 0;
258
259 if (g_once_init_enter (&once))
260 {
261 GType tp_type = TP_TYPE_MEDIA_SESSION_HANDLER;
262
263 tp_proxy_init_known_interfaces ();
264 tp_proxy_or_subclass_hook_on_interface_add (tp_type,
265 tp_cli_media_session_handler_add_signals);
266 tp_proxy_subclass_add_error_mapping (tp_type,
267 TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
268
269 g_once_init_leave (&once, 1);
270 }
271 }
7676 TpMediaStreamHandler *tp_media_stream_handler_new (TpDBusDaemon *dbus,
7777 const gchar *unique_name, const gchar *object_path, GError **error);
7878
79 void tp_media_session_handler_init_known_interfaces (void);
80 void tp_media_stream_handler_init_known_interfaces (void);
81
7982 G_END_DECLS
8083
8184 #include <telepathy-glib/_gen/tp-cli-media-session-handler.h>
1111 <xi:include href="generic.xml"/>
1212 <xi:include href="dbus-daemon.xml"/>
1313
14 <xi:include href="account-manager.xml"/>
15 <xi:include href="account.xml"/>
16
17 <xi:include href="channel-dispatcher.xml"/>
18 <xi:include href="channel-dispatch-operation.xml"/>
19 <xi:include href="channel-request.xml"/>
20
21 <xi:include href="client.xml"/>
22
1423 <xi:include href="../spec/generic-types.xml"/>
1524 <xi:include href="../spec/errors.xml"/>
1625
0 #ifndef __TP_META_SVC_ACCOUNT_MANAGER_H__
1 #define __TP_META_SVC_ACCOUNT_MANAGER_H__
2
3 #include <telepathy-glib/_gen/tp-svc-account-manager.h>
4
5 #endif
0 #ifndef __TP_META_SVC_ACCOUNT_H__
1 #define __TP_META_SVC_ACCOUNT_H__
2
3 #include <telepathy-glib/_gen/tp-svc-account.h>
4
5 #endif
0 #ifndef __TP_META_SVC_CHANNEL_DISPATCH_OPERATION_H__
1 #define __TP_META_SVC_CHANNEL_DISPATCH_OPERATION_H__
2
3 #include <telepathy-glib/_gen/tp-svc-channel-dispatch-operation.h>
4
5 #endif
0 #ifndef __TP_META_SVC_CHANNEL_DISPATCHER_H__
1 #define __TP_META_SVC_CHANNEL_DISPATCHER_H__
2
3 #include <telepathy-glib/_gen/tp-svc-channel-dispatcher.h>
4
5 #endif
0 #ifndef __TP_META_SVC_CHANNEL_REQUEST_H__
1 #define __TP_META_SVC_CHANNEL_REQUEST_H__
2
3 #include <telepathy-glib/_gen/tp-svc-channel-request.h>
4
5 #endif
0 #ifndef __TP_META_SVC_CLIENT_H__
1 #define __TP_META_SVC_CLIENT_H__
2
3 #include <telepathy-glib/_gen/tp-svc-client.h>
4
5 #endif
0 Version: TELEPATHY_GLIB_0.7.32
1 Extends: TELEPATHY_GLIB_0.7.31
2 Release: 0.7.32
3
4 tp_account_get_type
5 tp_account_init_known_interfaces
6 tp_account_manager_get_type
7 tp_account_manager_init_known_interfaces
8 tp_account_manager_new
9 tp_account_new
10 tp_channel_dispatch_operation_get_type
11 tp_channel_dispatch_operation_init_known_interfaces
12 tp_channel_dispatch_operation_new
13 tp_channel_dispatcher_get_type
14 tp_channel_dispatcher_init_known_interfaces
15 tp_channel_dispatcher_new
16 tp_channel_request_get_type
17 tp_channel_request_init_known_interfaces
18 tp_channel_request_new
19 tp_cli_account_call_reconnect
20 tp_cli_account_call_remove
21 tp_cli_account_call_update_parameters
22 tp_cli_account_connect_to_account_property_changed
23 tp_cli_account_connect_to_removed
24 tp_cli_account_interface_avatar_connect_to_avatar_changed
25 tp_cli_account_manager_call_create_account
26 tp_cli_account_manager_connect_to_account_removed
27 tp_cli_account_manager_connect_to_account_validity_changed
28 tp_cli_channel_dispatch_operation_call_claim
29 tp_cli_channel_dispatch_operation_call_handle_with
30 tp_cli_channel_dispatch_operation_connect_to_channel_lost
31 tp_cli_channel_dispatch_operation_connect_to_finished
32 tp_cli_channel_dispatcher_call_create_channel
33 tp_cli_channel_dispatcher_call_ensure_channel
34 tp_cli_channel_dispatcher_interface_operation_list_connect_to_dispatch_operation_finished
35 tp_cli_channel_dispatcher_interface_operation_list_connect_to_new_dispatch_operation
36 tp_cli_channel_request_call_cancel
37 tp_cli_channel_request_call_proceed
38 tp_cli_channel_request_connect_to_failed
39 tp_cli_channel_request_connect_to_succeeded
40 tp_cli_client_approver_call_add_dispatch_operation
41 tp_cli_client_handler_call_handle_channels
42 tp_cli_client_interface_requests_call_add_request
43 tp_cli_client_interface_requests_call_remove_request
44 tp_cli_client_observer_call_observe_channels
45 tp_client_get_type
46 tp_client_init_known_interfaces
47 tp_connection_manager_init_known_interfaces
48 tp_dbus_daemon_init_known_interfaces
49 tp_iface_quark_account
50 tp_iface_quark_account_interface_avatar
51 tp_iface_quark_account_manager
52 tp_iface_quark_channel_dispatch_operation
53 tp_iface_quark_channel_dispatcher
54 tp_iface_quark_channel_dispatcher_interface_operation_list
55 tp_iface_quark_channel_request
56 tp_iface_quark_client
57 tp_iface_quark_client_approver
58 tp_iface_quark_client_handler
59 tp_iface_quark_client_interface_requests
60 tp_iface_quark_client_observer
61 tp_media_session_handler_init_known_interfaces
62 tp_media_stream_handler_init_known_interfaces
63 tp_svc_account_emit_account_property_changed
64 tp_svc_account_emit_removed
65 tp_svc_account_get_type
66 tp_svc_account_implement_reconnect
67 tp_svc_account_implement_remove
68 tp_svc_account_implement_update_parameters
69 tp_svc_account_interface_avatar_emit_avatar_changed
70 tp_svc_account_interface_avatar_get_type
71 tp_svc_account_manager_emit_account_removed
72 tp_svc_account_manager_emit_account_validity_changed
73 tp_svc_account_manager_get_type
74 tp_svc_account_manager_implement_create_account
75 tp_svc_channel_dispatch_operation_emit_channel_lost
76 tp_svc_channel_dispatch_operation_emit_finished
77 tp_svc_channel_dispatch_operation_get_type
78 tp_svc_channel_dispatch_operation_implement_claim
79 tp_svc_channel_dispatch_operation_implement_handle_with
80 tp_svc_channel_dispatcher_get_type
81 tp_svc_channel_dispatcher_implement_create_channel
82 tp_svc_channel_dispatcher_implement_ensure_channel
83 tp_svc_channel_dispatcher_interface_operation_list_emit_dispatch_operation_finished
84 tp_svc_channel_dispatcher_interface_operation_list_emit_new_dispatch_operation
85 tp_svc_channel_dispatcher_interface_operation_list_get_type
86 tp_svc_channel_request_emit_failed
87 tp_svc_channel_request_emit_succeeded
88 tp_svc_channel_request_get_type
89 tp_svc_channel_request_implement_cancel
90 tp_svc_channel_request_implement_proceed
91 tp_svc_client_approver_get_type
92 tp_svc_client_approver_implement_add_dispatch_operation
93 tp_svc_client_get_type
94 tp_svc_client_handler_get_type
95 tp_svc_client_handler_implement_handle_channels
96 tp_svc_client_interface_requests_get_type
97 tp_svc_client_interface_requests_implement_add_request
98 tp_svc_client_interface_requests_implement_remove_request
99 tp_svc_client_observer_get_type
100 tp_svc_client_observer_implement_observe_channels
101 tp_type_dbus_struct_ays
00 include $(top_srcdir)/tools/shave.mk
11
22 noinst_PROGRAMS = \
3 test-account \
4 test-account-manager \
35 test-call-cancellation \
46 test-callable-example \
7 test-channel-dispatcher \
8 test-channel-dispatch-operation \
59 test-channel-introspect \
10 test-channel-request \
611 test-cli-group \
12 test-client \
713 test-cm \
814 test-connection \
915 test-connection-bug-18845 \
3844 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
3945 $(top_builddir)/tests/lib/libtp-glib-tests.la
4046
47 test_account_SOURCES = account.c
48
49 test_account_manager_SOURCES = account-manager.c
50
4151 test_call_cancellation_SOURCES = call-cancellation.c
4252
53 test_channel_dispatcher_SOURCES = channel-dispatcher.c
54
55 test_channel_dispatch_operation_SOURCES = channel-dispatch-operation.c
56
4357 test_channel_introspect_SOURCES = channel-introspect.c
58
59 test_channel_request_SOURCES = channel-request.c
4460
4561 test_callable_example_SOURCES = callable-example.c
4662 test_callable_example_LDADD = \
4763 $(LDADD) \
4864 $(top_builddir)/examples/cm/callable/libexample-cm-callable.la
65
66 test_client_SOURCES = client.c
4967
5068 test_cli_group_SOURCES = cli-group.c
5169
3838 DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \
3939 $(top_srcdir)/tools/check-coding-style.mk \
4040 $(top_srcdir)/tools/shave.mk
41 noinst_PROGRAMS = test-call-cancellation$(EXEEXT) \
42 test-callable-example$(EXEEXT) \
43 test-channel-introspect$(EXEEXT) test-cli-group$(EXEEXT) \
44 test-cm$(EXEEXT) test-connection$(EXEEXT) \
45 test-connection-bug-18845$(EXEEXT) \
41 noinst_PROGRAMS = test-account$(EXEEXT) test-account-manager$(EXEEXT) \
42 test-call-cancellation$(EXEEXT) test-callable-example$(EXEEXT) \
43 test-channel-dispatcher$(EXEEXT) \
44 test-channel-dispatch-operation$(EXEEXT) \
45 test-channel-introspect$(EXEEXT) test-channel-request$(EXEEXT) \
46 test-cli-group$(EXEEXT) test-client$(EXEEXT) test-cm$(EXEEXT) \
47 test-connection$(EXEEXT) test-connection-bug-18845$(EXEEXT) \
4648 test-connection-error$(EXEEXT) \
4749 test-connection-handles$(EXEEXT) \
4850 test-connection-inject-bug16307$(EXEEXT) \
7577 CONFIG_HEADER = $(top_builddir)/config.h
7678 CONFIG_CLEAN_FILES =
7779 PROGRAMS = $(noinst_PROGRAMS)
80 am_test_account_OBJECTS = account.$(OBJEXT)
81 test_account_OBJECTS = $(am_test_account_OBJECTS)
82 test_account_LDADD = $(LDADD)
83 test_account_DEPENDENCIES = \
84 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
85 $(top_builddir)/tests/lib/libtp-glib-tests.la
86 am_test_account_manager_OBJECTS = account-manager.$(OBJEXT)
87 test_account_manager_OBJECTS = $(am_test_account_manager_OBJECTS)
88 test_account_manager_LDADD = $(LDADD)
89 test_account_manager_DEPENDENCIES = \
90 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
91 $(top_builddir)/tests/lib/libtp-glib-tests.la
7892 am_test_call_cancellation_OBJECTS = call-cancellation.$(OBJEXT)
7993 test_call_cancellation_OBJECTS = $(am_test_call_cancellation_OBJECTS)
8094 test_call_cancellation_LDADD = $(LDADD)
88102 $(top_builddir)/tests/lib/libtp-glib-tests.la
89103 test_callable_example_DEPENDENCIES = $(am__DEPENDENCIES_1) \
90104 $(top_builddir)/examples/cm/callable/libexample-cm-callable.la
105 am_test_channel_dispatch_operation_OBJECTS = \
106 channel-dispatch-operation.$(OBJEXT)
107 test_channel_dispatch_operation_OBJECTS = \
108 $(am_test_channel_dispatch_operation_OBJECTS)
109 test_channel_dispatch_operation_LDADD = $(LDADD)
110 test_channel_dispatch_operation_DEPENDENCIES = \
111 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
112 $(top_builddir)/tests/lib/libtp-glib-tests.la
113 am_test_channel_dispatcher_OBJECTS = channel-dispatcher.$(OBJEXT)
114 test_channel_dispatcher_OBJECTS = \
115 $(am_test_channel_dispatcher_OBJECTS)
116 test_channel_dispatcher_LDADD = $(LDADD)
117 test_channel_dispatcher_DEPENDENCIES = \
118 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
119 $(top_builddir)/tests/lib/libtp-glib-tests.la
91120 am_test_channel_introspect_OBJECTS = channel-introspect.$(OBJEXT)
92121 test_channel_introspect_OBJECTS = \
93122 $(am_test_channel_introspect_OBJECTS)
95124 test_channel_introspect_DEPENDENCIES = \
96125 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
97126 $(top_builddir)/tests/lib/libtp-glib-tests.la
127 am_test_channel_request_OBJECTS = channel-request.$(OBJEXT)
128 test_channel_request_OBJECTS = $(am_test_channel_request_OBJECTS)
129 test_channel_request_LDADD = $(LDADD)
130 test_channel_request_DEPENDENCIES = \
131 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
132 $(top_builddir)/tests/lib/libtp-glib-tests.la
98133 am_test_cli_group_OBJECTS = cli-group.$(OBJEXT)
99134 test_cli_group_OBJECTS = $(am_test_cli_group_OBJECTS)
100135 test_cli_group_LDADD = $(LDADD)
101136 test_cli_group_DEPENDENCIES = \
137 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
138 $(top_builddir)/tests/lib/libtp-glib-tests.la
139 am_test_client_OBJECTS = client.$(OBJEXT)
140 test_client_OBJECTS = $(am_test_client_OBJECTS)
141 test_client_LDADD = $(LDADD)
142 test_client_DEPENDENCIES = \
102143 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
103144 $(top_builddir)/tests/lib/libtp-glib-tests.la
104145 am_test_cm_OBJECTS = cm.$(OBJEXT)
286327 CCLD = $(CC)
287328 LINK = $(LIBTOOL) --tag=CC --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) \
288329 $(AM_LDFLAGS) $(LDFLAGS) -o $@
289 SOURCES = $(test_call_cancellation_SOURCES) \
330 SOURCES = $(test_account_SOURCES) $(test_account_manager_SOURCES) \
331 $(test_call_cancellation_SOURCES) \
290332 $(test_callable_example_SOURCES) \
291 $(test_channel_introspect_SOURCES) $(test_cli_group_SOURCES) \
292 $(test_cm_SOURCES) $(test_connection_SOURCES) \
333 $(test_channel_dispatch_operation_SOURCES) \
334 $(test_channel_dispatcher_SOURCES) \
335 $(test_channel_introspect_SOURCES) \
336 $(test_channel_request_SOURCES) $(test_cli_group_SOURCES) \
337 $(test_client_SOURCES) $(test_cm_SOURCES) \
338 $(test_connection_SOURCES) \
293339 $(test_connection_bug_18845_SOURCES) \
294340 $(test_connection_error_SOURCES) \
295341 $(test_connection_getinterfaces_failure_SOURCES) \
309355 $(test_self_handle_SOURCES) $(test_self_presence_SOURCES) \
310356 $(test_text_mixin_SOURCES) $(test_text_respawn_SOURCES) \
311357 $(test_unsupported_interface_SOURCES)
312 DIST_SOURCES = $(test_call_cancellation_SOURCES) \
358 DIST_SOURCES = $(test_account_SOURCES) $(test_account_manager_SOURCES) \
359 $(test_call_cancellation_SOURCES) \
313360 $(test_callable_example_SOURCES) \
314 $(test_channel_introspect_SOURCES) $(test_cli_group_SOURCES) \
315 $(test_cm_SOURCES) $(test_connection_SOURCES) \
361 $(test_channel_dispatch_operation_SOURCES) \
362 $(test_channel_dispatcher_SOURCES) \
363 $(test_channel_introspect_SOURCES) \
364 $(test_channel_request_SOURCES) $(test_cli_group_SOURCES) \
365 $(test_client_SOURCES) $(test_cm_SOURCES) \
366 $(test_connection_SOURCES) \
316367 $(test_connection_bug_18845_SOURCES) \
317368 $(test_connection_error_SOURCES) \
318369 $(test_connection_getinterfaces_failure_SOURCES) \
493544 $(top_builddir)/telepathy-glib/libtelepathy-glib.la \
494545 $(top_builddir)/tests/lib/libtp-glib-tests.la
495546
547 test_account_SOURCES = account.c
548 test_account_manager_SOURCES = account-manager.c
496549 test_call_cancellation_SOURCES = call-cancellation.c
550 test_channel_dispatcher_SOURCES = channel-dispatcher.c
551 test_channel_dispatch_operation_SOURCES = channel-dispatch-operation.c
497552 test_channel_introspect_SOURCES = channel-introspect.c
553 test_channel_request_SOURCES = channel-request.c
498554 test_callable_example_SOURCES = callable-example.c
499555 test_callable_example_LDADD = \
500556 $(LDADD) \
501557 $(top_builddir)/examples/cm/callable/libexample-cm-callable.la
502558
559 test_client_SOURCES = client.c
503560 test_cli_group_SOURCES = cli-group.c
504561 test_cm_SOURCES = cm.c
505562 test_cm_LDADD = \
641698 echo " rm -f $$p $$f"; \
642699 rm -f $$p $$f ; \
643700 done
701 test-account$(EXEEXT): $(test_account_OBJECTS) $(test_account_DEPENDENCIES)
702 @rm -f test-account$(EXEEXT)
703 $(LINK) $(test_account_LDFLAGS) $(test_account_OBJECTS) $(test_account_LDADD) $(LIBS)
704 test-account-manager$(EXEEXT): $(test_account_manager_OBJECTS) $(test_account_manager_DEPENDENCIES)
705 @rm -f test-account-manager$(EXEEXT)
706 $(LINK) $(test_account_manager_LDFLAGS) $(test_account_manager_OBJECTS) $(test_account_manager_LDADD) $(LIBS)
644707 test-call-cancellation$(EXEEXT): $(test_call_cancellation_OBJECTS) $(test_call_cancellation_DEPENDENCIES)
645708 @rm -f test-call-cancellation$(EXEEXT)
646709 $(LINK) $(test_call_cancellation_LDFLAGS) $(test_call_cancellation_OBJECTS) $(test_call_cancellation_LDADD) $(LIBS)
647710 test-callable-example$(EXEEXT): $(test_callable_example_OBJECTS) $(test_callable_example_DEPENDENCIES)
648711 @rm -f test-callable-example$(EXEEXT)
649712 $(LINK) $(test_callable_example_LDFLAGS) $(test_callable_example_OBJECTS) $(test_callable_example_LDADD) $(LIBS)
713 test-channel-dispatch-operation$(EXEEXT): $(test_channel_dispatch_operation_OBJECTS) $(test_channel_dispatch_operation_DEPENDENCIES)
714 @rm -f test-channel-dispatch-operation$(EXEEXT)
715 $(LINK) $(test_channel_dispatch_operation_LDFLAGS) $(test_channel_dispatch_operation_OBJECTS) $(test_channel_dispatch_operation_LDADD) $(LIBS)
716 test-channel-dispatcher$(EXEEXT): $(test_channel_dispatcher_OBJECTS) $(test_channel_dispatcher_DEPENDENCIES)
717 @rm -f test-channel-dispatcher$(EXEEXT)
718 $(LINK) $(test_channel_dispatcher_LDFLAGS) $(test_channel_dispatcher_OBJECTS) $(test_channel_dispatcher_LDADD) $(LIBS)
650719 test-channel-introspect$(EXEEXT): $(test_channel_introspect_OBJECTS) $(test_channel_introspect_DEPENDENCIES)
651720 @rm -f test-channel-introspect$(EXEEXT)
652721 $(LINK) $(test_channel_introspect_LDFLAGS) $(test_channel_introspect_OBJECTS) $(test_channel_introspect_LDADD) $(LIBS)
722 test-channel-request$(EXEEXT): $(test_channel_request_OBJECTS) $(test_channel_request_DEPENDENCIES)
723 @rm -f test-channel-request$(EXEEXT)
724 $(LINK) $(test_channel_request_LDFLAGS) $(test_channel_request_OBJECTS) $(test_channel_request_LDADD) $(LIBS)
653725 test-cli-group$(EXEEXT): $(test_cli_group_OBJECTS) $(test_cli_group_DEPENDENCIES)
654726 @rm -f test-cli-group$(EXEEXT)
655727 $(LINK) $(test_cli_group_LDFLAGS) $(test_cli_group_OBJECTS) $(test_cli_group_LDADD) $(LIBS)
728 test-client$(EXEEXT): $(test_client_OBJECTS) $(test_client_DEPENDENCIES)
729 @rm -f test-client$(EXEEXT)
730 $(LINK) $(test_client_LDFLAGS) $(test_client_OBJECTS) $(test_client_LDADD) $(LIBS)
656731 test-cm$(EXEEXT): $(test_cm_OBJECTS) $(test_cm_DEPENDENCIES)
657732 @rm -f test-cm$(EXEEXT)
658733 $(LINK) $(test_cm_LDFLAGS) $(test_cm_OBJECTS) $(test_cm_LDADD) $(LIBS)
741816 distclean-compile:
742817 -rm -f *.tab.c
743818
819 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/account-manager.Po@am__quote@
820 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/account.Po@am__quote@
744821 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/call-cancellation.Po@am__quote@
745822 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/callable-example.Po@am__quote@
823 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-dispatch-operation.Po@am__quote@
824 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-dispatcher.Po@am__quote@
746825 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-introspect.Po@am__quote@
826 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/channel-request.Po@am__quote@
747827 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/cli-group.Po@am__quote@
828 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/client.Po@am__quote@
748829 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/cm.Po@am__quote@
749830 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/connection-bug-18845.Po@am__quote@
750831 @AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/connection-error.Po@am__quote@
0 /* A very basic feature test for TpAccountManager
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/account-manager.h>
11 #include <telepathy-glib/debug.h>
12
13 typedef struct {
14 GMainLoop *mainloop;
15 TpDBusDaemon *dbus;
16
17 TpAccountManager *am;
18 GError *error /* initialized where needed */;
19 } Test;
20
21 static void
22 setup (Test *test,
23 gconstpointer data)
24 {
25 g_type_init ();
26 tp_debug_set_flags ("all");
27
28 test->mainloop = g_main_loop_new (NULL, FALSE);
29 test->dbus = tp_dbus_daemon_dup (NULL);
30 g_assert (test->dbus != NULL);
31
32 test->am = NULL;
33 }
34
35 static void
36 teardown (Test *test,
37 gconstpointer data)
38 {
39 if (test->am != NULL)
40 {
41 g_object_unref (test->am);
42 test->am = NULL;
43 }
44
45 g_object_unref (test->dbus);
46 test->dbus = NULL;
47 g_main_loop_unref (test->mainloop);
48 test->mainloop = NULL;
49 }
50
51 static void
52 test_new (Test *test,
53 gconstpointer data G_GNUC_UNUSED)
54 {
55 test->am = tp_account_manager_new (test->dbus);
56 }
57
58 int
59 main (int argc,
60 char **argv)
61 {
62 g_test_init (&argc, &argv, NULL);
63 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
64
65 g_test_add ("/am/new", Test, NULL, setup, test_new, teardown);
66
67 return g_test_run ();
68 }
0 /* A very basic feature test for TpAccount
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/account.h>
11 #include <telepathy-glib/debug.h>
12
13 typedef struct {
14 GMainLoop *mainloop;
15 TpDBusDaemon *dbus;
16
17 TpAccount *account;
18 GError *error /* initialized where needed */;
19 } Test;
20
21 static void
22 setup (Test *test,
23 gconstpointer data)
24 {
25 g_type_init ();
26 tp_debug_set_flags ("all");
27
28 test->mainloop = g_main_loop_new (NULL, FALSE);
29 test->dbus = tp_dbus_daemon_dup (NULL);
30 g_assert (test->dbus != NULL);
31
32 test->account = NULL;
33 }
34
35 static void
36 teardown (Test *test,
37 gconstpointer data)
38 {
39 if (test->account != NULL)
40 {
41 g_object_unref (test->account);
42 test->account = NULL;
43 }
44
45 g_object_unref (test->dbus);
46 test->dbus = NULL;
47 g_main_loop_unref (test->mainloop);
48 test->mainloop = NULL;
49 }
50
51 static void
52 test_new (Test *test,
53 gconstpointer data G_GNUC_UNUSED)
54 {
55 test->account = tp_account_new (test->dbus,
56 "/secretly/not/an/object", NULL);
57 g_assert (test->account == NULL);
58
59 test->account = tp_account_new (test->dbus,
60 "not even syntactically valid", NULL);
61 g_assert (test->account == NULL);
62
63 test->account = tp_account_new (test->dbus,
64 "/org/freedesktop/Telepathy/Account/whatever", NULL);
65 g_assert (test->account != NULL);
66 }
67
68 int
69 main (int argc,
70 char **argv)
71 {
72 g_test_init (&argc, &argv, NULL);
73 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
74
75 g_test_add ("/account/new", Test, NULL, setup, test_new, teardown);
76
77 return g_test_run ();
78 }
0 /* A very basic feature test for TpChannelDispatchOperation
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/channel-dispatch-operation.h>
11 #include <telepathy-glib/defs.h>
12 #include <telepathy-glib/debug.h>
13 #include <telepathy-glib/svc-channel-dispatch-operation.h>
14
15 #include <dbus/dbus.h>
16 #include <dbus/dbus-glib.h>
17 #include <dbus/dbus-glib-lowlevel.h>
18
19 #include "tests/lib/util.h"
20
21 /* This object implements no methods and no properties - TpChannelRequest
22 * doesn't actually use them yet */
23
24 static GType test_simple_cdo_get_type (void);
25
26 typedef struct {
27 GObject parent;
28 } TestSimpleCDO;
29
30 typedef struct {
31 GObjectClass parent;
32 } TestSimpleCDOClass;
33
34 G_DEFINE_TYPE_WITH_CODE (TestSimpleCDO, test_simple_cdo, G_TYPE_OBJECT,
35 G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CHANNEL_DISPATCH_OPERATION, NULL));
36
37 static void
38 test_simple_cdo_init (TestSimpleCDO *self)
39 {
40 }
41
42 static void
43 test_simple_cdo_class_init (TestSimpleCDOClass *klass)
44 {
45 }
46
47 typedef struct {
48 GMainLoop *mainloop;
49 TpDBusDaemon *dbus;
50
51 DBusGConnection *private_conn;
52 TpDBusDaemon *private_dbus;
53 GObject *cdo_service;
54
55 TpChannelDispatchOperation *cdo;
56 GError *error /* initialized where needed */;
57 } Test;
58
59 static void
60 setup (Test *test,
61 gconstpointer data)
62 {
63 DBusConnection *libdbus;
64
65 g_type_init ();
66 tp_debug_set_flags ("all");
67
68 test->mainloop = g_main_loop_new (NULL, FALSE);
69 test->dbus = tp_dbus_daemon_dup (NULL);
70 g_assert (test->dbus != NULL);
71
72 libdbus = dbus_bus_get_private (DBUS_BUS_STARTER, NULL);
73 g_assert (libdbus != NULL);
74 dbus_connection_setup_with_g_main (libdbus, NULL);
75 dbus_connection_set_exit_on_disconnect (libdbus, FALSE);
76 test->private_conn = dbus_connection_get_g_connection (libdbus);
77 /* transfer ref */
78 dbus_g_connection_ref (test->private_conn);
79 dbus_connection_unref (libdbus);
80 g_assert (test->private_conn != NULL);
81 test->private_dbus = tp_dbus_daemon_new (test->private_conn);
82 g_assert (test->private_dbus != NULL);
83
84 test->cdo = NULL;
85
86 test->cdo_service = g_object_new (test_simple_cdo_get_type (),
87 NULL);
88 dbus_g_connection_register_g_object (test->private_conn, "/whatever",
89 test->cdo_service);
90 }
91
92 static void
93 teardown (Test *test,
94 gconstpointer data)
95 {
96 if (test->cdo != NULL)
97 {
98 g_object_unref (test->cdo);
99 test->cdo = NULL;
100 }
101
102 tp_dbus_daemon_release_name (test->dbus, TP_CHANNEL_DISPATCHER_BUS_NAME,
103 NULL);
104
105 if (test->private_dbus != NULL)
106 {
107 tp_dbus_daemon_release_name (test->private_dbus,
108 TP_CHANNEL_DISPATCHER_BUS_NAME, NULL);
109
110 g_object_unref (test->private_dbus);
111 test->private_dbus = NULL;
112 }
113
114 #if 0
115 /* not leaking this object would crash dbus-glib (fd.o #5688) */
116 g_object_unref (test->cdo_service);
117 test->cdo_service = NULL;
118 #endif
119
120 if (test->private_conn != NULL)
121 {
122 dbus_connection_close (dbus_g_connection_get_connection (
123 test->private_conn));
124
125 dbus_g_connection_unref (test->private_conn);
126 test->private_conn = NULL;
127 }
128
129 g_object_unref (test->dbus);
130 test->dbus = NULL;
131 g_main_loop_unref (test->mainloop);
132 test->mainloop = NULL;
133 }
134
135 static void
136 test_new (Test *test,
137 gconstpointer data G_GNUC_UNUSED)
138 {
139 gboolean ok;
140
141 /* CD not running */
142 test->cdo = tp_channel_dispatch_operation_new (test->dbus,
143 "/whatever", NULL, NULL);
144 g_assert (test->cdo == NULL);
145
146 ok = tp_dbus_daemon_request_name (test->private_dbus,
147 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
148 g_assert (ok);
149
150 test->cdo = tp_channel_dispatch_operation_new (test->dbus,
151 "not even syntactically valid", NULL, NULL);
152 g_assert (test->cdo == NULL);
153
154 test->cdo = tp_channel_dispatch_operation_new (test->dbus,
155 "/whatever", NULL, NULL);
156 g_assert (test->cdo != NULL);
157 }
158
159 static void
160 test_crash (Test *test,
161 gconstpointer data G_GNUC_UNUSED)
162 {
163 gboolean ok;
164
165 ok = tp_dbus_daemon_request_name (test->private_dbus,
166 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
167 g_assert (ok);
168
169 test->cdo = tp_channel_dispatch_operation_new (test->dbus, "/whatever",
170 NULL, NULL);
171 g_assert (test->cdo != NULL);
172 g_assert (tp_proxy_get_invalidated (test->cdo) == NULL);
173
174 tp_dbus_daemon_release_name (test->private_dbus,
175 TP_CHANNEL_DISPATCHER_BUS_NAME, NULL);
176
177 test_proxy_run_until_dbus_queue_processed (test->cdo);
178
179 g_assert (tp_proxy_get_invalidated (test->cdo) == NULL);
180
181 dbus_connection_close (dbus_g_connection_get_connection (
182 test->private_conn));
183 dbus_g_connection_unref (test->private_conn);
184 test->private_conn = NULL;
185
186 test_proxy_run_until_dbus_queue_processed (test->cdo);
187
188 g_assert (tp_proxy_get_invalidated (test->cdo) != NULL);
189 g_assert (tp_proxy_get_invalidated (test->cdo)->domain == TP_DBUS_ERRORS);
190 g_assert (tp_proxy_get_invalidated (test->cdo)->code ==
191 TP_DBUS_ERROR_NAME_OWNER_LOST);
192 }
193
194 static void
195 test_finished (Test *test,
196 gconstpointer data G_GNUC_UNUSED)
197 {
198 gboolean ok;
199
200 ok = tp_dbus_daemon_request_name (test->private_dbus,
201 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
202 g_assert (ok);
203
204 test->cdo = tp_channel_dispatch_operation_new (test->dbus, "/whatever",
205 NULL, NULL);
206 g_assert (test->cdo != NULL);
207 g_assert (tp_proxy_get_invalidated (test->cdo) == NULL);
208
209 tp_svc_channel_dispatch_operation_emit_finished (test->cdo_service);
210
211 test_proxy_run_until_dbus_queue_processed (test->cdo);
212
213 g_assert (tp_proxy_get_invalidated (test->cdo) != NULL);
214 g_assert (tp_proxy_get_invalidated (test->cdo)->domain == TP_DBUS_ERRORS);
215 g_assert (tp_proxy_get_invalidated (test->cdo)->code ==
216 TP_DBUS_ERROR_OBJECT_REMOVED);
217 }
218
219 int
220 main (int argc,
221 char **argv)
222 {
223 g_test_init (&argc, &argv, NULL);
224 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
225
226 g_test_add ("/cdo/new", Test, NULL, setup, test_new, teardown);
227 g_test_add ("/cdo/crash", Test, NULL, setup, test_crash, teardown);
228 g_test_add ("/cdo/finished", Test, NULL, setup, test_finished, teardown);
229
230 return g_test_run ();
231 }
0 /* A very basic feature test for TpChannelDispatcher
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/channel-dispatcher.h>
11 #include <telepathy-glib/debug.h>
12
13 typedef struct {
14 GMainLoop *mainloop;
15 TpDBusDaemon *dbus;
16
17 TpChannelDispatcher *cd;
18 GError *error /* initialized where needed */;
19 } Test;
20
21 static void
22 setup (Test *test,
23 gconstpointer data)
24 {
25 g_type_init ();
26 tp_debug_set_flags ("all");
27
28 test->mainloop = g_main_loop_new (NULL, FALSE);
29 test->dbus = tp_dbus_daemon_dup (NULL);
30 g_assert (test->dbus != NULL);
31
32 test->cd = NULL;
33 }
34
35 static void
36 teardown (Test *test,
37 gconstpointer data)
38 {
39 if (test->cd != NULL)
40 {
41 g_object_unref (test->cd);
42 test->cd = NULL;
43 }
44
45 g_object_unref (test->dbus);
46 test->dbus = NULL;
47 g_main_loop_unref (test->mainloop);
48 test->mainloop = NULL;
49 }
50
51 static void
52 test_new (Test *test,
53 gconstpointer data G_GNUC_UNUSED)
54 {
55 test->cd = tp_channel_dispatcher_new (test->dbus);
56 g_assert (test->cd != NULL);
57 }
58
59 int
60 main (int argc,
61 char **argv)
62 {
63 g_test_init (&argc, &argv, NULL);
64 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
65
66 g_test_add ("/cd/new", Test, NULL, setup, test_new, teardown);
67
68 return g_test_run ();
69 }
0 /* A very basic feature test for TpChannelRequest
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/channel-request.h>
11 #include <telepathy-glib/defs.h>
12 #include <telepathy-glib/debug.h>
13 #include <telepathy-glib/svc-channel-request.h>
14
15 #include <dbus/dbus.h>
16 #include <dbus/dbus-glib.h>
17 #include <dbus/dbus-glib-lowlevel.h>
18
19 #include "tests/lib/util.h"
20
21 /* This object implements no methods and no properties - TpChannelRequest
22 * doesn't actually use them yet */
23
24 static GType test_simple_cr_get_type (void);
25
26 typedef struct {
27 GObject parent;
28 } TestSimpleCR;
29
30 typedef struct {
31 GObjectClass parent;
32 } TestSimpleCRClass;
33
34 G_DEFINE_TYPE_WITH_CODE (TestSimpleCR, test_simple_cr, G_TYPE_OBJECT,
35 G_IMPLEMENT_INTERFACE (TP_TYPE_SVC_CHANNEL_REQUEST, NULL));
36
37 static void
38 test_simple_cr_init (TestSimpleCR *self)
39 {
40 }
41
42 static void
43 test_simple_cr_class_init (TestSimpleCRClass *klass)
44 {
45 }
46
47 typedef struct {
48 GMainLoop *mainloop;
49 TpDBusDaemon *dbus;
50
51 DBusGConnection *private_conn;
52 TpDBusDaemon *private_dbus;
53 GObject *cr_service;
54
55 TpChannelRequest *cr;
56 GError *error /* initialized where needed */;
57
58 guint succeeded;
59 } Test;
60
61 static void
62 setup (Test *test,
63 gconstpointer data)
64 {
65 DBusConnection *libdbus;
66
67 g_type_init ();
68 tp_debug_set_flags ("all");
69
70 test->mainloop = g_main_loop_new (NULL, FALSE);
71 test->dbus = tp_dbus_daemon_dup (NULL);
72 g_assert (test->dbus != NULL);
73
74 libdbus = dbus_bus_get_private (DBUS_BUS_STARTER, NULL);
75 g_assert (libdbus != NULL);
76 dbus_connection_setup_with_g_main (libdbus, NULL);
77 dbus_connection_set_exit_on_disconnect (libdbus, FALSE);
78 test->private_conn = dbus_connection_get_g_connection (libdbus);
79 /* transfer ref */
80 dbus_g_connection_ref (test->private_conn);
81 dbus_connection_unref (libdbus);
82 g_assert (test->private_conn != NULL);
83 test->private_dbus = tp_dbus_daemon_new (test->private_conn);
84 g_assert (test->private_dbus != NULL);
85
86 test->cr = NULL;
87
88 test->cr_service = g_object_new (test_simple_cr_get_type (),
89 NULL);
90 dbus_g_connection_register_g_object (test->private_conn, "/whatever",
91 test->cr_service);
92 }
93
94 static void
95 teardown (Test *test,
96 gconstpointer data)
97 {
98 if (test->cr != NULL)
99 {
100 g_object_unref (test->cr);
101 test->cr = NULL;
102 }
103
104 if (test->private_dbus != NULL)
105 {
106 tp_dbus_daemon_release_name (test->private_dbus,
107 TP_CHANNEL_DISPATCHER_BUS_NAME, NULL);
108
109 g_object_unref (test->private_dbus);
110 test->private_dbus = NULL;
111 }
112
113 #if 0
114 /* not leaking this object would crash dbus-glib (fd.o #5688) */
115 g_object_unref (test->cr_service);
116 test->cr_service = NULL;
117 #endif
118
119 if (test->private_conn != NULL)
120 {
121 dbus_connection_close (dbus_g_connection_get_connection (
122 test->private_conn));
123
124 dbus_g_connection_unref (test->private_conn);
125 test->private_conn = NULL;
126 }
127
128 g_object_unref (test->dbus);
129 test->dbus = NULL;
130
131 g_main_loop_unref (test->mainloop);
132 test->mainloop = NULL;
133 }
134
135 static void
136 test_new (Test *test,
137 gconstpointer data G_GNUC_UNUSED)
138 {
139 gboolean ok;
140
141 /* CD not running */
142 test->cr = tp_channel_request_new (test->dbus,
143 "/whatever", NULL, NULL);
144 g_assert (test->cr == NULL);
145
146 ok = tp_dbus_daemon_request_name (test->private_dbus,
147 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
148 g_assert (ok);
149
150 test->cr = tp_channel_request_new (test->dbus,
151 "not even syntactically valid", NULL, NULL);
152 g_assert (test->cr == NULL);
153
154 test->cr = tp_channel_request_new (test->dbus, "/whatever", NULL, NULL);
155 g_assert (test->cr != NULL);
156 }
157
158 static void
159 test_crash (Test *test,
160 gconstpointer data G_GNUC_UNUSED)
161 {
162 gboolean ok;
163
164 ok = tp_dbus_daemon_request_name (test->private_dbus,
165 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
166 g_assert (ok);
167
168 test->cr = tp_channel_request_new (test->dbus, "/whatever", NULL, NULL);
169 g_assert (test->cr != NULL);
170 g_assert (tp_proxy_get_invalidated (test->cr) == NULL);
171
172 tp_dbus_daemon_release_name (test->private_dbus,
173 TP_CHANNEL_DISPATCHER_BUS_NAME, NULL);
174
175 test_proxy_run_until_dbus_queue_processed (test->cr);
176
177 g_assert (tp_proxy_get_invalidated (test->cr) == NULL);
178
179 dbus_connection_close (dbus_g_connection_get_connection (
180 test->private_conn));
181 dbus_g_connection_unref (test->private_conn);
182 test->private_conn = NULL;
183
184 test_proxy_run_until_dbus_queue_processed (test->cr);
185
186 g_assert (tp_proxy_get_invalidated (test->cr) != NULL);
187 g_assert (tp_proxy_get_invalidated (test->cr)->domain == TP_DBUS_ERRORS);
188 g_assert (tp_proxy_get_invalidated (test->cr)->code ==
189 TP_DBUS_ERROR_NAME_OWNER_LOST);
190 }
191
192 static void
193 succeeded_cb (Test *test)
194 {
195 test->succeeded++;
196 }
197
198 static void
199 test_succeeded (Test *test,
200 gconstpointer data G_GNUC_UNUSED)
201 {
202 gboolean ok;
203
204 ok = tp_dbus_daemon_request_name (test->private_dbus,
205 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
206 g_assert (ok);
207
208 test->cr = tp_channel_request_new (test->dbus, "/whatever", NULL, NULL);
209 g_assert (test->cr != NULL);
210 g_assert (tp_proxy_get_invalidated (test->cr) == NULL);
211
212 g_signal_connect_swapped (test->cr, "succeeded", G_CALLBACK (succeeded_cb),
213 test);
214
215 tp_svc_channel_request_emit_succeeded (test->cr_service);
216
217 test_proxy_run_until_dbus_queue_processed (test->cr);
218
219 g_assert (tp_proxy_get_invalidated (test->cr) != NULL);
220 g_assert (tp_proxy_get_invalidated (test->cr)->domain == TP_DBUS_ERRORS);
221 g_assert (tp_proxy_get_invalidated (test->cr)->code ==
222 TP_DBUS_ERROR_OBJECT_REMOVED);
223 g_assert_cmpuint (test->succeeded, ==, 1);
224
225 g_signal_handlers_disconnect_by_func (test->cr, G_CALLBACK (succeeded_cb),
226 test);
227 }
228
229 static void
230 test_failed (Test *test,
231 gconstpointer data G_GNUC_UNUSED)
232 {
233 gboolean ok;
234
235 ok = tp_dbus_daemon_request_name (test->private_dbus,
236 TP_CHANNEL_DISPATCHER_BUS_NAME, FALSE, NULL);
237 g_assert (ok);
238
239 test->cr = tp_channel_request_new (test->dbus, "/whatever", NULL, NULL);
240 g_assert (test->cr != NULL);
241 g_assert (tp_proxy_get_invalidated (test->cr) == NULL);
242
243 g_signal_connect_swapped (test->cr, "succeeded", G_CALLBACK (succeeded_cb),
244 test);
245
246 tp_svc_channel_request_emit_failed (test->cr_service,
247 TP_ERROR_STR_NOT_YOURS, "lalala");
248
249 test_proxy_run_until_dbus_queue_processed (test->cr);
250
251 g_assert (tp_proxy_get_invalidated (test->cr) != NULL);
252 g_assert (tp_proxy_get_invalidated (test->cr)->domain == TP_ERRORS);
253 g_assert (tp_proxy_get_invalidated (test->cr)->code == TP_ERROR_NOT_YOURS);
254 g_assert_cmpstr (tp_proxy_get_invalidated (test->cr)->message, ==,
255 "lalala");
256 g_assert_cmpuint (test->succeeded, ==, 0);
257
258 g_signal_handlers_disconnect_by_func (test->cr, G_CALLBACK (succeeded_cb),
259 test);
260 }
261
262 int
263 main (int argc,
264 char **argv)
265 {
266 g_test_init (&argc, &argv, NULL);
267 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
268
269 g_test_add ("/cr/new", Test, NULL, setup, test_new, teardown);
270 g_test_add ("/cr/crash", Test, NULL, setup, test_crash, teardown);
271 g_test_add ("/cr/succeeded", Test, NULL, setup, test_succeeded, teardown);
272 g_test_add ("/cr/failed", Test, NULL, setup, test_failed, teardown);
273
274 return g_test_run ();
275 }
0 /* A very basic feature test for TpClient
1 *
2 * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
3 * Copyright (C) 2009 Nokia Corporation
4 *
5 * Copying and distribution of this file, with or without modification,
6 * are permitted in any medium without royalty provided the copyright
7 * notice and this notice are preserved.
8 */
9
10 #include <telepathy-glib/client.h>
11 #include <telepathy-glib/debug.h>
12
13 typedef struct {
14 GMainLoop *mainloop;
15 TpDBusDaemon *dbus;
16
17 TpClient *client;
18 GError *error /* initialized where needed */;
19 } Test;
20
21 static void
22 setup (Test *test,
23 gconstpointer data)
24 {
25 g_type_init ();
26 tp_debug_set_flags ("all");
27
28 test->mainloop = g_main_loop_new (NULL, FALSE);
29 test->dbus = tp_dbus_daemon_dup (NULL);
30 g_assert (test->dbus != NULL);
31
32 test->client = NULL;
33 }
34
35 static void
36 teardown (Test *test,
37 gconstpointer data)
38 {
39 if (test->client != NULL)
40 {
41 g_object_unref (test->client);
42 test->client = NULL;
43 }
44
45 g_object_unref (test->dbus);
46 test->dbus = NULL;
47 g_main_loop_unref (test->mainloop);
48 test->mainloop = NULL;
49 }
50
51 static void
52 test_new (Test *test,
53 gconstpointer data G_GNUC_UNUSED)
54 {
55 test->client = g_object_new (TP_TYPE_CLIENT,
56 "dbus-daemon", test->dbus,
57 "object-path", "/org/freedesktop/Telepathy/Client/whatever",
58 "bus-name", "org.freedesktop.Telepathy.Client.whatever",
59 NULL);
60 g_assert (test->client != NULL);
61 }
62
63 int
64 main (int argc,
65 char **argv)
66 {
67 g_test_init (&argc, &argv, NULL);
68 g_test_bug_base ("http://bugs.freedesktop.org/show_bug.cgi?id=");
69
70 g_test_add ("/client/new", Test, NULL, setup, test_new, teardown);
71
72 return g_test_run ();
73 }
563563 g_assert_cmpstr (strv[0], ==, "");
564564 g_assert (strv[1] == NULL);
565565
566 param = &protocol->params[19];
567 g_assert_cmpstr (param->name, ==, "true");
568 g_assert_cmpuint (param->flags, ==, TP_CONN_MGR_PARAM_FLAG_HAS_DEFAULT);
569 g_assert_cmpstr (param->dbus_signature, ==, "b");
570 g_assert (G_VALUE_HOLDS_BOOLEAN (&param->default_value));
571 g_assert_cmpint (g_value_get_boolean (&param->default_value), ==, TRUE);
572
573 param = &protocol->params[20];
574 g_assert_cmpstr (param->name, ==, "false");
575 g_assert_cmpuint (param->flags, ==, TP_CONN_MGR_PARAM_FLAG_HAS_DEFAULT);
576 g_assert_cmpstr (param->dbus_signature, ==, "b");
577 g_assert (G_VALUE_HOLDS_BOOLEAN (&param->default_value));
578 g_assert_cmpint (g_value_get_boolean (&param->default_value), ==, FALSE);
579
580 param = &protocol->params[21];
581 g_assert_cmpstr (param->name, ==, "y");
582 g_assert_cmpuint (param->flags, ==, TP_CONN_MGR_PARAM_FLAG_HAS_DEFAULT);
583 g_assert_cmpstr (param->dbus_signature, ==, "y");
584 g_assert (G_VALUE_HOLDS_UCHAR (&param->default_value));
585 g_assert_cmpint (g_value_get_uchar (&param->default_value), ==, 42);
586
587 param = &protocol->params[22];
588 g_assert (param->name == NULL);
566589 }
567590
568591 static void
8383 # the value is [""]
8484 param-empty-string-in-list = as
8585 default-empty-string-in-list = ;
86
87 param-true = b
88 default-true = true
89 param-false = b
90 default-false = false
91 param-y = y
92 default-y = 42
88 */
99
1010 #include "tests/lib/util.h"
11
12 void
13 test_proxy_run_until_dbus_queue_processed (gpointer proxy)
14 {
15 tp_cli_dbus_introspectable_run_introspect (proxy, -1, NULL, NULL, NULL);
16 }
1117
1218 void
1319 test_connection_run_until_dbus_queue_processed (TpConnection *connection)
1010 #ifndef TEST_LIB_UTIL_H
1111 #define TEST_LIB_UTIL_H
1212
13 #include <telepathy-glib/proxy.h>
1314 #include <telepathy-glib/connection.h>
15
16 void test_proxy_run_until_dbus_queue_processed (gpointer proxy);
1417
1518 void test_connection_run_until_dbus_queue_processed (TpConnection *connection);
1619
1414 check-misc.sh \
1515 check-whitespace.sh \
1616 doc-generator.xsl \
17 flymake.mk \
1718 git-which-branch.sh \
1819 glib-client-gen.py \
1920 glib-client-marshaller-gen.py \
219219 check-misc.sh \
220220 check-whitespace.sh \
221221 doc-generator.xsl \
222 flymake.mk \
222223 git-which-branch.sh \
223224 glib-client-gen.py \
224225 glib-client-marshaller-gen.py \
0 check-syntax:
1 $(CC) $(AM_CPPFLAGS) $(AM_CFLAGS) -fsyntax-only $(CHK_SOURCES)
2
3 .PHONY: check-syntax
5454 % opts.get('--subclass', 'TpProxy'))
5555 if self.proxy_arg == 'void *':
5656 self.proxy_arg = 'gpointer '
57 self.generate_reentrant = ('--generate-reentrant' in opts or
58 '--deprecate-reentrant' in opts)
59 self.deprecate_reentrant = opts.get('--deprecate-reentrant', None)
5760
5861 def h(self, s):
5962 if isinstance(s, unicode):
800803 self.b('}')
801804 self.b('')
802805
806 if self.generate_reentrant:
807 self.do_method_reentrant(method, iface_lc, member, member_lc,
808 in_args, out_args, collect_callback)
809
810 # leave a gap for the end of the method
811 self.b('')
812 self.h('')
813
814 def do_method_reentrant(self, method, iface_lc, member, member_lc, in_args,
815 out_args, collect_callback):
803816 # Reentrant blocking calls
804817 # Example:
805818 # gboolean tp_cli_properties_interface_run_get_properties
883896
884897 self.b('}')
885898 self.b('')
899
900 if self.deprecate_reentrant:
901 self.h('#ifndef %s' % self.deprecate_reentrant)
886902
887903 self.h('gboolean %s_%s_run_%s (%sproxy,'
888904 % (self.prefix_lc, iface_lc, member_lc, self.proxy_arg))
947963 self.b(' %s*%s,' % (ctype, name))
948964
949965 self.h(' GError **error,')
950 self.h(' GMainLoop **loop);')
966
967 if self.deprecate_reentrant:
968 self.h(' GMainLoop **loop) G_GNUC_DEPRECATED;')
969 self.h('#endif /* not %s */' % self.deprecate_reentrant)
970 else:
971 self.h(' GMainLoop **loop);')
972
951973 self.h('')
952974
953975 self.b(' GError **error,')
10181040 self.b(' return state.success;')
10191041 self.b('}')
10201042 self.b('')
1021
1022 # leave a gap for the end of the method
1023 self.b('')
1024 self.h('')
10251043
10261044 def do_signal_add(self, signal):
10271045 marshaller_items = []
11521170 if __name__ == '__main__':
11531171 options, argv = gnu_getopt(sys.argv[1:], '',
11541172 ['group=', 'subclass=', 'subclass-assert=',
1155 'iface-quark-prefix=', 'tp-proxy-api='])
1173 'iface-quark-prefix=', 'tp-proxy-api=',
1174 'generate-reentrant', 'deprecate-reentrant='])
11561175
11571176 opts = {}
11581177
5050 self.b(' case TP_ERROR_%s:' % uc_nick)
5151 self.b(' return %s;' % name)
5252
53 self.h('')
54 self.h("/* Work around a gtkdoc bug where it doesn't see the last")
55 self.h(" * definition in the file unless there's misc after it")
56 self.h(" */")
57
5853 self.b(' default:')
5954 self.b(' g_return_val_if_reached (NULL);')
6055 self.b(' }')
6156 self.b('}')
57
58 # make both files end with a newline
59 self.h('')
60 self.b('')
6261
6362 open(self.basename + '.h', 'w').write('\n'.join(self.__header))
6463 open(self.basename + '.c', 'w').write('\n'.join(self.__body))