~ubuntu-branches/ubuntu/wily/telepathy-glib/wily
» Revision
1.5.1
: docs/reference/html/telepathy-glib-account-manager.html
« back to all changes in this revision
Viewing changes to docs/reference/html/telepathy-glib-account-manager.html
- browse files at revision 1.5.1
- compare with another revision
- download diff
- download tarball
- view history from revision 1.5.1
- Committer: Bazaar Package Importer
- Author(s): Simon McVittie
- Date: 2009-09-28 16:45:32 UTC
- mfrom: (1.4.5 upstream)
- mto: (27.1.1 sid) (1.6.1 upstream) (35.2.1 experimental) (26.1.1 squeeze)
- mto: This revision was merged to the branch mainline in revision 23.
- Revision ID: james.westby@ubuntu.com-20090928164532-4iqqcn9rlbq83pry
Tags: upstream-0.9.0
Import upstream version 0.9.0
- files added:
- docs/reference/xml/api-index-0.9.0.xml
- files removed:
- m4/shave.m4
- files modified:
- ChangeLog
added
removed
docs/reference/html/telepathy-glib-account-manager.html
33
33
<a href="#telepathy-glib-account-manager.description" class="shortcut">Description</a>
34
34
|
35
35
<a href="#telepathy-glib-account-manager.object-hierarchy" class="shortcut">Object Hierarchy</a>
36
|
37
<a href="#telepathy-glib-account-manager.signals" class="shortcut">Signals</a>
36
38
</td></tr>
37
39
</table>
38
40
<div class="refentry" title="TpAccountManager">
55
57
<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);
56
58
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>
57
59
(void);
60
<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-dup" title="tp_account_manager_dup ()">tp_account_manager_dup</a> (void);
61
void <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-create-account-async" title="tp_account_manager_create_account_async ()">tp_account_manager_create_account_async</a>
62
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
63
const <a
64
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
65
>gchar</a> *connection_manager,
66
const <a
67
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
68
>gchar</a> *protocol,
69
const <a
70
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
71
>gchar</a> *display_name,
72
<a
73
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
74
>GHashTable</a> *parameters,
75
<a
76
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
77
>GHashTable</a> *properties,
78
<a
79
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
80
>GAsyncReadyCallback</a> callback,
81
<a
82
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
83
>gpointer</a> user_data);
84
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-create-account-finish" title="tp_account_manager_create_account_finish ()">tp_account_manager_create_account_finish</a>
85
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
86
<a
87
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
88
>GAsyncResult</a> *result,
89
<a
90
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
91
>GError</a> **error);
92
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-ensure-account" title="tp_account_manager_ensure_account ()">tp_account_manager_ensure_account</a> (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
93
const <a
94
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
95
>gchar</a> *path);
96
<a
97
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
98
>GList</a> * <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-get-valid-accounts" title="tp_account_manager_get_valid_accounts ()">tp_account_manager_get_valid_accounts</a>
99
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager);
100
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-get-most-available-presence" title="tp_account_manager_get_most_available_presence ()">tp_account_manager_get_most_available_presence</a>
101
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
102
<a
103
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
104
>gchar</a> **status,
105
<a
106
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
107
>gchar</a> **message);
108
void <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-set-all-requested-presences" title="tp_account_manager_set_all_requested_presences ()">tp_account_manager_set_all_requested_presences</a>
109
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
110
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> type,
111
const <a
112
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
113
>gchar</a> *status,
114
const <a
115
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
116
>gchar</a> *message);
117
void <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-enable-restart" title="tp_account_manager_enable_restart ()">tp_account_manager_enable_restart</a> (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager);
118
119
#define <a class="link" href="telepathy-glib-account-manager.html#TP-ACCOUNT-MANAGER-FEATURE-CORE--CAPS" title="TP_ACCOUNT_MANAGER_FEATURE_CORE">TP_ACCOUNT_MANAGER_FEATURE_CORE</a>
120
<a
121
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
122
>gboolean</a> <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-is-prepared" title="tp_account_manager_is_prepared ()">tp_account_manager_is_prepared</a> (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
123
<a
124
href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"
125
>GQuark</a> feature);
126
void <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-async" title="tp_account_manager_prepare_async ()">tp_account_manager_prepare_async</a> (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
127
const <a
128
href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"
129
>GQuark</a> *features,
130
<a
131
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
132
>GAsyncReadyCallback</a> callback,
133
<a
134
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
135
>gpointer</a> user_data);
136
<a
137
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
138
>gboolean</a> <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-finish" title="tp_account_manager_prepare_finish ()">tp_account_manager_prepare_finish</a> (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
139
<a
140
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
141
>GAsyncResult</a> *result,
142
<a
143
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
144
>GError</a> **error);
145
58
146
59
147
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>)
60
148
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *proxy,
167
255
+----TpAccountManager
168
256
</pre>
169
257
</div>
258
<div class="refsect1" title="Signals">
259
<a name="telepathy-glib-account-manager.signals"></a><h2>Signals</h2>
260
<pre class="synopsis">
261
"<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-account-disabled" title='The "account-disabled" signal'>account-disabled</a>" : Run Last
262
"<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-account-enabled" title='The "account-enabled" signal'>account-enabled</a>" : Run Last
263
"<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-account-removed" title='The "account-removed" signal'>account-removed</a>" : Run Last
264
"<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-account-validity-changed" title='The "account-validity-changed" signal'>account-validity-changed</a>" : Run Last
265
"<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager-most-available-presence-changed" title='The "most-available-presence-changed" signal'>most-available-presence-changed</a>" : Run Last
266
</pre>
267
</div>
170
268
<div class="refsect1" title="Description">
171
269
<a name="telepathy-glib-account-manager.description"></a><h2>Description</h2>
172
270
<p>
183
281
<p>
184
282
The Telepathy Account Manager stores real-time communication accounts and
185
283
their configuration, places accounts online on request, and manipulates
186
accounts' presence, nicknames and avatars.
187
</p>
188
<p>
189
This proxy is usable but incomplete: GObject signals and accessors for the
190
D-Bus properties will be added in a later version of telepathy-glib, along
191
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>.
192
</p>
193
<p>
194
Until suitable convenience methods are implemented, the generic
195
<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
196
properties.</p>
284
accounts' presence, nicknames and avatars.</p>
197
285
<p>
198
286
</p>
199
287
<p class="since">Since 0.7.32</p>
214
302
<a name="tp-account-manager-new"></a><h3>tp_account_manager_new ()</h3>
215
303
<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>
216
304
<p>
217
Convenience function to create a new account manager proxy.</p>
305
Convenience function to create a new account manager proxy. The returned
306
<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> is not guaranteed to be ready on return.
307
</p>
308
<p>
309
Use <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-dup" title="tp_account_manager_dup ()"><code class="function">tp_account_manager_dup()</code></a> instead if you want an account manager proxy
310
on the starter or session bus (which is almost always the right thing for
311
Telepathy).</p>
218
312
<p>
219
313
</p>
220
314
<div class="variablelist"><table border="0">
250
344
<p class="since">Since 0.7.32</p>
251
345
</div>
252
346
<hr>
347
<div class="refsect2" title="tp_account_manager_dup ()">
348
<a name="tp-account-manager-dup"></a><h3>tp_account_manager_dup ()</h3>
349
<pre class="programlisting"><a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> * tp_account_manager_dup (void);</pre>
350
<p>
351
Returns an account manager proxy on the D-Bus daemon on which this
352
process was activated (if it was launched by D-Bus service activation), or
353
the session bus (otherwise).
354
</p>
355
<p>
356
The returned <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> is cached; the same <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> object
357
will be returned by this function repeatedly, as long as at least one
358
reference exists. Note that the returned <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> is not guaranteed
359
to be ready on return.</p>
360
<p>
361
</p>
362
<div class="variablelist"><table border="0">
363
<col align="left" valign="top">
364
<tbody><tr>
365
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
366
<td> an account manager proxy on the starter or session bus, or <a
367
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
368
><code class="literal">NULL</code></a>
369
if it wasn't possible to get a dbus daemon proxy for the
370
appropriate bus
371
372
</td>
373
</tr></tbody>
374
</table></div>
375
<p class="since">Since 0.9.0</p>
376
</div>
377
<hr>
378
<div class="refsect2" title="tp_account_manager_create_account_async ()">
379
<a name="tp-account-manager-create-account-async"></a><h3>tp_account_manager_create_account_async ()</h3>
380
<pre class="programlisting">void tp_account_manager_create_account_async
381
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
382
const <a
383
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
384
>gchar</a> *connection_manager,
385
const <a
386
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
387
>gchar</a> *protocol,
388
const <a
389
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
390
>gchar</a> *display_name,
391
<a
392
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
393
>GHashTable</a> *parameters,
394
<a
395
href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"
396
>GHashTable</a> *properties,
397
<a
398
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
399
>GAsyncReadyCallback</a> callback,
400
<a
401
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
402
>gpointer</a> user_data);</pre>
403
<p>
404
Requests an asynchronous create of an account on the account manager
405
<em class="parameter"><code>manager</code></em>. When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can
406
then call <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-create-account-finish" title="tp_account_manager_create_account_finish ()"><code class="function">tp_account_manager_create_account_finish()</code></a> to get the result of
407
the operation.
408
</p>
409
<p>
410
<em class="parameter"><code>callback</code></em> will only be called when the newly created <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> has the
411
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CORE--CAPS" title="TP_ACCOUNT_FEATURE_CORE"><code class="literal">TP_ACCOUNT_FEATURE_CORE</code></a> feature ready on it, so when calling
412
<a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-create-account-finish" title="tp_account_manager_create_account_finish ()"><code class="function">tp_account_manager_create_account_finish()</code></a>, one can guarantee this feature
413
will be ready.</p>
414
<p>
415
</p>
416
<div class="variablelist"><table border="0">
417
<col align="left" valign="top">
418
<tbody>
419
<tr>
420
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
421
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
422
</td>
423
</tr>
424
<tr>
425
<td><p><span class="term"><em class="parameter"><code>connection_manager</code></em> :</span></p></td>
426
<td> the name of a connection manager
427
</td>
428
</tr>
429
<tr>
430
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
431
<td> the name of a protocol
432
</td>
433
</tr>
434
<tr>
435
<td><p><span class="term"><em class="parameter"><code>display_name</code></em> :</span></p></td>
436
<td> the display name for the account
437
</td>
438
</tr>
439
<tr>
440
<td><p><span class="term"><em class="parameter"><code>parameters</code></em> :</span></p></td>
441
<td> parameters for the new account
442
</td>
443
</tr>
444
<tr>
445
<td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
446
<td> properties for the new account
447
</td>
448
</tr>
449
<tr>
450
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
451
<td> a callback to call when the request is satisfied
452
</td>
453
</tr>
454
<tr>
455
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
456
<td> data to pass to <em class="parameter"><code>callback</code></em>
457
</td>
458
</tr>
459
</tbody>
460
</table></div>
461
<p class="since">Since 0.9.0</p>
462
</div>
463
<hr>
464
<div class="refsect2" title="tp_account_manager_create_account_finish ()">
465
<a name="tp-account-manager-create-account-finish"></a><h3>tp_account_manager_create_account_finish ()</h3>
466
<pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * tp_account_manager_create_account_finish
467
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
468
<a
469
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
470
>GAsyncResult</a> *result,
471
<a
472
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
473
>GError</a> **error);</pre>
474
<p>
475
Finishes an async create account operation, and returns a new <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
476
object, with the <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CORE--CAPS" title="TP_ACCOUNT_FEATURE_CORE"><code class="literal">TP_ACCOUNT_FEATURE_CORE</code></a> feature ready on it.</p>
477
<p>
478
</p>
479
<div class="variablelist"><table border="0">
480
<col align="left" valign="top">
481
<tbody>
482
<tr>
483
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
484
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
485
</td>
486
</tr>
487
<tr>
488
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
489
<td> a <a
490
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
491
><span class="type">GAsyncResult</span></a>
492
</td>
493
</tr>
494
<tr>
495
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
496
<td> a <a
497
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
498
><span class="type">GError</span></a> to be filled
499
</td>
500
</tr>
501
<tr>
502
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
503
<td> a new <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> which was just created on success, otherwise
504
<a
505
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
506
><code class="literal">NULL</code></a>
507
508
</td>
509
</tr>
510
</tbody>
511
</table></div>
512
<p class="since">Since 0.9.0</p>
513
</div>
514
<hr>
515
<div class="refsect2" title="tp_account_manager_ensure_account ()">
516
<a name="tp-account-manager-ensure-account"></a><h3>tp_account_manager_ensure_account ()</h3>
517
<pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> * tp_account_manager_ensure_account (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
518
const <a
519
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
520
>gchar</a> *path);</pre>
521
<p>
522
Lookup an account in the account manager <em class="parameter"><code>manager</code></em>. If the desired account
523
has already been ensured then the same object will be returned, otherwise
524
it will create a new <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> and add it to <em class="parameter"><code>manager</code></em>. As a result, if
525
<em class="parameter"><code>manager</code></em> thinks that the account doesn't exist, this will still add it to
526
<em class="parameter"><code>manager</code></em> to avoid races. Note that the returned <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> is not guaranteed
527
to be ready on return.
528
</p>
529
<p>
530
The caller must keep a ref to the returned object using <a
531
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
532
><code class="function">g_object_ref()</code></a> if
533
it is to be kept.</p>
534
<p>
535
</p>
536
<div class="variablelist"><table border="0">
537
<col align="left" valign="top">
538
<tbody>
539
<tr>
540
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
541
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
542
</td>
543
</tr>
544
<tr>
545
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
546
<td> the object path for an account
547
</td>
548
</tr>
549
<tr>
550
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
551
<td> a new <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> at <em class="parameter"><code>path</code></em>
552
553
</td>
554
</tr>
555
</tbody>
556
</table></div>
557
<p class="since">Since 0.9.0</p>
558
</div>
559
<hr>
560
<div class="refsect2" title="tp_account_manager_get_valid_accounts ()">
561
<a name="tp-account-manager-get-valid-accounts"></a><h3>tp_account_manager_get_valid_accounts ()</h3>
562
<pre class="programlisting"><a
563
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
564
>GList</a> * tp_account_manager_get_valid_accounts
565
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager);</pre>
566
<p>
567
Returns a newly allocated <a
568
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
569
><span class="type">GList</span></a> of valid accounts in <em class="parameter"><code>manager</code></em>. The list
570
must be freed with <a
571
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"
572
><code class="function">g_list_free()</code></a> after used. None of the accounts in the
573
returned list are guaranteed to be ready.
574
</p>
575
<p>
576
Note that the <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>s in the returned <a
577
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
578
><span class="type">GList</span></a> are not reffed
579
before returning from this function. One could ref every item in the list
580
like the following example:
581
</p>
582
<div class="informalexample"><pre class="programlisting">
583
GList *accounts;
584
account = tp_account_manager_get_valid_accounts (manager);
585
g_list_foreach (accounts, (GFunc) g_object_ref, NULL);
586
</pre></div>
587
<p>
588
</p>
589
<p>
590
The list of valid accounts returned is not guaranteed to have been retrieved
591
until <a class="link" href="telepathy-glib-account-manager.html#TP-ACCOUNT-MANAGER-FEATURE-CORE--CAPS" title="TP_ACCOUNT_MANAGER_FEATURE_CORE"><code class="literal">TP_ACCOUNT_MANAGER_FEATURE_CORE</code></a> is prepared
592
(<a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-async" title="tp_account_manager_prepare_async ()"><code class="function">tp_account_manager_prepare_async()</code></a> has returned). Until this feature has
593
been prepared, an empty list (<a
594
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
595
><code class="literal">NULL</code></a>) will be returned.</p>
596
<p>
597
</p>
598
<div class="variablelist"><table border="0">
599
<col align="left" valign="top">
600
<tbody>
601
<tr>
602
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
603
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
604
</td>
605
</tr>
606
<tr>
607
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
608
<td> a newly allocated <a
609
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
610
><span class="type">GList</span></a> of valid accounts in <em class="parameter"><code>manager</code></em>
611
612
</td>
613
</tr>
614
</tbody>
615
</table></div>
616
<p class="since">Since 0.9.0</p>
617
</div>
618
<hr>
619
<div class="refsect2" title="tp_account_manager_get_most_available_presence ()">
620
<a name="tp-account-manager-get-most-available-presence"></a><h3>tp_account_manager_get_most_available_presence ()</h3>
621
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> tp_account_manager_get_most_available_presence
622
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
623
<a
624
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
625
>gchar</a> **status,
626
<a
627
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
628
>gchar</a> **message);</pre>
629
<p>
630
Gets the most available presence over all accounts in <em class="parameter"><code>manager</code></em>. This
631
function does not average presences across all accounts, but it merely
632
finds the "most available" presence. As a result, there is a guarantee
633
that there exists at least one account in <em class="parameter"><code>manager</code></em> with the returned
634
presence.
635
</p>
636
<p>
637
If no accounts are enabled or valid the output will be
638
(<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-PRESENCE-TYPE-OFFLINE--CAPS"><code class="literal">TP_CONNECTION_PRESENCE_TYPE_OFFLINE</code></a>, "offline", "").
639
</p>
640
<p>
641
The return value of this function is not guaranteed to have been retrieved
642
until <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-async" title="tp_account_manager_prepare_async ()"><code class="function">tp_account_manager_prepare_async()</code></a> has finished; until then, the
643
value will be the same as if no accounts are enabled or valid.</p>
644
<p>
645
</p>
646
<div class="variablelist"><table border="0">
647
<col align="left" valign="top">
648
<tbody>
649
<tr>
650
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
651
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
652
</td>
653
</tr>
654
<tr>
655
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
656
<td> a string to fill with the actual status
657
</td>
658
</tr>
659
<tr>
660
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
661
<td> a string to fill with the actual status message
662
</td>
663
</tr>
664
<tr>
665
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
666
<td> the most available presence across all accounts
667
668
</td>
669
</tr>
670
</tbody>
671
</table></div>
672
<p class="since">Since 0.9.0</p>
673
</div>
674
<hr>
675
<div class="refsect2" title="tp_account_manager_set_all_requested_presences ()">
676
<a name="tp-account-manager-set-all-requested-presences"></a><h3>tp_account_manager_set_all_requested_presences ()</h3>
677
<pre class="programlisting">void tp_account_manager_set_all_requested_presences
678
(<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
679
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType">TpConnectionPresenceType</a> type,
680
const <a
681
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
682
>gchar</a> *status,
683
const <a
684
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
685
>gchar</a> *message);</pre>
686
<p>
687
Iterates through the accounts in <em class="parameter"><code>manager</code></em> and requests the presence
688
(<em class="parameter"><code>type</code></em>, <em class="parameter"><code>status</code></em> and <em class="parameter"><code>message</code></em>). Note that the presence requested here is
689
merely a request, and if might not be satisfiable.
690
</p>
691
<p>
692
You can find the most available presence across all accounts by calling
693
<a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-get-most-available-presence" title="tp_account_manager_get_most_available_presence ()"><code class="function">tp_account_manager_get_most_available_presence()</code></a>.
694
</p>
695
<p>
696
Setting a requested presence on all accounts will have no effect
697
until <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-async" title="tp_account_manager_prepare_async ()"><code class="function">tp_account_manager_prepare_async()</code></a> has finished.</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>manager</code></em> :</span></p></td>
705
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
706
</td>
707
</tr>
708
<tr>
709
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
710
<td> a presence type to request
711
</td>
712
</tr>
713
<tr>
714
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
715
<td> a status to request
716
</td>
717
</tr>
718
<tr>
719
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
720
<td> a status message to request
721
</td>
722
</tr>
723
</tbody>
724
</table></div>
725
<p class="since">Since 0.9.0</p>
726
</div>
727
<hr>
728
<div class="refsect2" title="tp_account_manager_enable_restart ()">
729
<a name="tp-account-manager-enable-restart"></a><h3>tp_account_manager_enable_restart ()</h3>
730
<pre class="programlisting">void tp_account_manager_enable_restart (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager);</pre>
731
<p>
732
Enable autostarting the account manager D-Bus service. This means
733
that the account manager will be restarted if it disappears from
734
the bus.</p>
735
<p>
736
</p>
737
<div class="variablelist"><table border="0">
738
<col align="left" valign="top">
739
<tbody><tr>
740
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
741
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
742
</td>
743
</tr></tbody>
744
</table></div>
745
</div>
746
<hr>
747
<div class="refsect2" title="TP_ACCOUNT_MANAGER_FEATURE_CORE">
748
<a name="TP-ACCOUNT-MANAGER-FEATURE-CORE--CAPS"></a><h3>TP_ACCOUNT_MANAGER_FEATURE_CORE</h3>
749
<pre class="programlisting">#define TP_ACCOUNT_MANAGER_FEATURE_CORE</pre>
750
<p>
751
Expands to a call to a function that returns a quark for the "core" feature
752
on a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>.
753
</p>
754
<p>
755
When this feature is prepared, the list of accounts have been retrieved and
756
are available for use, and change-notification has been set up.
757
</p>
758
<p>
759
One can ask for a feature to be prepared using the
760
<a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-async" title="tp_account_manager_prepare_async ()"><code class="function">tp_account_manager_prepare_async()</code></a> function, and waiting for it to callback.</p>
761
<p>
762
</p>
763
<p class="since">Since 0.9.0</p>
764
</div>
765
<hr>
766
<div class="refsect2" title="tp_account_manager_is_prepared ()">
767
<a name="tp-account-manager-is-prepared"></a><h3>tp_account_manager_is_prepared ()</h3>
768
<pre class="programlisting"><a
769
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
770
>gboolean</a> tp_account_manager_is_prepared (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
771
<a
772
href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"
773
>GQuark</a> feature);</pre>
774
<p>
775
</p>
776
<p>
777
</p>
778
<div class="variablelist"><table border="0">
779
<col align="left" valign="top">
780
<tbody>
781
<tr>
782
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
783
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
784
</td>
785
</tr>
786
<tr>
787
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
788
<td> a feature which is required
789
</td>
790
</tr>
791
<tr>
792
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
793
<td> <a
794
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
795
><code class="literal">TRUE</code></a> whether <em class="parameter"><code>feature</code></em> is ready on <em class="parameter"><code>manager</code></em>, otherwise <a
796
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
797
><code class="literal">FALSE</code></a>
798
799
</td>
800
</tr>
801
</tbody>
802
</table></div>
803
<p class="since">Since 0.9.0</p>
804
</div>
805
<hr>
806
<div class="refsect2" title="tp_account_manager_prepare_async ()">
807
<a name="tp-account-manager-prepare-async"></a><h3>tp_account_manager_prepare_async ()</h3>
808
<pre class="programlisting">void tp_account_manager_prepare_async (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
809
const <a
810
href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"
811
>GQuark</a> *features,
812
<a
813
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
814
>GAsyncReadyCallback</a> callback,
815
<a
816
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
817
>gpointer</a> user_data);</pre>
818
<p>
819
Requests an asynchronous preparation of <em class="parameter"><code>manager</code></em> with the features specified
820
by <em class="parameter"><code>features</code></em>. When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You
821
can then call <a class="link" href="telepathy-glib-account-manager.html#tp-account-manager-prepare-finish" title="tp_account_manager_prepare_finish ()"><code class="function">tp_account_manager_prepare_finish()</code></a> to get the result of the
822
operation.
823
</p>
824
<p>
825
If <em class="parameter"><code>features</code></em> is <a
826
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
827
><code class="literal">NULL</code></a>, then <em class="parameter"><code>callback</code></em> will be called when the implied
828
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CORE--CAPS" title="TP_ACCOUNT_FEATURE_CORE"><code class="literal">TP_ACCOUNT_FEATURE_CORE</code></a> feature is ready.
829
</p>
830
<p>
831
If <a
832
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
833
><code class="literal">NULL</code></a> is given to <em class="parameter"><code>callback</code></em>, then no callback will be called when the
834
operation is finished. Instead, it will simply set <em class="parameter"><code>features</code></em> on <em class="parameter"><code>manager</code></em>.
835
Note that if <em class="parameter"><code>callback</code></em> is <a
836
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
837
><code class="literal">NULL</code></a>, then <em class="parameter"><code>user_data</code></em> must also be <a
838
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
839
><code class="literal">NULL</code></a>.</p>
840
<p>
841
</p>
842
<div class="variablelist"><table border="0">
843
<col align="left" valign="top">
844
<tbody>
845
<tr>
846
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
847
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
848
</td>
849
</tr>
850
<tr>
851
<td><p><span class="term"><em class="parameter"><code>features</code></em> :</span></p></td>
852
<td> a 0-terminated list of features, or <a
853
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
854
><code class="literal">NULL</code></a>
855
</td>
856
</tr>
857
<tr>
858
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
859
<td> a callback to call when the request is satisfied
860
</td>
861
</tr>
862
<tr>
863
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
864
<td> data to pass to <em class="parameter"><code>callback</code></em>
865
</td>
866
</tr>
867
</tbody>
868
</table></div>
869
<p class="since">Since 0.9.0</p>
870
</div>
871
<hr>
872
<div class="refsect2" title="tp_account_manager_prepare_finish ()">
873
<a name="tp-account-manager-prepare-finish"></a><h3>tp_account_manager_prepare_finish ()</h3>
874
<pre class="programlisting"><a
875
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
876
>gboolean</a> tp_account_manager_prepare_finish (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
877
<a
878
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
879
>GAsyncResult</a> *result,
880
<a
881
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
882
>GError</a> **error);</pre>
883
<p>
884
Finishes an async preparation of the account manager <em class="parameter"><code>manager</code></em>.</p>
885
<p>
886
</p>
887
<div class="variablelist"><table border="0">
888
<col align="left" valign="top">
889
<tbody>
890
<tr>
891
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
892
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
893
</td>
894
</tr>
895
<tr>
896
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
897
<td> a <a
898
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
899
><span class="type">GAsyncResult</span></a>
900
</td>
901
</tr>
902
<tr>
903
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
904
<td> a <a
905
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
906
><span class="type">GError</span></a> to fill
907
</td>
908
</tr>
909
<tr>
910
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
911
<td> <a
912
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
913
><code class="literal">TRUE</code></a> if the preparation was successful, otherwise <a
914
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
915
><code class="literal">FALSE</code></a>
916
917
</td>
918
</tr>
919
</tbody>
920
</table></div>
921
<p class="since">Since 0.9.0</p>
922
</div>
923
<hr>
253
924
<div class="refsect2" title="tp_cli_account_manager_callback_for_create_account ()">
254
925
<a name="tp-cli-account-manager-callback-for-create-account"></a><h3>tp_cli_account_manager_callback_for_create_account ()</h3>
255
926
<pre class="programlisting">void (*tp_cli_account_manager_callback_for_create_account)
711
1382
</table></div>
712
1383
</div>
713
1384
</div>
1385
<div class="refsect1" title="Signal Details">
1386
<a name="telepathy-glib-account-manager.signal-details"></a><h2>Signal Details</h2>
1387
<div class="refsect2" title='The "account-disabled" signal'>
1388
<a name="TpAccountManager-account-disabled"></a><h3>The <code class="literal">"account-disabled"</code> signal</h3>
1389
<pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
1390
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *account,
1391
<a
1392
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1393
>gpointer</a> user_data) : Run Last</pre>
1394
<p>
1395
Emitted when an account from <em class="parameter"><code>manager</code></em> is disabled.</p>
1396
<p>
1397
</p>
1398
<div class="variablelist"><table border="0">
1399
<col align="left" valign="top">
1400
<tbody>
1401
<tr>
1402
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
1403
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
1404
</td>
1405
</tr>
1406
<tr>
1407
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1408
<td> a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1409
</td>
1410
</tr>
1411
<tr>
1412
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1413
<td>user data set when the signal handler was connected.</td>
1414
</tr>
1415
</tbody>
1416
</table></div>
1417
<p>Since 0.9.0</p>
1418
</div>
1419
<hr>
1420
<div class="refsect2" title='The "account-enabled" signal'>
1421
<a name="TpAccountManager-account-enabled"></a><h3>The <code class="literal">"account-enabled"</code> signal</h3>
1422
<pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
1423
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *account,
1424
<a
1425
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1426
>gpointer</a> user_data) : Run Last</pre>
1427
<p>
1428
Emitted when an account from <em class="parameter"><code>manager</code></em> is enabled.</p>
1429
<p>
1430
</p>
1431
<div class="variablelist"><table border="0">
1432
<col align="left" valign="top">
1433
<tbody>
1434
<tr>
1435
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
1436
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
1437
</td>
1438
</tr>
1439
<tr>
1440
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1441
<td> a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1442
</td>
1443
</tr>
1444
<tr>
1445
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1446
<td>user data set when the signal handler was connected.</td>
1447
</tr>
1448
</tbody>
1449
</table></div>
1450
<p>Since 0.9.0</p>
1451
</div>
1452
<hr>
1453
<div class="refsect2" title='The "account-removed" signal'>
1454
<a name="TpAccountManager-account-removed"></a><h3>The <code class="literal">"account-removed"</code> signal</h3>
1455
<pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
1456
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *account,
1457
<a
1458
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1459
>gpointer</a> user_data) : Run Last</pre>
1460
<p>
1461
Emitted when an account is removed from <em class="parameter"><code>manager</code></em>.</p>
1462
<p>
1463
</p>
1464
<div class="variablelist"><table border="0">
1465
<col align="left" valign="top">
1466
<tbody>
1467
<tr>
1468
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
1469
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
1470
</td>
1471
</tr>
1472
<tr>
1473
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1474
<td> a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1475
</td>
1476
</tr>
1477
<tr>
1478
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1479
<td>user data set when the signal handler was connected.</td>
1480
</tr>
1481
</tbody>
1482
</table></div>
1483
<p>Since 0.9.0</p>
1484
</div>
1485
<hr>
1486
<div class="refsect2" title='The "account-validity-changed" signal'>
1487
<a name="TpAccountManager-account-validity-changed"></a><h3>The <code class="literal">"account-validity-changed"</code> signal</h3>
1488
<pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
1489
<a class="link" href="telepathy-glib-account.html#TpAccount">TpAccount</a> *account,
1490
<a
1491
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1492
>gboolean</a> valid,
1493
<a
1494
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1495
>gpointer</a> user_data) : Run Last</pre>
1496
<p>
1497
Emitted when the validity on <em class="parameter"><code>account</code></em> changes. <em class="parameter"><code>account</code></em> is not guaranteed
1498
to be ready when this signal is emitted.</p>
1499
<p>
1500
</p>
1501
<div class="variablelist"><table border="0">
1502
<col align="left" valign="top">
1503
<tbody>
1504
<tr>
1505
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
1506
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
1507
</td>
1508
</tr>
1509
<tr>
1510
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1511
<td> a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1512
</td>
1513
</tr>
1514
<tr>
1515
<td><p><span class="term"><em class="parameter"><code>valid</code></em> :</span></p></td>
1516
<td> <a
1517
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1518
><code class="literal">TRUE</code></a> if the account is now valid
1519
</td>
1520
</tr>
1521
<tr>
1522
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1523
<td>user data set when the signal handler was connected.</td>
1524
</tr>
1525
</tbody>
1526
</table></div>
1527
<p>Since 0.9.0</p>
1528
</div>
1529
<hr>
1530
<div class="refsect2" title='The "most-available-presence-changed" signal'>
1531
<a name="TpAccountManager-most-available-presence-changed"></a><h3>The <code class="literal">"most-available-presence-changed"</code> signal</h3>
1532
<pre class="programlisting">void user_function (<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager">TpAccountManager</a> *manager,
1533
<a
1534
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
1535
>guint</a> account,
1536
<a
1537
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1538
>gchar</a> *presence,
1539
<a
1540
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1541
>gchar</a> *status,
1542
<a
1543
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1544
>gpointer</a> user_data) : Run Last</pre>
1545
<p>
1546
Emitted when the most available presence on <em class="parameter"><code>manager</code></em> changes.</p>
1547
<p>
1548
</p>
1549
<div class="variablelist"><table border="0">
1550
<col align="left" valign="top">
1551
<tbody>
1552
<tr>
1553
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
1554
<td> a <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>
1555
</td>
1556
</tr>
1557
<tr>
1558
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1559
<td> a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1560
</td>
1561
</tr>
1562
<tr>
1563
<td><p><span class="term"><em class="parameter"><code>presence</code></em> :</span></p></td>
1564
<td> new presence type
1565
</td>
1566
</tr>
1567
<tr>
1568
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
1569
<td> new status
1570
</td>
1571
</tr>
1572
<tr>
1573
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1574
<td> new status message
1575
</td>
1576
</tr>
1577
<tr>
1578
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1579
<td>user data set when the signal handler was connected.</td>
1580
</tr>
1581
</tbody>
1582
</table></div>
1583
<p>Since 0.9.0</p>
1584
</div>
1585
</div>
714
1586
<div class="refsect1" title="See Also">
715
1587
<a name="telepathy-glib-account-manager.see-also"></a><h2>See Also</h2>
716
1588
#TpAccount
Loggerhead is a web-based interface for Breezy
Version: 2.0.1