33
40
<p>TpAccount — proxy object for an account in the Telepathy account
36
<td class="gallery_image" valign="top" align="right"></td>
43
<td valign="top" align="right"></td>
37
44
</tr></table></div>
45
<div class="refsynopsisdiv">
46
<a name="telepathy-glib-account.synopsis"></a><h2>Synopsis</h2>
47
<a name="TpAccount"></a><pre class="synopsis">
48
#include <telepathy-glib/telepathy-glib.h>
50
<a class="link" href="telepathy-glib-account.html#TpAccount-struct" title="TpAccount">TpAccount</a>;
51
struct <a class="link" href="telepathy-glib-account.html#TpAccountClass" title="struct TpAccountClass">TpAccountClass</a>;
52
<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-new" title="tp_account_new ()">tp_account_new</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,
53
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
55
<span class="returnvalue">void</span> <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> (<em class="parameter"><code><span class="type">void</span></code></em>);
56
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-parse-object-path" title="tp_account_parse_object_path ()">tp_account_parse_object_path</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
57
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **cm</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **protocol</code></em>,
59
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **account_id</code></em>,
60
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
61
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-path-suffix" title="tp_account_get_path_suffix ()">tp_account_get_path_suffix</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
62
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-connection" title="tp_account_get_connection ()">tp_account_get_connection</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
63
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-ensure-connection" title="tp_account_ensure_connection ()">tp_account_ensure_connection</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
64
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);
65
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-display-name" title="tp_account_get_display_name ()">tp_account_get_display_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
66
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()">tp_account_get_connection_manager</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
67
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()">tp_account_get_cm_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
68
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()">tp_account_get_protocol</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
69
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol-name" title="tp_account_get_protocol_name ()">tp_account_get_protocol_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
70
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-icon-name" title="tp_account_get_icon_name ()">tp_account_get_icon_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
71
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-service" title="tp_account_get_service ()">tp_account_get_service</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
72
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-async" title="tp_account_set_enabled_async ()">tp_account_set_enabled_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
73
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
74
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
76
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-finish" title="tp_account_set_enabled_finish ()">tp_account_set_enabled_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
77
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
78
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
79
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-reconnect-async" title="tp_account_reconnect_async ()">tp_account_reconnect_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
80
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
81
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
82
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-reconnect-finish" title="tp_account_reconnect_finish ()">tp_account_reconnect_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
83
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
84
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
85
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-is-enabled" title="tp_account_is_enabled ()">tp_account_is_enabled</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
86
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-is-valid" title="tp_account_is_valid ()">tp_account_is_valid</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
87
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-async" title="tp_account_update_parameters_async ()">tp_account_update_parameters_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
88
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *parameters</code></em>,
89
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
90
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
91
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
92
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()">tp_account_update_parameters_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
93
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
94
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
95
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
96
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-vardict-async" title="tp_account_update_parameters_vardict_async ()">tp_account_update_parameters_vardict_async</a>
97
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
98
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
99
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
100
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
101
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-vardict-finish" title="tp_account_update_parameters_vardict_finish ()">tp_account_update_parameters_vardict_finish</a>
103
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
104
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
105
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
106
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
107
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-remove-async" title="tp_account_remove_async ()">tp_account_remove_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
108
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
109
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-remove-finish" title="tp_account_remove_finish ()">tp_account_remove_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
111
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
112
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
113
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-async" title="tp_account_set_display_name_async ()">tp_account_set_display_name_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
114
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *display_name</code></em>,
115
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
116
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
117
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()">tp_account_set_display_name_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
118
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
119
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
120
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-async" title="tp_account_set_icon_name_async ()">tp_account_set_icon_name_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
121
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
122
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
123
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
124
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-finish" title="tp_account_set_icon_name_finish ()">tp_account_set_icon_name_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
125
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
126
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
127
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()">tp_account_set_service_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
128
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
129
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
130
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
131
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()">tp_account_set_service_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
132
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
133
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
134
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-request-presence-async" title="tp_account_request_presence_async ()">tp_account_request_presence_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
135
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
136
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
137
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
138
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
139
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
140
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-request-presence-finish" title="tp_account_request_presence_finish ()">tp_account_request_presence_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
141
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
142
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
143
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-async" title="tp_account_set_automatic_presence_async ()">tp_account_set_automatic_presence_async</a>
144
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
145
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
146
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
147
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
148
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
149
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
150
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-finish" title="tp_account_set_automatic_presence_finish ()">tp_account_set_automatic_presence_finish</a>
151
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
152
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
153
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
154
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-connect-automatically" title="tp_account_get_connect_automatically ()">tp_account_get_connect_automatically</a>
155
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
156
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-async" title="tp_account_set_connect_automatically_async ()">tp_account_set_connect_automatically_async</a>
157
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
158
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> connect_automatically</code></em>,
159
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
160
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
161
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-finish" title="tp_account_set_connect_automatically_finish ()">tp_account_set_connect_automatically_finish</a>
162
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
163
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
164
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
165
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-has-been-online" title="tp_account_get_has_been_online ()">tp_account_get_has_been_online</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
166
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-connection-status" title="tp_account_get_connection_status ()">tp_account_get_connection_status</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
167
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> *reason</code></em>);
168
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-detailed-error" title="tp_account_get_detailed_error ()">tp_account_get_detailed_error</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
169
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **details</code></em>);
170
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-dup-detailed-error-vardict" title="tp_account_dup_detailed_error_vardict ()">tp_account_dup_detailed_error_vardict</a>
171
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
172
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> **details</code></em>);
173
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-changing-presence" title="tp_account_get_changing_presence ()">tp_account_get_changing_presence</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
174
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-current-presence" title="tp_account_get_current_presence ()">tp_account_get_current_presence</a>
175
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
176
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
177
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);
178
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-requested-presence" title="tp_account_get_requested_presence ()">tp_account_get_requested_presence</a>
179
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
180
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
181
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);
182
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-automatic-presence" title="tp_account_get_automatic_presence ()">tp_account_get_automatic_presence</a>
183
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
184
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
185
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);
186
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-parameters" title="tp_account_get_parameters ()">tp_account_get_parameters</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
187
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-dup-parameters-vardict" title="tp_account_dup_parameters_vardict ()">tp_account_dup_parameters_vardict</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
188
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-nickname" title="tp_account_get_nickname ()">tp_account_get_nickname</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);
189
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-async" title="tp_account_set_nickname_async ()">tp_account_set_nickname_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
190
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nickname</code></em>,
191
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
192
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
193
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-finish" title="tp_account_set_nickname_finish ()">tp_account_set_nickname_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
194
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
195
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
196
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-normalized-name" title="tp_account_get_normalized_name ()">tp_account_get_normalized_name</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
197
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="telepathy-glib-account.html#tp-account-get-supersedes" title="tp_account_get_supersedes ()">tp_account_get_supersedes</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
198
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-async" title="tp_account_get_avatar_async ()">tp_account_get_avatar_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
199
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
200
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
201
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-finish" title="tp_account_get_avatar_finish ()">tp_account_get_avatar_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
202
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
203
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
204
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-async" title="tp_account_set_avatar_async ()">tp_account_set_avatar_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
205
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *avatar</code></em>,
206
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> len</code></em>,
207
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mime_type</code></em>,
208
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
209
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
210
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-finish" title="tp_account_set_avatar_finish ()">tp_account_set_avatar_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
211
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
212
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
213
<a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="returnvalue">GBinding</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-bind-connection-status-to-property" title="tp_account_bind_connection_status_to_property ()">tp_account_bind_connection_status_to_property</a>
214
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
215
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> target</code></em>,
216
<em class="parameter"><code>const <span class="type">char</span> *target_property</code></em>,
217
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invert</code></em>);
219
#define <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CORE:CAPS" title="TP_ACCOUNT_FEATURE_CORE">TP_ACCOUNT_FEATURE_CORE</a>
220
#define <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS" title="TP_ACCOUNT_FEATURE_CONNECTION">TP_ACCOUNT_FEATURE_CONNECTION</a>
221
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-is-prepared" title="tp_account_is_prepared ()">tp_account_is_prepared</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
222
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> feature</code></em>);
223
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-prepare-async" title="tp_account_prepare_async ()">tp_account_prepare_async</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
224
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> *features</code></em>,
225
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
226
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
227
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-prepare-finish" title="tp_account_prepare_finish ()">tp_account_prepare_finish</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
228
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
229
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
231
#define <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING">TP_ACCOUNT_FEATURE_ADDRESSING</a>
232
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()">tp_account_get_uri_schemes</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
233
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-associated-with-uri-scheme" title="tp_account_associated_with_uri_scheme ()">tp_account_associated_with_uri_scheme</a>
234
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
235
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>);
236
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-async" title="tp_account_set_uri_scheme_association_async ()">tp_account_set_uri_scheme_association_async</a>
237
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
238
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>,
239
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> associate</code></em>,
240
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
241
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
242
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-finish" title="tp_account_set_uri_scheme_association_finish ()">tp_account_set_uri_scheme_association_finish</a>
243
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
244
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
245
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
247
#define <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE">TP_ACCOUNT_FEATURE_STORAGE</a>
248
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-provider" title="tp_account_get_storage_provider ()">tp_account_get_storage_provider</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
249
const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-identifier" title="tp_account_get_storage_identifier ()">tp_account_get_storage_identifier</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
250
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-identifier-variant" title="tp_account_dup_storage_identifier_variant ()">tp_account_dup_storage_identifier_variant</a>
251
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
252
<a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="returnvalue">TpStorageRestrictionFlags</span></a> <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-restrictions" title="tp_account_get_storage_restrictions ()">tp_account_get_storage_restrictions</a>
253
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);
254
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-async" title="tp_account_get_storage_specific_information_async ()">tp_account_get_storage_specific_information_async</a>
255
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
256
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
257
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
258
<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-finish" title="tp_account_get_storage_specific_information_finish ()">tp_account_get_storage_specific_information_finish</a>
259
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
260
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
261
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
262
<span class="returnvalue">void</span> <a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-async" title="tp_account_dup_storage_specific_information_vardict_async ()">tp_account_dup_storage_specific_information_vardict_async</a>
263
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
264
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
265
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
266
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-finish" title="tp_account_dup_storage_specific_information_vardict_finish ()">tp_account_dup_storage_specific_information_vardict_finish</a>
267
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
268
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
269
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
272
<span class="returnvalue">void</span> (<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>)
273
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
274
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
275
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
276
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
277
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></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> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
278
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
279
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()"><span class="type">tp_cli_account_callback_for_reconnect</span></a> callback</code></em>,
280
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
281
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
282
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
283
<span class="returnvalue">void</span> (<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>)
284
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
285
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
286
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
287
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
288
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></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> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
289
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
290
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()"><span class="type">tp_cli_account_callback_for_remove</span></a> callback</code></em>,
291
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
292
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
293
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
294
<span class="returnvalue">void</span> (<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>)
295
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
296
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Reconnect_Required</code></em>,
297
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
298
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
299
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
300
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></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>
301
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
302
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
303
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Set</code></em>,
304
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Unset</code></em>,
305
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()"><span class="type">tp_cli_account_callback_for_update_parameters</span></a> callback</code></em>,
306
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
307
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
308
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
309
<span class="returnvalue">void</span> (<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>)
310
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
311
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Properties</code></em>,
312
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
313
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
314
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></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>
315
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
316
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_signal_callback_account_property_changed</span></a> callback</code></em>,
317
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
318
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
319
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
320
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
321
<span class="returnvalue">void</span> (<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>)
322
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
323
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
324
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
325
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></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>
326
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
327
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()"><span class="type">tp_cli_account_signal_callback_removed</span></a> callback</code></em>,
328
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
329
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
330
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
331
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
333
<span class="returnvalue">void</span> (<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>)
334
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
335
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
336
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
337
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></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>
338
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
339
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_interface_avatar_signal_callback_avatar_changed</span></a> callback</code></em>,
340
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
341
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
342
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
343
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
345
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association" title="tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()">*tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association</a>)
346
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
347
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
348
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
349
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
350
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-call-set-uri-scheme-association" title="tp_cli_account_interface_addressing_call_set_uri_scheme_association ()">tp_cli_account_interface_addressing_call_set_uri_scheme_association</a>
351
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
352
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
353
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_URI_Scheme</code></em>,
354
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Association</code></em>,
355
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association" title="tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()"><span class="type">tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association</span></a> callback</code></em>,
356
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
357
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
358
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
38
361
<div class="refsect1">
39
<a name="telepathy-glib-account.functions"></a><h2>Functions</h2>
40
<div class="informaltable"><table width="100%" border="0">
42
<col width="150px" class="functions_return">
43
<col class="functions_name">
47
<td class="function_type">
48
<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> *
50
<td class="function_name">
51
<a class="link" href="telepathy-glib-account.html#tp-account-new" title="tp_account_new ()">tp_account_new</a> <span class="c_punctuation">()</span>
55
<td class="function_type">
56
<span class="returnvalue">void</span>
58
<td class="function_name">
59
<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> <span class="c_punctuation">()</span>
63
<td class="function_type">
64
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
66
<td class="function_name">
67
<a class="link" href="telepathy-glib-account.html#tp-account-parse-object-path" title="tp_account_parse_object_path ()">tp_account_parse_object_path</a> <span class="c_punctuation">()</span>
71
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
73
<td class="function_name">
74
<a class="link" href="telepathy-glib-account.html#tp-account-get-path-suffix" title="tp_account_get_path_suffix ()">tp_account_get_path_suffix</a> <span class="c_punctuation">()</span>
78
<td class="function_type">
79
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *
81
<td class="function_name">
82
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection" title="tp_account_get_connection ()">tp_account_get_connection</a> <span class="c_punctuation">()</span>
86
<td class="function_type">
87
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *
89
<td class="function_name">
90
<a class="link" href="telepathy-glib-account.html#tp-account-ensure-connection" title="tp_account_ensure_connection ()">tp_account_ensure_connection</a> <span class="c_punctuation">()</span>
94
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
96
<td class="function_name">
97
<a class="link" href="telepathy-glib-account.html#tp-account-get-display-name" title="tp_account_get_display_name ()">tp_account_get_display_name</a> <span class="c_punctuation">()</span>
101
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
103
<td class="function_name">
104
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()">tp_account_get_connection_manager</a> <span class="c_punctuation">()</span>
108
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
110
<td class="function_name">
111
<a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()">tp_account_get_cm_name</a> <span class="c_punctuation">()</span>
115
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
117
<td class="function_name">
118
<a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()">tp_account_get_protocol</a> <span class="c_punctuation">()</span>
122
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
124
<td class="function_name">
125
<a class="link" href="telepathy-glib-account.html#tp-account-get-protocol-name" title="tp_account_get_protocol_name ()">tp_account_get_protocol_name</a> <span class="c_punctuation">()</span>
129
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
131
<td class="function_name">
132
<a class="link" href="telepathy-glib-account.html#tp-account-get-icon-name" title="tp_account_get_icon_name ()">tp_account_get_icon_name</a> <span class="c_punctuation">()</span>
136
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
138
<td class="function_name">
139
<a class="link" href="telepathy-glib-account.html#tp-account-get-service" title="tp_account_get_service ()">tp_account_get_service</a> <span class="c_punctuation">()</span>
143
<td class="function_type">
144
<span class="returnvalue">void</span>
146
<td class="function_name">
147
<a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-async" title="tp_account_set_enabled_async ()">tp_account_set_enabled_async</a> <span class="c_punctuation">()</span>
151
<td class="function_type">
152
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
154
<td class="function_name">
155
<a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-finish" title="tp_account_set_enabled_finish ()">tp_account_set_enabled_finish</a> <span class="c_punctuation">()</span>
159
<td class="function_type">
160
<span class="returnvalue">void</span>
162
<td class="function_name">
163
<a class="link" href="telepathy-glib-account.html#tp-account-reconnect-async" title="tp_account_reconnect_async ()">tp_account_reconnect_async</a> <span class="c_punctuation">()</span>
167
<td class="function_type">
168
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
170
<td class="function_name">
171
<a class="link" href="telepathy-glib-account.html#tp-account-reconnect-finish" title="tp_account_reconnect_finish ()">tp_account_reconnect_finish</a> <span class="c_punctuation">()</span>
175
<td class="function_type">
176
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
178
<td class="function_name">
179
<a class="link" href="telepathy-glib-account.html#tp-account-is-enabled" title="tp_account_is_enabled ()">tp_account_is_enabled</a> <span class="c_punctuation">()</span>
183
<td class="function_type">
184
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
186
<td class="function_name">
187
<a class="link" href="telepathy-glib-account.html#tp-account-is-valid" title="tp_account_is_valid ()">tp_account_is_valid</a> <span class="c_punctuation">()</span>
191
<td class="function_type">
192
<span class="returnvalue">void</span>
194
<td class="function_name">
195
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-async" title="tp_account_update_parameters_async ()">tp_account_update_parameters_async</a> <span class="c_punctuation">()</span>
199
<td class="function_type">
200
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
202
<td class="function_name">
203
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()">tp_account_update_parameters_finish</a> <span class="c_punctuation">()</span>
207
<td class="function_type">
208
<span class="returnvalue">void</span>
210
<td class="function_name">
211
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-vardict-async" title="tp_account_update_parameters_vardict_async ()">tp_account_update_parameters_vardict_async</a> <span class="c_punctuation">()</span>
215
<td class="function_type">
216
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
218
<td class="function_name">
219
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-vardict-finish" title="tp_account_update_parameters_vardict_finish ()">tp_account_update_parameters_vardict_finish</a> <span class="c_punctuation">()</span>
223
<td class="function_type">
224
<span class="returnvalue">void</span>
226
<td class="function_name">
227
<a class="link" href="telepathy-glib-account.html#tp-account-remove-async" title="tp_account_remove_async ()">tp_account_remove_async</a> <span class="c_punctuation">()</span>
231
<td class="function_type">
232
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
234
<td class="function_name">
235
<a class="link" href="telepathy-glib-account.html#tp-account-remove-finish" title="tp_account_remove_finish ()">tp_account_remove_finish</a> <span class="c_punctuation">()</span>
239
<td class="function_type">
240
<span class="returnvalue">void</span>
242
<td class="function_name">
243
<a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-async" title="tp_account_set_display_name_async ()">tp_account_set_display_name_async</a> <span class="c_punctuation">()</span>
247
<td class="function_type">
248
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
250
<td class="function_name">
251
<a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()">tp_account_set_display_name_finish</a> <span class="c_punctuation">()</span>
255
<td class="function_type">
256
<span class="returnvalue">void</span>
258
<td class="function_name">
259
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-async" title="tp_account_set_icon_name_async ()">tp_account_set_icon_name_async</a> <span class="c_punctuation">()</span>
263
<td class="function_type">
264
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
266
<td class="function_name">
267
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-finish" title="tp_account_set_icon_name_finish ()">tp_account_set_icon_name_finish</a> <span class="c_punctuation">()</span>
271
<td class="function_type">
272
<span class="returnvalue">void</span>
274
<td class="function_name">
275
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()">tp_account_set_service_async</a> <span class="c_punctuation">()</span>
279
<td class="function_type">
280
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
282
<td class="function_name">
283
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()">tp_account_set_service_finish</a> <span class="c_punctuation">()</span>
287
<td class="function_type">
288
<span class="returnvalue">void</span>
290
<td class="function_name">
291
<a class="link" href="telepathy-glib-account.html#tp-account-request-presence-async" title="tp_account_request_presence_async ()">tp_account_request_presence_async</a> <span class="c_punctuation">()</span>
295
<td class="function_type">
296
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
298
<td class="function_name">
299
<a class="link" href="telepathy-glib-account.html#tp-account-request-presence-finish" title="tp_account_request_presence_finish ()">tp_account_request_presence_finish</a> <span class="c_punctuation">()</span>
303
<td class="function_type">
304
<span class="returnvalue">void</span>
306
<td class="function_name">
307
<a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-async" title="tp_account_set_automatic_presence_async ()">tp_account_set_automatic_presence_async</a> <span class="c_punctuation">()</span>
311
<td class="function_type">
312
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
314
<td class="function_name">
315
<a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-finish" title="tp_account_set_automatic_presence_finish ()">tp_account_set_automatic_presence_finish</a> <span class="c_punctuation">()</span>
319
<td class="function_type">
320
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
322
<td class="function_name">
323
<a class="link" href="telepathy-glib-account.html#tp-account-get-connect-automatically" title="tp_account_get_connect_automatically ()">tp_account_get_connect_automatically</a> <span class="c_punctuation">()</span>
327
<td class="function_type">
328
<span class="returnvalue">void</span>
330
<td class="function_name">
331
<a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-async" title="tp_account_set_connect_automatically_async ()">tp_account_set_connect_automatically_async</a> <span class="c_punctuation">()</span>
335
<td class="function_type">
336
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
338
<td class="function_name">
339
<a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-finish" title="tp_account_set_connect_automatically_finish ()">tp_account_set_connect_automatically_finish</a> <span class="c_punctuation">()</span>
343
<td class="function_type">
344
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
346
<td class="function_name">
347
<a class="link" href="telepathy-glib-account.html#tp-account-get-has-been-online" title="tp_account_get_has_been_online ()">tp_account_get_has_been_online</a> <span class="c_punctuation">()</span>
351
<td class="function_type">
352
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>
354
<td class="function_name">
355
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-status" title="tp_account_get_connection_status ()">tp_account_get_connection_status</a> <span class="c_punctuation">()</span>
359
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
361
<td class="function_name">
362
<a class="link" href="telepathy-glib-account.html#tp-account-get-detailed-error" title="tp_account_get_detailed_error ()">tp_account_get_detailed_error</a> <span class="c_punctuation">()</span>
366
<td class="function_type">
367
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
369
<td class="function_name">
370
<a class="link" href="telepathy-glib-account.html#tp-account-dup-detailed-error-vardict" title="tp_account_dup_detailed_error_vardict ()">tp_account_dup_detailed_error_vardict</a> <span class="c_punctuation">()</span>
374
<td class="function_type">
375
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
377
<td class="function_name">
378
<a class="link" href="telepathy-glib-account.html#tp-account-get-changing-presence" title="tp_account_get_changing_presence ()">tp_account_get_changing_presence</a> <span class="c_punctuation">()</span>
382
<td class="function_type">
383
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
385
<td class="function_name">
386
<a class="link" href="telepathy-glib-account.html#tp-account-get-current-presence" title="tp_account_get_current_presence ()">tp_account_get_current_presence</a> <span class="c_punctuation">()</span>
390
<td class="function_type">
391
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
393
<td class="function_name">
394
<a class="link" href="telepathy-glib-account.html#tp-account-get-requested-presence" title="tp_account_get_requested_presence ()">tp_account_get_requested_presence</a> <span class="c_punctuation">()</span>
398
<td class="function_type">
399
<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
401
<td class="function_name">
402
<a class="link" href="telepathy-glib-account.html#tp-account-get-automatic-presence" title="tp_account_get_automatic_presence ()">tp_account_get_automatic_presence</a> <span class="c_punctuation">()</span>
406
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
408
<td class="function_name">
409
<a class="link" href="telepathy-glib-account.html#tp-account-get-parameters" title="tp_account_get_parameters ()">tp_account_get_parameters</a> <span class="c_punctuation">()</span>
413
<td class="function_type">
414
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
416
<td class="function_name">
417
<a class="link" href="telepathy-glib-account.html#tp-account-dup-parameters-vardict" title="tp_account_dup_parameters_vardict ()">tp_account_dup_parameters_vardict</a> <span class="c_punctuation">()</span>
421
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
423
<td class="function_name">
424
<a class="link" href="telepathy-glib-account.html#tp-account-get-nickname" title="tp_account_get_nickname ()">tp_account_get_nickname</a> <span class="c_punctuation">()</span>
428
<td class="function_type">
429
<span class="returnvalue">void</span>
431
<td class="function_name">
432
<a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-async" title="tp_account_set_nickname_async ()">tp_account_set_nickname_async</a> <span class="c_punctuation">()</span>
436
<td class="function_type">
437
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
439
<td class="function_name">
440
<a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-finish" title="tp_account_set_nickname_finish ()">tp_account_set_nickname_finish</a> <span class="c_punctuation">()</span>
444
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
446
<td class="function_name">
447
<a class="link" href="telepathy-glib-account.html#tp-account-get-normalized-name" title="tp_account_get_normalized_name ()">tp_account_get_normalized_name</a> <span class="c_punctuation">()</span>
451
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
453
<td class="function_name">
454
<a class="link" href="telepathy-glib-account.html#tp-account-get-supersedes" title="tp_account_get_supersedes ()">tp_account_get_supersedes</a> <span class="c_punctuation">()</span>
458
<td class="function_type">
459
<span class="returnvalue">void</span>
461
<td class="function_name">
462
<a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-async" title="tp_account_get_avatar_async ()">tp_account_get_avatar_async</a> <span class="c_punctuation">()</span>
466
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *
468
<td class="function_name">
469
<a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-finish" title="tp_account_get_avatar_finish ()">tp_account_get_avatar_finish</a> <span class="c_punctuation">()</span>
473
<td class="function_type">
474
<span class="returnvalue">void</span>
476
<td class="function_name">
477
<a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-async" title="tp_account_set_avatar_async ()">tp_account_set_avatar_async</a> <span class="c_punctuation">()</span>
481
<td class="function_type">
482
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
484
<td class="function_name">
485
<a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-finish" title="tp_account_set_avatar_finish ()">tp_account_set_avatar_finish</a> <span class="c_punctuation">()</span>
489
<td class="function_type">
490
<a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="returnvalue">GBinding</span></a> *
492
<td class="function_name">
493
<a class="link" href="telepathy-glib-account.html#tp-account-bind-connection-status-to-property" title="tp_account_bind_connection_status_to_property ()">tp_account_bind_connection_status_to_property</a> <span class="c_punctuation">()</span>
497
<td class="function_type">
498
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
500
<td class="function_name">
501
<a class="link" href="telepathy-glib-account.html#tp-account-is-prepared" title="tp_account_is_prepared ()">tp_account_is_prepared</a> <span class="c_punctuation">()</span>
505
<td class="function_type">
506
<span class="returnvalue">void</span>
508
<td class="function_name">
509
<a class="link" href="telepathy-glib-account.html#tp-account-prepare-async" title="tp_account_prepare_async ()">tp_account_prepare_async</a> <span class="c_punctuation">()</span>
513
<td class="function_type">
514
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
516
<td class="function_name">
517
<a class="link" href="telepathy-glib-account.html#tp-account-prepare-finish" title="tp_account_prepare_finish ()">tp_account_prepare_finish</a> <span class="c_punctuation">()</span>
521
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
523
<td class="function_name">
524
<a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()">tp_account_get_uri_schemes</a> <span class="c_punctuation">()</span>
528
<td class="function_type">
529
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
531
<td class="function_name">
532
<a class="link" href="telepathy-glib-account.html#tp-account-associated-with-uri-scheme" title="tp_account_associated_with_uri_scheme ()">tp_account_associated_with_uri_scheme</a> <span class="c_punctuation">()</span>
536
<td class="function_type">
537
<span class="returnvalue">void</span>
539
<td class="function_name">
540
<a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-async" title="tp_account_set_uri_scheme_association_async ()">tp_account_set_uri_scheme_association_async</a> <span class="c_punctuation">()</span>
544
<td class="function_type">
545
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
547
<td class="function_name">
548
<a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-finish" title="tp_account_set_uri_scheme_association_finish ()">tp_account_set_uri_scheme_association_finish</a> <span class="c_punctuation">()</span>
552
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
554
<td class="function_name">
555
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-provider" title="tp_account_get_storage_provider ()">tp_account_get_storage_provider</a> <span class="c_punctuation">()</span>
559
<td class="function_type">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *
561
<td class="function_name">
562
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-identifier" title="tp_account_get_storage_identifier ()">tp_account_get_storage_identifier</a> <span class="c_punctuation">()</span>
566
<td class="function_type">
567
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
569
<td class="function_name">
570
<a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-identifier-variant" title="tp_account_dup_storage_identifier_variant ()">tp_account_dup_storage_identifier_variant</a> <span class="c_punctuation">()</span>
574
<td class="function_type">
575
<a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="returnvalue">TpStorageRestrictionFlags</span></a>
577
<td class="function_name">
578
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-restrictions" title="tp_account_get_storage_restrictions ()">tp_account_get_storage_restrictions</a> <span class="c_punctuation">()</span>
582
<td class="function_type">
583
<span class="returnvalue">void</span>
585
<td class="function_name">
586
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-async" title="tp_account_get_storage_specific_information_async ()">tp_account_get_storage_specific_information_async</a> <span class="c_punctuation">()</span>
590
<td class="function_type">
591
<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
593
<td class="function_name">
594
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-finish" title="tp_account_get_storage_specific_information_finish ()">tp_account_get_storage_specific_information_finish</a> <span class="c_punctuation">()</span>
598
<td class="function_type">
599
<span class="returnvalue">void</span>
601
<td class="function_name">
602
<a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-async" title="tp_account_dup_storage_specific_information_vardict_async ()">tp_account_dup_storage_specific_information_vardict_async</a> <span class="c_punctuation">()</span>
606
<td class="function_type">
607
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
609
<td class="function_name">
610
<a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-finish" title="tp_account_dup_storage_specific_information_vardict_finish ()">tp_account_dup_storage_specific_information_vardict_finish</a> <span class="c_punctuation">()</span>
614
<td class="function_type">
615
<span class="returnvalue">void</span>
617
<td class="function_name">
618
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
622
<td class="function_type">
623
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
625
<td class="function_name">
626
<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> <span class="c_punctuation">()</span>
630
<td class="function_type">
631
<span class="returnvalue">void</span>
633
<td class="function_name">
634
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
638
<td class="function_type">
639
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
641
<td class="function_name">
642
<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> <span class="c_punctuation">()</span>
646
<td class="function_type">
647
<span class="returnvalue">void</span>
649
<td class="function_name">
650
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
654
<td class="function_type">
655
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
657
<td class="function_name">
658
<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> <span class="c_punctuation">()</span>
662
<td class="function_type">
663
<span class="returnvalue">void</span>
665
<td class="function_name">
666
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
670
<td class="function_type">
671
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
673
<td class="function_name">
674
<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> <span class="c_punctuation">()</span>
678
<td class="function_type">
679
<span class="returnvalue">void</span>
681
<td class="function_name">
682
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
686
<td class="function_type">
687
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
689
<td class="function_name">
690
<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> <span class="c_punctuation">()</span>
694
<td class="function_type">
695
<span class="returnvalue">void</span>
697
<td class="function_name">
698
<span class="c_punctuation">(</span><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><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
702
<td class="function_type">
703
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
705
<td class="function_name">
706
<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> <span class="c_punctuation">()</span>
710
<td class="function_type">
711
<span class="returnvalue">void</span>
713
<td class="function_name">
714
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association" title="tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()">*tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
718
<td class="function_type">
719
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
721
<td class="function_name">
722
<a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-call-set-uri-scheme-association" title="tp_cli_account_interface_addressing_call_set_uri_scheme_association ()">tp_cli_account_interface_addressing_call_set_uri_scheme_association</a> <span class="c_punctuation">()</span>
362
<a name="telepathy-glib-account.object-hierarchy"></a><h2>Object Hierarchy</h2>
363
<pre class="synopsis">
364
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
365
+----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
728
369
<div class="refsect1">
729
370
<a name="telepathy-glib-account.properties"></a><h2>Properties</h2>
730
<div class="informaltable"><table border="0">
732
<col width="150px" class="properties_type">
733
<col width="300px" class="properties_name">
734
<col width="200px" class="properties_flags">
738
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
739
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title="The “automatic-presence-type” property">automatic-presence-type</a></td>
740
<td class="property_flags">Read</td>
743
<td class="property_type">
744
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
745
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status" title="The “automatic-status” property">automatic-status</a></td>
746
<td class="property_flags">Read</td>
749
<td class="property_type">
750
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
751
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status-message" title="The “automatic-status-message” property">automatic-status-message</a></td>
752
<td class="property_flags">Read</td>
755
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
756
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--changing-presence" title="The “changing-presence” property">changing-presence</a></td>
757
<td class="property_flags">Read</td>
760
<td class="property_type">
761
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
762
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title="The “cm-name” property">cm-name</a></td>
763
<td class="property_flags">Read</td>
766
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
767
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connect-automatically" title="The “connect-automatically” property">connect-automatically</a></td>
768
<td class="property_flags">Read</td>
771
<td class="property_type">
772
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *</td>
773
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection" title="The “connection” property">connection</a></td>
774
<td class="property_flags">Read</td>
777
<td class="property_type">
778
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
779
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title="The “connection-error” property">connection-error</a></td>
780
<td class="property_flags">Read</td>
783
<td class="property_type">
784
<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *</td>
785
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title="The “connection-error-details” property">connection-error-details</a></td>
786
<td class="property_flags">Read</td>
789
<td class="property_type">
790
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
791
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection-manager" title="The “connection-manager” property">connection-manager</a></td>
792
<td class="property_flags">Read</td>
795
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
796
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title="The “connection-status” property">connection-status</a></td>
797
<td class="property_flags">Read</td>
800
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
801
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--connection-status-reason" title="The “connection-status-reason” property">connection-status-reason</a></td>
802
<td class="property_flags">Read</td>
805
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
806
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title="The “current-presence-type” property">current-presence-type</a></td>
807
<td class="property_flags">Read</td>
810
<td class="property_type">
811
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
812
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title="The “current-status” property">current-status</a></td>
813
<td class="property_flags">Read</td>
816
<td class="property_type">
817
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
818
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title="The “current-status-message” property">current-status-message</a></td>
819
<td class="property_flags">Read</td>
822
<td class="property_type">
823
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
824
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--display-name" title="The “display-name” property">display-name</a></td>
825
<td class="property_flags">Read</td>
828
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
829
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--enabled" title="The “enabled” property">enabled</a></td>
830
<td class="property_flags">Read</td>
833
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
834
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--has-been-online" title="The “has-been-online” property">has-been-online</a></td>
835
<td class="property_flags">Read</td>
838
<td class="property_type">
839
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
840
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--icon-name" title="The “icon-name” property">icon-name</a></td>
841
<td class="property_flags">Read</td>
844
<td class="property_type">
845
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
846
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--nickname" title="The “nickname” property">nickname</a></td>
847
<td class="property_flags">Read</td>
850
<td class="property_type">
851
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
852
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--normalized-name" title="The “normalized-name” property">normalized-name</a></td>
853
<td class="property_flags">Read</td>
856
<td class="property_type">
857
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
858
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title="The “protocol” property">protocol</a></td>
859
<td class="property_flags">Read</td>
862
<td class="property_type">
863
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
864
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title="The “protocol-name” property">protocol-name</a></td>
865
<td class="property_flags">Read</td>
868
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
869
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title="The “requested-presence-type” property">requested-presence-type</a></td>
870
<td class="property_flags">Read</td>
873
<td class="property_type">
874
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
875
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title="The “requested-status” property">requested-status</a></td>
876
<td class="property_flags">Read</td>
879
<td class="property_type">
880
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
881
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title="The “requested-status-message” property">requested-status-message</a></td>
882
<td class="property_flags">Read</td>
885
<td class="property_type">
886
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
887
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--service" title="The “service” property">service</a></td>
888
<td class="property_flags">Read</td>
891
<td class="property_type">
892
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *</td>
893
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier" title="The “storage-identifier” property">storage-identifier</a></td>
894
<td class="property_flags">Read</td>
897
<td class="property_type">
898
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *</td>
899
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier-variant" title="The “storage-identifier-variant” property">storage-identifier-variant</a></td>
900
<td class="property_flags">Read</td>
903
<td class="property_type">
904
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
905
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property">storage-provider</a></td>
906
<td class="property_flags">Read</td>
909
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
910
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--storage-restrictions" title="The “storage-restrictions” property">storage-restrictions</a></td>
911
<td class="property_flags">Read</td>
914
<td class="property_type"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></td>
915
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title="The “supersedes” property">supersedes</a></td>
916
<td class="property_flags">Read</td>
919
<td class="property_type"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></td>
920
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title="The “uri-schemes” property">uri-schemes</a></td>
921
<td class="property_flags">Read</td>
924
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
925
<td class="property_name"><a class="link" href="telepathy-glib-account.html#TpAccount--valid" title="The “valid” property">valid</a></td>
926
<td class="property_flags">Read</td>
371
<pre class="synopsis">
372
"<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title='The "automatic-presence-type" property'>automatic-presence-type</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
373
"<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status" title='The "automatic-status" property'>automatic-status</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
374
"<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status-message" title='The "automatic-status-message" property'>automatic-status-message</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
375
"<a class="link" href="telepathy-glib-account.html#TpAccount--changing-presence" title='The "changing-presence" property'>changing-presence</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
376
"<a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title='The "cm-name" property'>cm-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
377
"<a class="link" href="telepathy-glib-account.html#TpAccount--connect-automatically" title='The "connect-automatically" property'>connect-automatically</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
378
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection" title='The "connection" property'>connection</a>" <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>* : Read
379
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title='The "connection-error" property'>connection-error</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
380
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title='The "connection-error-details" property'>connection-error-details</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>* : Read
381
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection-manager" title='The "connection-manager" property'>connection-manager</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
382
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title='The "connection-status" property'>connection-status</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
383
"<a class="link" href="telepathy-glib-account.html#TpAccount--connection-status-reason" title='The "connection-status-reason" property'>connection-status-reason</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
384
"<a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title='The "current-presence-type" property'>current-presence-type</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
385
"<a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title='The "current-status" property'>current-status</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
386
"<a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title='The "current-status-message" property'>current-status-message</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
387
"<a class="link" href="telepathy-glib-account.html#TpAccount--display-name" title='The "display-name" property'>display-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
388
"<a class="link" href="telepathy-glib-account.html#TpAccount--enabled" title='The "enabled" property'>enabled</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
389
"<a class="link" href="telepathy-glib-account.html#TpAccount--has-been-online" title='The "has-been-online" property'>has-been-online</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
390
"<a class="link" href="telepathy-glib-account.html#TpAccount--icon-name" title='The "icon-name" property'>icon-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
391
"<a class="link" href="telepathy-glib-account.html#TpAccount--nickname" title='The "nickname" property'>nickname</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
392
"<a class="link" href="telepathy-glib-account.html#TpAccount--normalized-name" title='The "normalized-name" property'>normalized-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
393
"<a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'>protocol</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
394
"<a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title='The "protocol-name" property'>protocol-name</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
395
"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title='The "requested-presence-type" property'>requested-presence-type</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
396
"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title='The "requested-status" property'>requested-status</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
397
"<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title='The "requested-status-message" property'>requested-status-message</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
398
"<a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'>service</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
399
"<a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier" title='The "storage-identifier" property'>storage-identifier</a>" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>* : Read
400
"<a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier-variant" title='The "storage-identifier-variant" property'>storage-identifier-variant</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>* : Read
401
"<a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'>storage-provider</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read
402
"<a class="link" href="telepathy-glib-account.html#TpAccount--storage-restrictions" title='The "storage-restrictions" property'>storage-restrictions</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read
403
"<a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title='The "supersedes" property'>supersedes</a>" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> : Read
404
"<a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title='The "uri-schemes" property'>uri-schemes</a>" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> : Read
405
"<a class="link" href="telepathy-glib-account.html#TpAccount--valid" title='The "valid" property'>valid</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
931
408
<div class="refsect1">
932
409
<a name="telepathy-glib-account.signals"></a><h2>Signals</h2>
933
<div class="informaltable"><table border="0">
935
<col width="150px" class="signals_return">
936
<col width="300px" class="signals_name">
937
<col width="200px" class="signals_flags">
941
<td class="signal_type"><span class="returnvalue">void</span></td>
942
<td class="signal_name"><a class="link" href="telepathy-glib-account.html#TpAccount-avatar-changed" title="The “avatar-changed” signal">avatar-changed</a></td>
943
<td class="signal_flags">Run Last</td>
946
<td class="signal_type"><span class="returnvalue">void</span></td>
947
<td class="signal_name"><a class="link" href="telepathy-glib-account.html#TpAccount-presence-changed" title="The “presence-changed” signal">presence-changed</a></td>
948
<td class="signal_flags">Run Last</td>
951
<td class="signal_type"><span class="returnvalue">void</span></td>
952
<td class="signal_name"><a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title="The “status-changed” signal">status-changed</a></td>
953
<td class="signal_flags">Run Last</td>
958
<a name="TpAccount"></a><div class="refsect1">
959
<a name="telepathy-glib-account.other"></a><h2>Types and Values</h2>
960
<div class="informaltable"><table width="100%" border="0">
962
<col width="150px" class="name">
963
<col class="description">
967
<td class="datatype_keyword"> </td>
968
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TpAccount-struct" title="TpAccount">TpAccount</a></td>
971
<td class="datatype_keyword">struct</td>
972
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TpAccountClass" title="struct TpAccountClass">TpAccountClass</a></td>
975
<td class="define_keyword">#define</td>
976
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CORE:CAPS" title="TP_ACCOUNT_FEATURE_CORE">TP_ACCOUNT_FEATURE_CORE</a></td>
979
<td class="define_keyword">#define</td>
980
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS" title="TP_ACCOUNT_FEATURE_CONNECTION">TP_ACCOUNT_FEATURE_CONNECTION</a></td>
983
<td class="define_keyword">#define</td>
984
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING">TP_ACCOUNT_FEATURE_ADDRESSING</a></td>
987
<td class="define_keyword">#define</td>
988
<td class="function_name"><a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE">TP_ACCOUNT_FEATURE_STORAGE</a></td>
993
<div class="refsect1">
994
<a name="telepathy-glib-account.object-hierarchy"></a><h2>Object Hierarchy</h2>
995
<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
996
<span class="lineart">╰──</span> <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
997
<span class="lineart">╰──</span> TpAccount
1000
<div class="refsect1">
1001
<a name="telepathy-glib-account.includes"></a><h2>Includes</h2>
1002
<pre class="synopsis">#include <telepathy-glib/telepathy-glib.h>
410
<pre class="synopsis">
411
"<a class="link" href="telepathy-glib-account.html#TpAccount-avatar-changed" title='The "avatar-changed" signal'>avatar-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
412
"<a class="link" href="telepathy-glib-account.html#TpAccount-presence-changed" title='The "presence-changed" signal'>presence-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
413
"<a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title='The "status-changed" signal'>status-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
1005
416
<div class="refsect1">
1006
417
<a name="telepathy-glib-account.description"></a><h2>Description</h2>
1007
<p>The Telepathy Account Manager stores the user's configured real-time
1008
communication accounts. The <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> object represents a stored account.</p>
419
The Telepathy Account Manager stores the user's configured real-time
420
communication accounts. The <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> object represents a stored account.
1010
423
<div class="refsect1">
1011
<a name="telepathy-glib-account.functions_details"></a><h2>Functions</h2>
1012
<div class="refsect2">
1013
<a name="tp-account-new"></a><h3>tp_account_new ()</h3>
1014
<pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> *
1015
tp_account_new (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,
1016
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1017
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1018
<div class="warning">
1019
<p><code class="literal">tp_account_new</code> is deprecated and should not be used in newly-written code.</p>
1020
<p>Use <a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-ensure-account" title="tp_simple_client_factory_ensure_account ()"><code class="function">tp_simple_client_factory_ensure_account()</code></a> instead.</p>
1022
<p>Convenience function to create a new account proxy. The returned <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1023
is not guaranteed to be ready at the point of return.</p>
1024
<div class="refsect3">
1025
<a name="id-1.4.46.11.2.6"></a><h4>Parameters</h4>
1026
<div class="informaltable"><table width="100%" border="0">
424
<a name="telepathy-glib-account.details"></a><h2>Details</h2>
425
<div class="refsect2">
426
<a name="TpAccount-struct"></a><h3>TpAccount</h3>
427
<pre class="programlisting">typedef struct _TpAccount TpAccount;</pre>
429
The Telepathy Account Manager stores the user's configured real-time
430
communication accounts. This object represents a stored account.
433
If this account is deleted from the account manager, the
434
<a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title='The "invalidated" signal'><span class="type">"invalidated"</span></a> signal will be emitted
435
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
436
<a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED:CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a>.
439
One can connect to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal to get change notifications
440
for many of the properties on this object. Refer to each property's
441
documentation for whether it can be used in this way.
444
<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> objects should normally be obtained from the <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>.
447
Since 0.16, <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> always has a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title='The "factory" property'><span class="type">"factory"</span></a>, and its
448
<a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title='The "factory" property'><span class="type">"factory"</span></a> will be propagated to its <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
449
(if any). If a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> is created without going via the
450
<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> or specifying a <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title='The "factory" property'><span class="type">"factory"</span></a>, the default
451
is to use a new <a class="link" href="telepathy-glib-automatic-client-factory.html#TpAutomaticClientFactory"><span class="type">TpAutomaticClientFactory</span></a>.
453
<p class="since">Since 0.7.32</p>
456
<div class="refsect2">
457
<a name="TpAccountClass"></a><h3>struct TpAccountClass</h3>
458
<pre class="programlisting">struct TpAccountClass {
462
The class of a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.
466
<div class="refsect2">
467
<a name="tp-account-new"></a><h3>tp_account_new ()</h3>
468
<pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> * tp_account_new (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,
469
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
470
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
471
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
472
<h3 class="title">Warning</h3>
473
<p><code class="literal">tp_account_new</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-ensure-account" title="tp_simple_client_factory_ensure_account ()"><code class="function">tp_simple_client_factory_ensure_account()</code></a> instead.</p>
476
Convenience function to create a new account proxy. The returned <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
477
is not guaranteed to be ready at the point of return.
479
<div class="variablelist"><table border="0" class="variablelist">
1028
<col width="150px" class="parameters_name">
1029
<col class="parameters_description">
1030
<col width="200px" class="parameters_annotations">
481
<col align="left" valign="top">
1034
<td class="parameter_name"><p>bus_daemon</p></td>
1035
<td class="parameter_description"><p>Proxy for the D-Bus daemon</p></td>
1036
<td class="parameter_annotations"> </td>
1039
<td class="parameter_name"><p>object_path</p></td>
1040
<td class="parameter_description"><p>The non-NULL object path of this account</p></td>
1041
<td class="parameter_annotations"> </td>
1044
<td class="parameter_name"><p>error</p></td>
1045
<td class="parameter_description"><p>Used to raise an error if <em class="parameter"><code>object_path</code></em>
1046
is not valid</p></td>
1047
<td class="parameter_annotations"> </td>
486
<td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
487
<td>Proxy for the D-Bus daemon</td>
490
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
491
<td>The non-NULL object path of this account</td>
494
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
495
<td>Used to raise an error if <em class="parameter"><code>object_path</code></em> is not valid</td>
498
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
499
<td>a new reference to an account proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>object_path</code></em> is
1052
<div class="refsect3">
1053
<a name="id-1.4.46.11.2.7"></a><h4>Returns</h4>
1054
<p> a new reference to an account proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>object_path</code></em>
1061
506
<div class="refsect2">
1062
<a name="tp-account-init-known-interfaces"></a><h3>tp_account_init_known_interfaces ()</h3>
1063
<pre class="programlisting"><span class="returnvalue">void</span>
1064
tp_account_init_known_interfaces (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1065
<p>Ensure that the known interfaces for TpAccount have been set up.
507
<a name="tp-account-init-known-interfaces"></a><h3>tp_account_init_known_interfaces ()</h3>
508
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_init_known_interfaces (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
510
Ensure that the known interfaces for TpAccount have been set up.
1066
511
This is done automatically when necessary, but for correct
1067
512
overriding of library interfaces by local extensions, you should
1068
513
call this function before calling
1069
<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
1070
<code class="literal">TP_TYPE_ACCOUNT</code>.</p>
514
<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
515
<code class="literal">TP_TYPE_ACCOUNT</code>.
1071
517
<p class="since">Since 0.7.32</p>
1074
520
<div class="refsect2">
1075
<a name="tp-account-parse-object-path"></a><h3>tp_account_parse_object_path ()</h3>
1076
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1077
tp_account_parse_object_path (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
1078
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **cm</code></em>,
1079
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **protocol</code></em>,
1080
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **account_id</code></em>,
1081
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1082
<div class="warning">
1083
<p><code class="literal">tp_account_parse_object_path</code> is deprecated and should not be used in newly-written code.</p>
1084
<p>Use <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()"><code class="function">tp_account_get_protocol()</code></a> and
1085
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()"><code class="function">tp_account_get_connection_manager()</code></a> instead.</p>
521
<a name="tp-account-parse-object-path"></a><h3>tp_account_parse_object_path ()</h3>
522
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_parse_object_path (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
523
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **cm</code></em>,
524
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **protocol</code></em>,
525
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **account_id</code></em>,
526
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
527
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
528
<h3 class="title">Warning</h3>
529
<p><code class="literal">tp_account_parse_object_path</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()"><code class="function">tp_account_get_protocol()</code></a> and
530
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()"><code class="function">tp_account_get_connection_manager()</code></a> instead.</p>
1087
<p>Validates and parses a Telepathy Account's object path, extracting the
533
Validates and parses a Telepathy Account's object path, extracting the
1088
534
connection manager's name, the protocol, and the account's unique identifier
1089
535
from the path. This includes replacing underscores with hyphens in the
1090
protocol name, as defined in the Account specification.</p>
1091
<p>Any of the out parameters may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not needed. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned,
536
protocol name, as defined in the Account specification.
539
Any of the out parameters may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not needed. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned,
1092
540
the caller is responsible for freeing the strings stored in any non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1093
out parameters, using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
1094
<div class="refsect3">
1095
<a name="id-1.4.46.11.4.8"></a><h4>Parameters</h4>
1096
<div class="informaltable"><table width="100%" border="0">
541
out parameters, using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
543
<div class="variablelist"><table border="0" class="variablelist">
1098
<col width="150px" class="parameters_name">
1099
<col class="parameters_description">
1100
<col width="200px" class="parameters_annotations">
545
<col align="left" valign="top">
1104
<td class="parameter_name"><p>object_path</p></td>
1105
<td class="parameter_description"><p>a Telepathy Account's object path</p></td>
1106
<td class="parameter_annotations"> </td>
1109
<td class="parameter_name"><p>cm</p></td>
1110
<td class="parameter_description"><p> location at which to store the account's
1111
connection manager's name. </p></td>
1112
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1115
<td class="parameter_name"><p>protocol</p></td>
1116
<td class="parameter_description"><p> location at which to store the account's
1118
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1121
<td class="parameter_name"><p>account_id</p></td>
1122
<td class="parameter_description"><p> location at which to store the account's
1123
unique identifier. </p></td>
1124
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1127
<td class="parameter_name"><p>error</p></td>
1128
<td class="parameter_description"><p>location at which to return an error</p></td>
1129
<td class="parameter_annotations"> </td>
550
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
551
<td>a Telepathy Account's object path</td>
554
<td><p><span class="term"><em class="parameter"><code>cm</code></em> :</span></p></td>
555
<td>location at which to store the account's
556
connection manager's name. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
560
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
561
<td>location at which to store the account's
562
protocol. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
566
<td><p><span class="term"><em class="parameter"><code>account_id</code></em> :</span></p></td>
567
<td>location at which to store the account's
568
unique identifier. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
572
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
573
<td>location at which to return an error</td>
576
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
578
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object_path</code></em> was successfully parsed; <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and sets
579
<em class="parameter"><code>error</code></em> otherwise.</td>
1134
<div class="refsect3">
1135
<a name="id-1.4.46.11.4.9"></a><h4>Returns</h4>
1136
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>object_path</code></em>
1137
was successfully parsed; <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and sets
1138
<em class="parameter"><code>error</code></em>
1142
583
<p class="since">Since 0.9.0</p>
1145
586
<div class="refsect2">
1146
<a name="tp-account-get-path-suffix"></a><h3>tp_account_get_path_suffix ()</h3>
1147
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1148
tp_account_get_path_suffix (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1149
<p>Returns the portion of <em class="parameter"><code>account</code></em>
1150
's object path after the standard
587
<a name="tp-account-get-path-suffix"></a><h3>tp_account_get_path_suffix ()</h3>
588
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_path_suffix (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
590
Returns the portion of <em class="parameter"><code>account</code></em>'s object path after the standard
1151
591
<a class="link" href="telepathy-glib-defs.html#TP-ACCOUNT-OBJECT-PATH-BASE:CAPS" title="TP_ACCOUNT_OBJECT_PATH_BASE"><span class="type">TP_ACCOUNT_OBJECT_PATH_BASE</span></a> prefix, of the form "cm/protocol/acct". This
1152
string uniquely identifies the account.</p>
1153
<p>This function is only intended to be used when printing debug messages or in
592
string uniquely identifies the account.
595
This function is only intended to be used when printing debug messages or in
1154
596
tools for developer. For a string suitable for displaying to the user, see
1155
<a class="link" href="telepathy-glib-account.html#tp-account-get-display-name" title="tp_account_get_display_name ()"><code class="function">tp_account_get_display_name()</code></a>. To retrieve the connection manager and
597
<a class="link" href="telepathy-glib-account.html#tp-account-get-display-name" title="tp_account_get_display_name ()"><code class="function">tp_account_get_display_name()</code></a>. To retrieve the connection manager and
1156
598
protocol name parts of the object path, see
1157
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()"><code class="function">tp_account_get_connection_manager()</code></a> and <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()"><code class="function">tp_account_get_protocol()</code></a>. For
1158
persistent identification of the account, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-get-object-path" title="tp_proxy_get_object_path ()"><code class="function">tp_proxy_get_object_path()</code></a>.</p>
1159
<div class="refsect3">
1160
<a name="id-1.4.46.11.5.6"></a><h4>Parameters</h4>
1161
<div class="informaltable"><table width="100%" border="0">
599
<a class="link" href="telepathy-glib-account.html#tp-account-get-connection-manager" title="tp_account_get_connection_manager ()"><code class="function">tp_account_get_connection_manager()</code></a> and <a class="link" href="telepathy-glib-account.html#tp-account-get-protocol" title="tp_account_get_protocol ()"><code class="function">tp_account_get_protocol()</code></a>. For
600
persistent identification of the account, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-get-object-path" title="tp_proxy_get_object_path ()"><code class="function">tp_proxy_get_object_path()</code></a>.
602
<div class="variablelist"><table border="0" class="variablelist">
1163
<col width="150px" class="parameters_name">
1164
<col class="parameters_description">
1165
<col width="200px" class="parameters_annotations">
604
<col align="left" valign="top">
1168
<td class="parameter_name"><p>account</p></td>
1169
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1170
<td class="parameter_annotations"> </td>
609
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
610
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
614
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
615
<td>a suffix of <em class="parameter"><code>account</code></em>'s object path, for debugging purposes.</td>
1174
<div class="refsect3">
1175
<a name="id-1.4.46.11.5.7"></a><h4>Returns</h4>
1176
<p> a suffix of <em class="parameter"><code>account</code></em>
1177
's object path, for debugging purposes.</p>
1180
619
<p class="since">Since 0.13.9</p>
1183
622
<div class="refsect2">
1184
<a name="tp-account-get-connection"></a><h3>tp_account_get_connection ()</h3>
1185
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *
1186
tp_account_get_connection (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1188
<div class="refsect3">
1189
<a name="id-1.4.46.11.6.5"></a><h4>Parameters</h4>
1190
<div class="informaltable"><table width="100%" border="0">
623
<a name="tp-account-get-connection"></a><h3>tp_account_get_connection ()</h3>
624
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> * tp_account_get_connection (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
628
<div class="variablelist"><table border="0" class="variablelist">
1192
<col width="150px" class="parameters_name">
1193
<col class="parameters_description">
1194
<col width="200px" class="parameters_annotations">
630
<col align="left" valign="top">
1197
<td class="parameter_name"><p>account</p></td>
1198
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1199
<td class="parameter_annotations"> </td>
635
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
636
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
640
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
641
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection" title='The "connection" property'><span class="type">"connection"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1203
<div class="refsect3">
1204
<a name="id-1.4.46.11.6.6"></a><h4>Returns</h4>
1205
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection" title="The “connection” property"><span class="type">“connection”</span></a> property. </p>
1206
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1208
646
<p class="since">Since 0.9.0</p>
1211
649
<div class="refsect2">
1212
<a name="tp-account-ensure-connection"></a><h3>tp_account_ensure_connection ()</h3>
1213
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *
1214
tp_account_ensure_connection (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1215
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
1216
<div class="warning">
1217
<p><code class="literal">tp_account_ensure_connection</code> is deprecated and should not be used in newly-written code.</p>
1218
<p>New code should use <a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-ensure-connection" title="tp_simple_client_factory_ensure_connection ()"><code class="function">tp_simple_client_factory_ensure_connection()</code></a>
650
<a name="tp-account-ensure-connection"></a><h3>tp_account_ensure_connection ()</h3>
651
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> * tp_account_ensure_connection (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
652
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
653
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
654
<h3 class="title">Warning</h3>
655
<p><code class="literal">tp_account_ensure_connection</code> is deprecated and should not be used in newly-written code. New code should use <a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-ensure-connection" title="tp_simple_client_factory_ensure_connection ()"><code class="function">tp_simple_client_factory_ensure_connection()</code></a>
1221
<p>Set the connection of the account by specifying the connection object path.
659
Set the connection of the account by specifying the connection object path.
1222
660
This function does not return a new ref and it is not guaranteed that the
1223
returned <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> object is ready.</p>
1224
<p>The use-case for this function is in a HandleChannels callback and you
661
returned <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> object is ready.
664
The use-case for this function is in a HandleChannels callback and you
1225
665
already know the object path for the connection, so you can let <em class="parameter"><code>account</code></em>
1227
create its <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> and return it for use.</p>
1228
<div class="refsect3">
1229
<a name="id-1.4.46.11.7.8"></a><h4>Parameters</h4>
1230
<div class="informaltable"><table width="100%" border="0">
1232
<col width="150px" class="parameters_name">
1233
<col class="parameters_description">
1234
<col width="200px" class="parameters_annotations">
1238
<td class="parameter_name"><p>account</p></td>
1239
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1240
<td class="parameter_annotations"> </td>
1243
<td class="parameter_name"><p>path</p></td>
1244
<td class="parameter_description"><p>the path to connection object for <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1245
<td class="parameter_annotations"> </td>
1250
<div class="refsect3">
1251
<a name="id-1.4.46.11.7.9"></a><h4>Returns</h4>
1252
<p> the connection of the account, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if either
1253
the object path <em class="parameter"><code>path</code></em>
1254
is invalid or it is the null-value "/". </p>
1255
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1257
<p class="since">Since 0.9.0</p>
1260
<div class="refsect2">
1261
<a name="tp-account-get-display-name"></a><h3>tp_account_get_display_name ()</h3>
1262
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1263
tp_account_get_display_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1265
<div class="refsect3">
1266
<a name="id-1.4.46.11.8.5"></a><h4>Parameters</h4>
1267
<div class="informaltable"><table width="100%" border="0">
1269
<col width="150px" class="parameters_name">
1270
<col class="parameters_description">
1271
<col width="200px" class="parameters_annotations">
1274
<td class="parameter_name"><p>account</p></td>
1275
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1276
<td class="parameter_annotations"> </td>
1280
<div class="refsect3">
1281
<a name="id-1.4.46.11.8.6"></a><h4>Returns</h4>
1282
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--display-name" title="The “display-name” property"><span class="type">“display-name”</span></a> property</p>
1285
<p class="since">Since 0.9.0</p>
1288
<div class="refsect2">
1289
<a name="tp-account-get-connection-manager"></a><h3>tp_account_get_connection_manager ()</h3>
1290
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1291
tp_account_get_connection_manager (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1292
<div class="warning">
1293
<p><code class="literal">tp_account_get_connection_manager</code> is deprecated and should not be used in newly-written code.</p>
1294
<p>Use <a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()"><code class="function">tp_account_get_cm_name()</code></a> instead.</p>
1297
<div class="refsect3">
1298
<a name="id-1.4.46.11.9.7"></a><h4>Parameters</h4>
1299
<div class="informaltable"><table width="100%" border="0">
1301
<col width="150px" class="parameters_name">
1302
<col class="parameters_description">
1303
<col width="200px" class="parameters_annotations">
1306
<td class="parameter_name"><p>account</p></td>
1307
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1308
<td class="parameter_annotations"> </td>
1312
<div class="refsect3">
1313
<a name="id-1.4.46.11.9.8"></a><h4>Returns</h4>
1314
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-manager" title="The “connection-manager” property"><span class="type">“connection-manager”</span></a> property</p>
1317
<p class="since">Since 0.9.0</p>
1320
<div class="refsect2">
1321
<a name="tp-account-get-cm-name"></a><h3>tp_account_get_cm_name ()</h3>
1322
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1323
tp_account_get_cm_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1325
<div class="refsect3">
1326
<a name="id-1.4.46.11.10.5"></a><h4>Parameters</h4>
1327
<div class="informaltable"><table width="100%" border="0">
1329
<col width="150px" class="parameters_name">
1330
<col class="parameters_description">
1331
<col width="200px" class="parameters_annotations">
1334
<td class="parameter_name"><p>account</p></td>
1335
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1336
<td class="parameter_annotations"> </td>
1340
<div class="refsect3">
1341
<a name="id-1.4.46.11.10.6"></a><h4>Returns</h4>
1342
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title="The “cm-name” property"><span class="type">“cm-name”</span></a> property</p>
1345
<p class="since">Since 0.19.3</p>
1348
<div class="refsect2">
1349
<a name="tp-account-get-protocol"></a><h3>tp_account_get_protocol ()</h3>
1350
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1351
tp_account_get_protocol (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1352
<div class="warning">
1353
<p><code class="literal">tp_account_get_protocol</code> is deprecated and should not be used in newly-written code.</p>
1354
<p>Use <a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()"><code class="function">tp_account_get_cm_name()</code></a> instead.</p>
1357
<div class="refsect3">
1358
<a name="id-1.4.46.11.11.7"></a><h4>Parameters</h4>
1359
<div class="informaltable"><table width="100%" border="0">
1361
<col width="150px" class="parameters_name">
1362
<col class="parameters_description">
1363
<col width="200px" class="parameters_annotations">
1366
<td class="parameter_name"><p>account</p></td>
1367
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1368
<td class="parameter_annotations"> </td>
1372
<div class="refsect3">
1373
<a name="id-1.4.46.11.11.8"></a><h4>Returns</h4>
1374
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title="The “protocol” property"><span class="type">“protocol”</span></a> property</p>
1377
<p class="since">Since 0.9.0</p>
1380
<div class="refsect2">
1381
<a name="tp-account-get-protocol-name"></a><h3>tp_account_get_protocol_name ()</h3>
1382
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1383
tp_account_get_protocol_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1385
<div class="refsect3">
1386
<a name="id-1.4.46.11.12.5"></a><h4>Parameters</h4>
1387
<div class="informaltable"><table width="100%" border="0">
1389
<col width="150px" class="parameters_name">
1390
<col class="parameters_description">
1391
<col width="200px" class="parameters_annotations">
1394
<td class="parameter_name"><p>account</p></td>
1395
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1396
<td class="parameter_annotations"> </td>
1400
<div class="refsect3">
1401
<a name="id-1.4.46.11.12.6"></a><h4>Returns</h4>
1402
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title="The “protocol-name” property"><span class="type">“protocol-name”</span></a> property</p>
1405
<p class="since">Since 0.19.3</p>
1408
<div class="refsect2">
1409
<a name="tp-account-get-icon-name"></a><h3>tp_account_get_icon_name ()</h3>
1410
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1411
tp_account_get_icon_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1413
<div class="refsect3">
1414
<a name="id-1.4.46.11.13.5"></a><h4>Parameters</h4>
1415
<div class="informaltable"><table width="100%" border="0">
1417
<col width="150px" class="parameters_name">
1418
<col class="parameters_description">
1419
<col width="200px" class="parameters_annotations">
1422
<td class="parameter_name"><p>account</p></td>
1423
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1424
<td class="parameter_annotations"> </td>
1428
<div class="refsect3">
1429
<a name="id-1.4.46.11.13.6"></a><h4>Returns</h4>
1430
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a> property</p>
1433
<p class="since">Since 0.9.0</p>
1436
<div class="refsect2">
1437
<a name="tp-account-get-service"></a><h3>tp_account_get_service ()</h3>
1438
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1439
tp_account_get_service (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
1441
<div class="refsect3">
1442
<a name="id-1.4.46.11.14.5"></a><h4>Parameters</h4>
1443
<div class="informaltable"><table width="100%" border="0">
1445
<col width="150px" class="parameters_name">
1446
<col class="parameters_description">
1447
<col width="200px" class="parameters_annotations">
1450
<td class="parameter_name"><p>self</p></td>
1451
<td class="parameter_description"><p>an account</p></td>
1452
<td class="parameter_annotations"> </td>
1456
<div class="refsect3">
1457
<a name="id-1.4.46.11.14.6"></a><h4>Returns</h4>
1458
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title="The “service” property"><span class="type">“service”</span></a> property</p>
666
create its <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> and return it for use.
668
<div class="variablelist"><table border="0" class="variablelist">
670
<col align="left" valign="top">
675
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
676
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
680
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
681
<td>the path to connection object for <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
685
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
686
<td>the connection of the account, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if either
687
the object path <em class="parameter"><code>path</code></em> is invalid or it is the null-value "/". <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
692
<p class="since">Since 0.9.0</p>
695
<div class="refsect2">
696
<a name="tp-account-get-display-name"></a><h3>tp_account_get_display_name ()</h3>
697
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_display_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
701
<div class="variablelist"><table border="0" class="variablelist">
703
<col align="left" valign="top">
708
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
709
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
713
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
714
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--display-name" title='The "display-name" property'><span class="type">"display-name"</span></a> property</td>
718
<p class="since">Since 0.9.0</p>
721
<div class="refsect2">
722
<a name="tp-account-get-connection-manager"></a><h3>tp_account_get_connection_manager ()</h3>
723
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_connection_manager (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
724
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
725
<h3 class="title">Warning</h3>
726
<p><code class="literal">tp_account_get_connection_manager</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()"><code class="function">tp_account_get_cm_name()</code></a> instead.</p>
731
<div class="variablelist"><table border="0" class="variablelist">
733
<col align="left" valign="top">
738
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
739
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
743
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
744
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-manager" title='The "connection-manager" property'><span class="type">"connection-manager"</span></a> property</td>
748
<p class="since">Since 0.9.0</p>
751
<div class="refsect2">
752
<a name="tp-account-get-cm-name"></a><h3>tp_account_get_cm_name ()</h3>
753
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_cm_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
757
<div class="variablelist"><table border="0" class="variablelist">
759
<col align="left" valign="top">
764
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
765
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
769
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
770
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title='The "cm-name" property'><span class="type">"cm-name"</span></a> property</td>
774
<p class="since">Since 0.19.3</p>
777
<div class="refsect2">
778
<a name="tp-account-get-protocol"></a><h3>tp_account_get_protocol ()</h3>
779
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_protocol (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
780
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
781
<h3 class="title">Warning</h3>
782
<p><code class="literal">tp_account_get_protocol</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-account.html#tp-account-get-cm-name" title="tp_account_get_cm_name ()"><code class="function">tp_account_get_cm_name()</code></a> instead.</p>
787
<div class="variablelist"><table border="0" class="variablelist">
789
<col align="left" valign="top">
794
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
795
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
799
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
800
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'><span class="type">"protocol"</span></a> property</td>
804
<p class="since">Since 0.9.0</p>
807
<div class="refsect2">
808
<a name="tp-account-get-protocol-name"></a><h3>tp_account_get_protocol_name ()</h3>
809
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_protocol_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
813
<div class="variablelist"><table border="0" class="variablelist">
815
<col align="left" valign="top">
820
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
821
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
825
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
826
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title='The "protocol-name" property'><span class="type">"protocol-name"</span></a> property</td>
830
<p class="since">Since 0.19.3</p>
833
<div class="refsect2">
834
<a name="tp-account-get-icon-name"></a><h3>tp_account_get_icon_name ()</h3>
835
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_icon_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
839
<div class="variablelist"><table border="0" class="variablelist">
841
<col align="left" valign="top">
846
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
847
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
851
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
852
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--icon-name" title='The "icon-name" property'><span class="type">"icon-name"</span></a> property</td>
856
<p class="since">Since 0.9.0</p>
859
<div class="refsect2">
860
<a name="tp-account-get-service"></a><h3>tp_account_get_service ()</h3>
861
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_service (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
865
<div class="variablelist"><table border="0" class="variablelist">
867
<col align="left" valign="top">
872
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
876
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
877
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'><span class="type">"service"</span></a> property</td>
1461
881
<p class="since">Since 0.11.9</p>
1464
884
<div class="refsect2">
1465
<a name="tp-account-set-enabled-async"></a><h3>tp_account_set_enabled_async ()</h3>
1466
<pre class="programlisting"><span class="returnvalue">void</span>
1467
tp_account_set_enabled_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1468
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
1469
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1470
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1471
<p>Requests an asynchronous set of the Enabled property of <em class="parameter"><code>account</code></em>
1473
operation is finished, <em class="parameter"><code>callback</code></em>
1474
will be called. You can then call
1475
<a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-finish" title="tp_account_set_enabled_finish ()"><code class="function">tp_account_set_enabled_finish()</code></a> to get the result of the operation.</p>
1476
<div class="refsect3">
1477
<a name="id-1.4.46.11.15.5"></a><h4>Parameters</h4>
1478
<div class="informaltable"><table width="100%" border="0">
1480
<col width="150px" class="parameters_name">
1481
<col class="parameters_description">
1482
<col width="200px" class="parameters_annotations">
1486
<td class="parameter_name"><p>account</p></td>
1487
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1488
<td class="parameter_annotations"> </td>
1491
<td class="parameter_name"><p>enabled</p></td>
1492
<td class="parameter_description"><p>the new enabled value of <em class="parameter"><code>account</code></em>
1494
<td class="parameter_annotations"> </td>
1497
<td class="parameter_name"><p>callback</p></td>
1498
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
1499
<td class="parameter_annotations"> </td>
1502
<td class="parameter_name"><p>user_data</p></td>
1503
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
1505
<td class="parameter_annotations"> </td>
1510
<p class="since">Since 0.9.0</p>
1513
<div class="refsect2">
1514
<a name="tp-account-set-enabled-finish"></a><h3>tp_account_set_enabled_finish ()</h3>
1515
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1516
tp_account_set_enabled_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1517
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1518
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1519
<p>Finishes an async set of the Enabled property.</p>
1520
<div class="refsect3">
1521
<a name="id-1.4.46.11.16.5"></a><h4>Parameters</h4>
1522
<div class="informaltable"><table width="100%" border="0">
1524
<col width="150px" class="parameters_name">
1525
<col class="parameters_description">
1526
<col width="200px" class="parameters_annotations">
1530
<td class="parameter_name"><p>account</p></td>
1531
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1532
<td class="parameter_annotations"> </td>
1535
<td class="parameter_name"><p>result</p></td>
1536
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
1537
<td class="parameter_annotations"> </td>
1540
<td class="parameter_name"><p>error</p></td>
1541
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
1542
<td class="parameter_annotations"> </td>
1547
<div class="refsect3">
1548
<a name="id-1.4.46.11.16.6"></a><h4>Returns</h4>
1549
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the set was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
1552
<p class="since">Since 0.9.0</p>
1555
<div class="refsect2">
1556
<a name="tp-account-reconnect-async"></a><h3>tp_account_reconnect_async ()</h3>
1557
<pre class="programlisting"><span class="returnvalue">void</span>
1558
tp_account_reconnect_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1559
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1560
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1561
<p>Requests an asynchronous reconnect of <em class="parameter"><code>account</code></em>
1562
. When the operation is
1563
finished, <em class="parameter"><code>callback</code></em>
1564
will be called. You can then call
1565
<a class="link" href="telepathy-glib-account.html#tp-account-reconnect-finish" title="tp_account_reconnect_finish ()"><code class="function">tp_account_reconnect_finish()</code></a> to get the result of the operation.</p>
1566
<div class="refsect3">
1567
<a name="id-1.4.46.11.17.5"></a><h4>Parameters</h4>
1568
<div class="informaltable"><table width="100%" border="0">
1570
<col width="150px" class="parameters_name">
1571
<col class="parameters_description">
1572
<col width="200px" class="parameters_annotations">
1576
<td class="parameter_name"><p>account</p></td>
1577
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1578
<td class="parameter_annotations"> </td>
1581
<td class="parameter_name"><p>callback</p></td>
1582
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
1583
<td class="parameter_annotations"> </td>
1586
<td class="parameter_name"><p>user_data</p></td>
1587
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
1589
<td class="parameter_annotations"> </td>
1594
<p class="since">Since 0.9.0</p>
1597
<div class="refsect2">
1598
<a name="tp-account-reconnect-finish"></a><h3>tp_account_reconnect_finish ()</h3>
1599
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1600
tp_account_reconnect_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1601
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1602
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1603
<p>Finishes an async reconnect of <em class="parameter"><code>account</code></em>
1605
<div class="refsect3">
1606
<a name="id-1.4.46.11.18.5"></a><h4>Parameters</h4>
1607
<div class="informaltable"><table width="100%" border="0">
1609
<col width="150px" class="parameters_name">
1610
<col class="parameters_description">
1611
<col width="200px" class="parameters_annotations">
1615
<td class="parameter_name"><p>account</p></td>
1616
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1617
<td class="parameter_annotations"> </td>
1620
<td class="parameter_name"><p>result</p></td>
1621
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
1622
<td class="parameter_annotations"> </td>
1625
<td class="parameter_name"><p>error</p></td>
1626
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to be filled</p></td>
1627
<td class="parameter_annotations"> </td>
1632
<div class="refsect3">
1633
<a name="id-1.4.46.11.18.6"></a><h4>Returns</h4>
1634
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the reconnect call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
1637
<p class="since">Since 0.9.0</p>
1640
<div class="refsect2">
1641
<a name="tp-account-is-enabled"></a><h3>tp_account_is_enabled ()</h3>
1642
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1643
tp_account_is_enabled (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1645
<div class="refsect3">
1646
<a name="id-1.4.46.11.19.5"></a><h4>Parameters</h4>
1647
<div class="informaltable"><table width="100%" border="0">
1649
<col width="150px" class="parameters_name">
1650
<col class="parameters_description">
1651
<col width="200px" class="parameters_annotations">
1654
<td class="parameter_name"><p>account</p></td>
1655
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1656
<td class="parameter_annotations"> </td>
1660
<div class="refsect3">
1661
<a name="id-1.4.46.11.19.6"></a><h4>Returns</h4>
1662
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--enabled" title="The “enabled” property"><span class="type">“enabled”</span></a> property</p>
1665
<p class="since">Since 0.9.0</p>
1668
<div class="refsect2">
1669
<a name="tp-account-is-valid"></a><h3>tp_account_is_valid ()</h3>
1670
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1671
tp_account_is_valid (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1673
<div class="refsect3">
1674
<a name="id-1.4.46.11.20.5"></a><h4>Parameters</h4>
1675
<div class="informaltable"><table width="100%" border="0">
1677
<col width="150px" class="parameters_name">
1678
<col class="parameters_description">
1679
<col width="200px" class="parameters_annotations">
1682
<td class="parameter_name"><p>account</p></td>
1683
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1684
<td class="parameter_annotations"> </td>
1688
<div class="refsect3">
1689
<a name="id-1.4.46.11.20.6"></a><h4>Returns</h4>
1690
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--valid" title="The “valid” property"><span class="type">“valid”</span></a> property</p>
1693
<p class="since">Since 0.9.0</p>
1696
<div class="refsect2">
1697
<a name="tp-account-update-parameters-async"></a><h3>tp_account_update_parameters_async ()</h3>
1698
<pre class="programlisting"><span class="returnvalue">void</span>
1699
tp_account_update_parameters_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1700
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *parameters</code></em>,
1701
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
1702
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1703
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1704
<p>Requests an asynchronous update of parameters of <em class="parameter"><code>account</code></em>
1706
operation is finished, <em class="parameter"><code>callback</code></em>
1707
will be called. You can then call
1708
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()"><code class="function">tp_account_update_parameters_finish()</code></a> to get the result of the operation.</p>
1709
<div class="refsect3">
1710
<a name="id-1.4.46.11.21.5"></a><h4>Parameters</h4>
1711
<div class="informaltable"><table width="100%" border="0">
1713
<col width="150px" class="parameters_name">
1714
<col class="parameters_description">
1715
<col width="200px" class="parameters_annotations">
1719
<td class="parameter_name"><p>account</p></td>
1720
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1721
<td class="parameter_annotations"> </td>
1724
<td class="parameter_name"><p>parameters</p></td>
1725
<td class="parameter_description"><p> new
1726
parameters to set on <em class="parameter"><code>account</code></em>
1728
<td class="parameter_annotations"><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1731
<td class="parameter_name"><p>unset_parameters</p></td>
1732
<td class="parameter_description"><p>list of parameters to unset on <em class="parameter"><code>account</code></em>
1734
<td class="parameter_annotations"> </td>
1737
<td class="parameter_name"><p>callback</p></td>
1738
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
1739
<td class="parameter_annotations"> </td>
1742
<td class="parameter_name"><p>user_data</p></td>
1743
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
1745
<td class="parameter_annotations"> </td>
1750
<p class="since">Since 0.9.0</p>
1753
<div class="refsect2">
1754
<a name="tp-account-update-parameters-finish"></a><h3>tp_account_update_parameters_finish ()</h3>
1755
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1756
tp_account_update_parameters_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1757
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1758
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
1759
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1760
<p>Finishes an async update of the parameters on <em class="parameter"><code>account</code></em>
1762
<div class="refsect3">
1763
<a name="id-1.4.46.11.22.5"></a><h4>Parameters</h4>
1764
<div class="informaltable"><table width="100%" border="0">
1766
<col width="150px" class="parameters_name">
1767
<col class="parameters_description">
1768
<col width="200px" class="parameters_annotations">
1772
<td class="parameter_name"><p>account</p></td>
1773
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1774
<td class="parameter_annotations"> </td>
1777
<td class="parameter_name"><p>result</p></td>
1778
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
1779
<td class="parameter_annotations"> </td>
1782
<td class="parameter_name"><p>reconnect_required</p></td>
1783
<td class="parameter_description"><p> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> to
1784
fill with properties that need a reconnect to take effect. </p></td>
1785
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1788
<td class="parameter_name"><p>error</p></td>
1789
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
1790
<td class="parameter_annotations"> </td>
1795
<div class="refsect3">
1796
<a name="id-1.4.46.11.22.6"></a><h4>Returns</h4>
1797
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the request succeeded, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
1800
<p class="since">Since 0.9.0</p>
1803
<div class="refsect2">
1804
<a name="tp-account-update-parameters-vardict-async"></a><h3>tp_account_update_parameters_vardict_async ()</h3>
1805
<pre class="programlisting"><span class="returnvalue">void</span>
1806
tp_account_update_parameters_vardict_async
1807
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1808
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1809
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
1810
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1811
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1812
<p>Requests an asynchronous update of parameters of <em class="parameter"><code>account</code></em>
1814
operation is finished, <em class="parameter"><code>callback</code></em>
1815
will be called. You can then call
1816
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()"><code class="function">tp_account_update_parameters_finish()</code></a> to get the result of the operation.</p>
1817
<p>If <em class="parameter"><code>parameters</code></em>
1818
is a floating reference (see <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-ref-sink"><code class="function">g_variant_ref_sink()</code></a>),
1819
ownership of <em class="parameter"><code>parameters</code></em>
1820
is taken by this function. This means
885
<a name="tp-account-set-enabled-async"></a><h3>tp_account_set_enabled_async ()</h3>
886
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_enabled_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
887
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>,
888
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
889
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
891
Requests an asynchronous set of the Enabled property of <em class="parameter"><code>account</code></em>. When the
892
operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
893
<a class="link" href="telepathy-glib-account.html#tp-account-set-enabled-finish" title="tp_account_set_enabled_finish ()"><code class="function">tp_account_set_enabled_finish()</code></a> to get the result of the operation.
895
<div class="variablelist"><table border="0" class="variablelist">
897
<col align="left" valign="top">
902
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
903
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
907
<td><p><span class="term"><em class="parameter"><code>enabled</code></em> :</span></p></td>
908
<td>the new enabled value of <em class="parameter"><code>account</code></em>
912
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
913
<td>a callback to call when the request is satisfied</td>
916
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
917
<td>data to pass to <em class="parameter"><code>callback</code></em>
922
<p class="since">Since 0.9.0</p>
925
<div class="refsect2">
926
<a name="tp-account-set-enabled-finish"></a><h3>tp_account_set_enabled_finish ()</h3>
927
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_enabled_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
928
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
929
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
931
Finishes an async set of the Enabled property.
933
<div class="variablelist"><table border="0" class="variablelist">
935
<col align="left" valign="top">
940
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
941
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
945
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
946
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
950
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
951
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
954
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
956
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the set was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
961
<p class="since">Since 0.9.0</p>
964
<div class="refsect2">
965
<a name="tp-account-reconnect-async"></a><h3>tp_account_reconnect_async ()</h3>
966
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_reconnect_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
967
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
968
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
970
Requests an asynchronous reconnect of <em class="parameter"><code>account</code></em>. When the operation is
971
finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
972
<a class="link" href="telepathy-glib-account.html#tp-account-reconnect-finish" title="tp_account_reconnect_finish ()"><code class="function">tp_account_reconnect_finish()</code></a> to get the result of the operation.
974
<div class="variablelist"><table border="0" class="variablelist">
976
<col align="left" valign="top">
981
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
982
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
986
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
987
<td>a callback to call when the request is satisfied</td>
990
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
991
<td>data to pass to <em class="parameter"><code>callback</code></em>
996
<p class="since">Since 0.9.0</p>
999
<div class="refsect2">
1000
<a name="tp-account-reconnect-finish"></a><h3>tp_account_reconnect_finish ()</h3>
1001
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_reconnect_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1002
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1003
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1005
Finishes an async reconnect of <em class="parameter"><code>account</code></em>.
1007
<div class="variablelist"><table border="0" class="variablelist">
1009
<col align="left" valign="top">
1014
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1015
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1019
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1020
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1024
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1025
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to be filled</td>
1028
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1030
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the reconnect call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1035
<p class="since">Since 0.9.0</p>
1038
<div class="refsect2">
1039
<a name="tp-account-is-enabled"></a><h3>tp_account_is_enabled ()</h3>
1040
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_is_enabled (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1044
<div class="variablelist"><table border="0" class="variablelist">
1046
<col align="left" valign="top">
1051
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1052
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1056
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1057
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--enabled" title='The "enabled" property'><span class="type">"enabled"</span></a> property</td>
1061
<p class="since">Since 0.9.0</p>
1064
<div class="refsect2">
1065
<a name="tp-account-is-valid"></a><h3>tp_account_is_valid ()</h3>
1066
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_is_valid (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1070
<div class="variablelist"><table border="0" class="variablelist">
1072
<col align="left" valign="top">
1077
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1078
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1082
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1083
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--valid" title='The "valid" property'><span class="type">"valid"</span></a> property</td>
1087
<p class="since">Since 0.9.0</p>
1090
<div class="refsect2">
1091
<a name="tp-account-update-parameters-async"></a><h3>tp_account_update_parameters_async ()</h3>
1092
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_update_parameters_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1093
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *parameters</code></em>,
1094
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
1095
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1096
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1098
Requests an asynchronous update of parameters of <em class="parameter"><code>account</code></em>. When the
1099
operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1100
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()"><code class="function">tp_account_update_parameters_finish()</code></a> to get the result of the operation.
1102
<div class="variablelist"><table border="0" class="variablelist">
1104
<col align="left" valign="top">
1109
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1110
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1114
<td><p><span class="term"><em class="parameter"><code>parameters</code></em> :</span></p></td>
1116
parameters to set on <em class="parameter"><code>account</code></em>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1120
<td><p><span class="term"><em class="parameter"><code>unset_parameters</code></em> :</span></p></td>
1121
<td>list of parameters to unset on <em class="parameter"><code>account</code></em>
1125
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1126
<td>a callback to call when the request is satisfied</td>
1129
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1130
<td>data to pass to <em class="parameter"><code>callback</code></em>
1135
<p class="since">Since 0.9.0</p>
1138
<div class="refsect2">
1139
<a name="tp-account-update-parameters-finish"></a><h3>tp_account_update_parameters_finish ()</h3>
1140
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_update_parameters_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1141
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1142
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
1143
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1145
Finishes an async update of the parameters on <em class="parameter"><code>account</code></em>.
1147
<div class="variablelist"><table border="0" class="variablelist">
1149
<col align="left" valign="top">
1154
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1155
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1159
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1160
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1164
<td><p><span class="term"><em class="parameter"><code>reconnect_required</code></em> :</span></p></td>
1165
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> to
1166
fill with properties that need a reconnect to take effect. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1170
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1171
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1174
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1176
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the request succeeded, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1181
<p class="since">Since 0.9.0</p>
1184
<div class="refsect2">
1185
<a name="tp-account-update-parameters-vardict-async"></a><h3>tp_account_update_parameters_vardict_async ()</h3>
1186
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_update_parameters_vardict_async
1187
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1188
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1189
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **unset_parameters</code></em>,
1190
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1191
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1193
Requests an asynchronous update of parameters of <em class="parameter"><code>account</code></em>. When the
1194
operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1195
<a class="link" href="telepathy-glib-account.html#tp-account-update-parameters-finish" title="tp_account_update_parameters_finish ()"><code class="function">tp_account_update_parameters_finish()</code></a> to get the result of the operation.
1198
If <em class="parameter"><code>parameters</code></em> is a floating reference (see <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-ref-sink"><code class="function">g_variant_ref_sink()</code></a>),
1199
ownership of <em class="parameter"><code>parameters</code></em> is taken by this function. This means
1821
1200
you can pass the result of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new-parsed"><code class="function">g_variant_new_parsed()</code></a>
1822
directly to this function without additional reference-count management.</p>
1823
<div class="refsect3">
1824
<a name="id-1.4.46.11.23.6"></a><h4>Parameters</h4>
1825
<div class="informaltable"><table width="100%" border="0">
1827
<col width="150px" class="parameters_name">
1828
<col class="parameters_description">
1829
<col width="200px" class="parameters_annotations">
1833
<td class="parameter_name"><p>account</p></td>
1834
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1835
<td class="parameter_annotations"> </td>
1838
<td class="parameter_name"><p>parameters</p></td>
1839
<td class="parameter_description"><p> a variant of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>
1840
containing new parameters to set on <em class="parameter"><code>account</code></em>
1842
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1845
<td class="parameter_name"><p>unset_parameters</p></td>
1846
<td class="parameter_description"><p> list of parameters to unset on <em class="parameter"><code>account</code></em>
1848
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
1851
<td class="parameter_name"><p>callback</p></td>
1852
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
1853
<td class="parameter_annotations"> </td>
1856
<td class="parameter_name"><p>user_data</p></td>
1857
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
1859
<td class="parameter_annotations"> </td>
1864
<p class="since">Since 0.17.6</p>
1867
<div class="refsect2">
1868
<a name="tp-account-update-parameters-vardict-finish"></a><h3>tp_account_update_parameters_vardict_finish ()</h3>
1869
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1870
tp_account_update_parameters_vardict_finish
1871
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1872
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1873
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
1874
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1875
<p>Finishes an async update of the parameters on <em class="parameter"><code>account</code></em>
1877
<div class="refsect3">
1878
<a name="id-1.4.46.11.24.5"></a><h4>Parameters</h4>
1879
<div class="informaltable"><table width="100%" border="0">
1881
<col width="150px" class="parameters_name">
1882
<col class="parameters_description">
1883
<col width="200px" class="parameters_annotations">
1887
<td class="parameter_name"><p>account</p></td>
1888
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1889
<td class="parameter_annotations"> </td>
1892
<td class="parameter_name"><p>result</p></td>
1893
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
1894
<td class="parameter_annotations"> </td>
1897
<td class="parameter_name"><p>reconnect_required</p></td>
1898
<td class="parameter_description"><p> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> to
1899
fill with properties that need a reconnect to take effect. </p></td>
1900
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GStrv][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1903
<td class="parameter_name"><p>error</p></td>
1904
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
1905
<td class="parameter_annotations"> </td>
1910
<div class="refsect3">
1911
<a name="id-1.4.46.11.24.6"></a><h4>Returns</h4>
1912
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the request succeeded, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
1915
<p class="since">Since 0.17.6</p>
1918
<div class="refsect2">
1919
<a name="tp-account-remove-async"></a><h3>tp_account_remove_async ()</h3>
1920
<pre class="programlisting"><span class="returnvalue">void</span>
1921
tp_account_remove_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1922
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1923
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1924
<p>Requests an asynchronous removal of <em class="parameter"><code>account</code></em>
1925
. When the operation is
1926
finished, <em class="parameter"><code>callback</code></em>
1927
will be called. You can then call
1928
<a class="link" href="telepathy-glib-account.html#tp-account-remove-finish" title="tp_account_remove_finish ()"><code class="function">tp_account_remove_finish()</code></a> to get the result of the operation.</p>
1929
<div class="refsect3">
1930
<a name="id-1.4.46.11.25.5"></a><h4>Parameters</h4>
1931
<div class="informaltable"><table width="100%" border="0">
1933
<col width="150px" class="parameters_name">
1934
<col class="parameters_description">
1935
<col width="200px" class="parameters_annotations">
1939
<td class="parameter_name"><p>account</p></td>
1940
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1941
<td class="parameter_annotations"> </td>
1944
<td class="parameter_name"><p>callback</p></td>
1945
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
1946
<td class="parameter_annotations"> </td>
1949
<td class="parameter_name"><p>user_data</p></td>
1950
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
1952
<td class="parameter_annotations"> </td>
1957
<p class="since">Since 0.9.0</p>
1960
<div class="refsect2">
1961
<a name="tp-account-remove-finish"></a><h3>tp_account_remove_finish ()</h3>
1962
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1963
tp_account_remove_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1964
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1965
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1966
<p>Finishes an async removal of <em class="parameter"><code>account</code></em>
1968
<div class="refsect3">
1969
<a name="id-1.4.46.11.26.5"></a><h4>Parameters</h4>
1970
<div class="informaltable"><table width="100%" border="0">
1972
<col width="150px" class="parameters_name">
1973
<col class="parameters_description">
1974
<col width="200px" class="parameters_annotations">
1978
<td class="parameter_name"><p>account</p></td>
1979
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
1980
<td class="parameter_annotations"> </td>
1983
<td class="parameter_name"><p>result</p></td>
1984
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
1985
<td class="parameter_annotations"> </td>
1988
<td class="parameter_name"><p>error</p></td>
1989
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
1990
<td class="parameter_annotations"> </td>
1995
<div class="refsect3">
1996
<a name="id-1.4.46.11.26.6"></a><h4>Returns</h4>
1997
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2000
<p class="since">Since 0.9.0</p>
2003
<div class="refsect2">
2004
<a name="tp-account-set-display-name-async"></a><h3>tp_account_set_display_name_async ()</h3>
2005
<pre class="programlisting"><span class="returnvalue">void</span>
2006
tp_account_set_display_name_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2007
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *display_name</code></em>,
2008
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2009
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2010
<p>Requests an asynchronous set of the DisplayName property of <em class="parameter"><code>account</code></em>
2012
the operation is finished, <em class="parameter"><code>callback</code></em>
2013
will be called. You can then call
2014
<a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()"><code class="function">tp_account_set_display_name_finish()</code></a> to get the result of the operation.</p>
2015
<div class="refsect3">
2016
<a name="id-1.4.46.11.27.5"></a><h4>Parameters</h4>
2017
<div class="informaltable"><table width="100%" border="0">
2019
<col width="150px" class="parameters_name">
2020
<col class="parameters_description">
2021
<col width="200px" class="parameters_annotations">
2025
<td class="parameter_name"><p>account</p></td>
2026
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2027
<td class="parameter_annotations"> </td>
2030
<td class="parameter_name"><p>display_name</p></td>
2031
<td class="parameter_description"><p>a new display name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the display name</p></td>
2032
<td class="parameter_annotations"> </td>
2035
<td class="parameter_name"><p>callback</p></td>
2036
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2037
<td class="parameter_annotations"> </td>
2040
<td class="parameter_name"><p>user_data</p></td>
2041
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2043
<td class="parameter_annotations"> </td>
2048
<p class="since">Since 0.9.0</p>
2051
<div class="refsect2">
2052
<a name="tp-account-set-display-name-finish"></a><h3>tp_account_set_display_name_finish ()</h3>
2053
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2054
tp_account_set_display_name_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2055
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2056
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2057
<p>Finishes an async set of the DisplayName property.</p>
2058
<div class="refsect3">
2059
<a name="id-1.4.46.11.28.5"></a><h4>Parameters</h4>
2060
<div class="informaltable"><table width="100%" border="0">
2062
<col width="150px" class="parameters_name">
2063
<col class="parameters_description">
2064
<col width="200px" class="parameters_annotations">
2068
<td class="parameter_name"><p>account</p></td>
2069
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2070
<td class="parameter_annotations"> </td>
2073
<td class="parameter_name"><p>result</p></td>
2074
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2075
<td class="parameter_annotations"> </td>
2078
<td class="parameter_name"><p>error</p></td>
2079
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2080
<td class="parameter_annotations"> </td>
2085
<div class="refsect3">
2086
<a name="id-1.4.46.11.28.6"></a><h4>Returns</h4>
2087
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2090
<p class="since">Since 0.9.0</p>
2093
<div class="refsect2">
2094
<a name="tp-account-set-icon-name-async"></a><h3>tp_account_set_icon_name_async ()</h3>
2095
<pre class="programlisting"><span class="returnvalue">void</span>
2096
tp_account_set_icon_name_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2097
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
2098
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2099
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2100
<p>Requests an asynchronous set of the Icon property of <em class="parameter"><code>account</code></em>
2102
the operation is finished, <em class="parameter"><code>callback</code></em>
2103
will be called. You can then call
2104
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-finish" title="tp_account_set_icon_name_finish ()"><code class="function">tp_account_set_icon_name_finish()</code></a> to get the result of the operation.</p>
2105
<div class="refsect3">
2106
<a name="id-1.4.46.11.29.5"></a><h4>Parameters</h4>
2107
<div class="informaltable"><table width="100%" border="0">
2109
<col width="150px" class="parameters_name">
2110
<col class="parameters_description">
2111
<col width="200px" class="parameters_annotations">
2115
<td class="parameter_name"><p>account</p></td>
2116
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2117
<td class="parameter_annotations"> </td>
2120
<td class="parameter_name"><p>icon_name</p></td>
2121
<td class="parameter_description"><p>a new icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the icon name</p></td>
2122
<td class="parameter_annotations"> </td>
2125
<td class="parameter_name"><p>callback</p></td>
2126
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2127
<td class="parameter_annotations"> </td>
2130
<td class="parameter_name"><p>user_data</p></td>
2131
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2133
<td class="parameter_annotations"> </td>
2138
<p class="since">Since 0.9.0</p>
2141
<div class="refsect2">
2142
<a name="tp-account-set-icon-name-finish"></a><h3>tp_account_set_icon_name_finish ()</h3>
2143
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2144
tp_account_set_icon_name_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2145
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2146
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2147
<p>Finishes an async set of the Icon parameter.</p>
2148
<div class="refsect3">
2149
<a name="id-1.4.46.11.30.5"></a><h4>Parameters</h4>
2150
<div class="informaltable"><table width="100%" border="0">
2152
<col width="150px" class="parameters_name">
2153
<col class="parameters_description">
2154
<col width="200px" class="parameters_annotations">
2158
<td class="parameter_name"><p>account</p></td>
2159
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2160
<td class="parameter_annotations"> </td>
2163
<td class="parameter_name"><p>result</p></td>
2164
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2165
<td class="parameter_annotations"> </td>
2168
<td class="parameter_name"><p>error</p></td>
2169
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2170
<td class="parameter_annotations"> </td>
2175
<div class="refsect3">
2176
<a name="id-1.4.46.11.30.6"></a><h4>Returns</h4>
2177
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2180
<p class="since">Since 0.9.0</p>
2183
<div class="refsect2">
2184
<a name="tp-account-set-service-async"></a><h3>tp_account_set_service_async ()</h3>
2185
<pre class="programlisting"><span class="returnvalue">void</span>
2186
tp_account_set_service_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2187
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
2188
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2189
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2190
<p>Requests an asynchronous set of the Service property on <em class="parameter"><code>self</code></em>
2192
the operation is finished, <em class="parameter"><code>callback</code></em>
2193
will be called. You can then call
2194
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()"><code class="function">tp_account_set_service_finish()</code></a> to get the result of the operation.</p>
2195
<div class="refsect3">
2196
<a name="id-1.4.46.11.31.5"></a><h4>Parameters</h4>
2197
<div class="informaltable"><table width="100%" border="0">
2199
<col width="150px" class="parameters_name">
2200
<col class="parameters_description">
2201
<col width="200px" class="parameters_annotations">
2205
<td class="parameter_name"><p>self</p></td>
2206
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2207
<td class="parameter_annotations"> </td>
2210
<td class="parameter_name"><p>service</p></td>
2211
<td class="parameter_description"><p>a new service name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or the empty string to unset the
2212
service name (which will result in the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title="The “service” property"><span class="type">“service”</span></a> property
2213
becoming the same as <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title="The “protocol” property"><span class="type">“protocol”</span></a>)</p></td>
2214
<td class="parameter_annotations"> </td>
2217
<td class="parameter_name"><p>callback</p></td>
2218
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2219
<td class="parameter_annotations"> </td>
2222
<td class="parameter_name"><p>user_data</p></td>
2223
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2225
<td class="parameter_annotations"> </td>
2230
<p class="since">Since 0.11.9</p>
2233
<div class="refsect2">
2234
<a name="tp-account-set-service-finish"></a><h3>tp_account_set_service_finish ()</h3>
2235
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2236
tp_account_set_service_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2237
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2238
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2239
<p>Finishes an async set of the Service parameter.</p>
2240
<div class="refsect3">
2241
<a name="id-1.4.46.11.32.5"></a><h4>Parameters</h4>
2242
<div class="informaltable"><table width="100%" border="0">
2244
<col width="150px" class="parameters_name">
2245
<col class="parameters_description">
2246
<col width="200px" class="parameters_annotations">
2250
<td class="parameter_name"><p>self</p></td>
2251
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2252
<td class="parameter_annotations"> </td>
2255
<td class="parameter_name"><p>result</p></td>
2256
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2257
<td class="parameter_annotations"> </td>
2260
<td class="parameter_name"><p>error</p></td>
2261
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2262
<td class="parameter_annotations"> </td>
2267
<div class="refsect3">
2268
<a name="id-1.4.46.11.32.6"></a><h4>Returns</h4>
2269
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2272
<p class="since">Since 0.11.9</p>
2275
<div class="refsect2">
2276
<a name="tp-account-request-presence-async"></a><h3>tp_account_request_presence_async ()</h3>
2277
<pre class="programlisting"><span class="returnvalue">void</span>
2278
tp_account_request_presence_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2279
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
2280
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
2281
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
2282
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2283
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2284
<p>Requests an asynchronous change of presence on <em class="parameter"><code>account</code></em>
2286
operation is finished, <em class="parameter"><code>callback</code></em>
2287
will be called. You can then call
2288
<a class="link" href="telepathy-glib-account.html#tp-account-request-presence-finish" title="tp_account_request_presence_finish ()"><code class="function">tp_account_request_presence_finish()</code></a> to get the result of the operation.</p>
2289
<div class="refsect3">
2290
<a name="id-1.4.46.11.33.5"></a><h4>Parameters</h4>
2291
<div class="informaltable"><table width="100%" border="0">
2293
<col width="150px" class="parameters_name">
2294
<col class="parameters_description">
2295
<col width="200px" class="parameters_annotations">
2299
<td class="parameter_name"><p>account</p></td>
2300
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2301
<td class="parameter_annotations"> </td>
2304
<td class="parameter_name"><p>type</p></td>
2305
<td class="parameter_description"><p>the requested presence</p></td>
2306
<td class="parameter_annotations"> </td>
2309
<td class="parameter_name"><p>status</p></td>
2310
<td class="parameter_description"><p>a status message to set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
2311
<td class="parameter_annotations"> </td>
2314
<td class="parameter_name"><p>message</p></td>
2315
<td class="parameter_description"><p>a message for the change, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
2316
<td class="parameter_annotations"> </td>
2319
<td class="parameter_name"><p>callback</p></td>
2320
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2321
<td class="parameter_annotations"> </td>
2324
<td class="parameter_name"><p>user_data</p></td>
2325
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2327
<td class="parameter_annotations"> </td>
2332
<p class="since">Since 0.9.0</p>
2335
<div class="refsect2">
2336
<a name="tp-account-request-presence-finish"></a><h3>tp_account_request_presence_finish ()</h3>
2337
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2338
tp_account_request_presence_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2339
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2340
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2341
<p>Finishes an async presence change request on <em class="parameter"><code>account</code></em>
2343
<div class="refsect3">
2344
<a name="id-1.4.46.11.34.5"></a><h4>Parameters</h4>
2345
<div class="informaltable"><table width="100%" border="0">
2347
<col width="150px" class="parameters_name">
2348
<col class="parameters_description">
2349
<col width="200px" class="parameters_annotations">
2353
<td class="parameter_name"><p>account</p></td>
2354
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2355
<td class="parameter_annotations"> </td>
2358
<td class="parameter_name"><p>result</p></td>
2359
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2360
<td class="parameter_annotations"> </td>
2363
<td class="parameter_name"><p>error</p></td>
2364
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2365
<td class="parameter_annotations"> </td>
2370
<div class="refsect3">
2371
<a name="id-1.4.46.11.34.6"></a><h4>Returns</h4>
2372
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2375
<p class="since">Since 0.9.0</p>
2378
<div class="refsect2">
2379
<a name="tp-account-set-automatic-presence-async"></a><h3>tp_account_set_automatic_presence_async ()</h3>
2380
<pre class="programlisting"><span class="returnvalue">void</span>
2381
tp_account_set_automatic_presence_async
2382
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2383
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
2384
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
2385
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
2386
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2387
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2388
<p>Requests an asynchronous change of <em class="parameter"><code>account</code></em>
2389
's automatic presence. When the
2390
operation is finished, <em class="parameter"><code>callback</code></em>
2391
will be called. You can then call
2392
<a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-finish" title="tp_account_set_automatic_presence_finish ()"><code class="function">tp_account_set_automatic_presence_finish()</code></a> to get the result of the
2394
<div class="refsect3">
2395
<a name="id-1.4.46.11.35.5"></a><h4>Parameters</h4>
2396
<div class="informaltable"><table width="100%" border="0">
2398
<col width="150px" class="parameters_name">
2399
<col class="parameters_description">
2400
<col width="200px" class="parameters_annotations">
2404
<td class="parameter_name"><p>account</p></td>
2405
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2406
<td class="parameter_annotations"> </td>
2409
<td class="parameter_name"><p>type</p></td>
2410
<td class="parameter_description"><p>the requested presence</p></td>
2411
<td class="parameter_annotations"> </td>
2414
<td class="parameter_name"><p>status</p></td>
2415
<td class="parameter_description"><p>a status message to set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
2416
<td class="parameter_annotations"> </td>
2419
<td class="parameter_name"><p>message</p></td>
2420
<td class="parameter_description"><p>a message for the change, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
2421
<td class="parameter_annotations"> </td>
2424
<td class="parameter_name"><p>callback</p></td>
2425
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2426
<td class="parameter_annotations"> </td>
2429
<td class="parameter_name"><p>user_data</p></td>
2430
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2432
<td class="parameter_annotations"> </td>
2437
<p class="since">Since 0.13.8</p>
2440
<div class="refsect2">
2441
<a name="tp-account-set-automatic-presence-finish"></a><h3>tp_account_set_automatic_presence_finish ()</h3>
2442
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2443
tp_account_set_automatic_presence_finish
2444
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2445
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2446
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2447
<p>Finishes an asynchronous request to change the automatic presence of
2448
<em class="parameter"><code>account</code></em>
2450
<div class="refsect3">
2451
<a name="id-1.4.46.11.36.5"></a><h4>Parameters</h4>
2452
<div class="informaltable"><table width="100%" border="0">
2454
<col width="150px" class="parameters_name">
2455
<col class="parameters_description">
2456
<col width="200px" class="parameters_annotations">
2460
<td class="parameter_name"><p>account</p></td>
2461
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2462
<td class="parameter_annotations"> </td>
2465
<td class="parameter_name"><p>result</p></td>
2466
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2467
<td class="parameter_annotations"> </td>
2470
<td class="parameter_name"><p>error</p></td>
2471
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2472
<td class="parameter_annotations"> </td>
2477
<div class="refsect3">
2478
<a name="id-1.4.46.11.36.6"></a><h4>Returns</h4>
2479
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2482
<p class="since">Since 0.13.8</p>
2485
<div class="refsect2">
2486
<a name="tp-account-get-connect-automatically"></a><h3>tp_account_get_connect_automatically ()</h3>
2487
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2488
tp_account_get_connect_automatically (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2490
<div class="refsect3">
2491
<a name="id-1.4.46.11.37.5"></a><h4>Parameters</h4>
2492
<div class="informaltable"><table width="100%" border="0">
2494
<col width="150px" class="parameters_name">
2495
<col class="parameters_description">
2496
<col width="200px" class="parameters_annotations">
2499
<td class="parameter_name"><p>account</p></td>
2500
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2501
<td class="parameter_annotations"> </td>
2505
<div class="refsect3">
2506
<a name="id-1.4.46.11.37.6"></a><h4>Returns</h4>
2507
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connect-automatically" title="The “connect-automatically” property"><span class="type">“connect-automatically”</span></a> property</p>
2510
<p class="since">Since 0.9.0</p>
2513
<div class="refsect2">
2514
<a name="tp-account-set-connect-automatically-async"></a><h3>tp_account_set_connect_automatically_async ()</h3>
2515
<pre class="programlisting"><span class="returnvalue">void</span>
2516
tp_account_set_connect_automatically_async
2517
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2518
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> connect_automatically</code></em>,
2519
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2520
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2521
<p>Requests an asynchronous set of the ConnectAutomatically property of
2522
<em class="parameter"><code>account</code></em>
2523
. When the operation is finished, <em class="parameter"><code>callback</code></em>
2524
will be called. You can
2525
then call <a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()"><code class="function">tp_account_set_display_name_finish()</code></a> to get the result of the
2527
<div class="refsect3">
2528
<a name="id-1.4.46.11.38.5"></a><h4>Parameters</h4>
2529
<div class="informaltable"><table width="100%" border="0">
2531
<col width="150px" class="parameters_name">
2532
<col class="parameters_description">
2533
<col width="200px" class="parameters_annotations">
2537
<td class="parameter_name"><p>account</p></td>
2538
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2539
<td class="parameter_annotations"> </td>
2542
<td class="parameter_name"><p>connect_automatically</p></td>
2543
<td class="parameter_description"><p>new value for the parameter</p></td>
2544
<td class="parameter_annotations"> </td>
2547
<td class="parameter_name"><p>callback</p></td>
2548
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
2549
<td class="parameter_annotations"> </td>
2552
<td class="parameter_name"><p>user_data</p></td>
2553
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
2555
<td class="parameter_annotations"> </td>
2560
<p class="since">Since 0.9.0</p>
2563
<div class="refsect2">
2564
<a name="tp-account-set-connect-automatically-finish"></a><h3>tp_account_set_connect_automatically_finish ()</h3>
2565
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2566
tp_account_set_connect_automatically_finish
2567
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2568
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2569
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2570
<p>Finishes an async set of the ConnectAutomatically property.</p>
2571
<div class="refsect3">
2572
<a name="id-1.4.46.11.39.5"></a><h4>Parameters</h4>
2573
<div class="informaltable"><table width="100%" border="0">
2575
<col width="150px" class="parameters_name">
2576
<col class="parameters_description">
2577
<col width="200px" class="parameters_annotations">
2581
<td class="parameter_name"><p>account</p></td>
2582
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2583
<td class="parameter_annotations"> </td>
2586
<td class="parameter_name"><p>result</p></td>
2587
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
2588
<td class="parameter_annotations"> </td>
2591
<td class="parameter_name"><p>error</p></td>
2592
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
2593
<td class="parameter_annotations"> </td>
2598
<div class="refsect3">
2599
<a name="id-1.4.46.11.39.6"></a><h4>Returns</h4>
2600
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
2603
<p class="since">Since 0.9.0</p>
2606
<div class="refsect2">
2607
<a name="tp-account-get-has-been-online"></a><h3>tp_account_get_has_been_online ()</h3>
2608
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2609
tp_account_get_has_been_online (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2611
<div class="refsect3">
2612
<a name="id-1.4.46.11.40.5"></a><h4>Parameters</h4>
2613
<div class="informaltable"><table width="100%" border="0">
2615
<col width="150px" class="parameters_name">
2616
<col class="parameters_description">
2617
<col width="200px" class="parameters_annotations">
2620
<td class="parameter_name"><p>account</p></td>
2621
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2622
<td class="parameter_annotations"> </td>
2626
<div class="refsect3">
2627
<a name="id-1.4.46.11.40.6"></a><h4>Returns</h4>
2628
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--has-been-online" title="The “has-been-online” property"><span class="type">“has-been-online”</span></a> property</p>
2631
<p class="since">Since 0.9.0</p>
2634
<div class="refsect2">
2635
<a name="tp-account-get-connection-status"></a><h3>tp_account_get_connection_status ()</h3>
2636
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>
2637
tp_account_get_connection_status (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2638
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> *reason</code></em>);</pre>
2639
<p>Gets the connection status and reason from <em class="parameter"><code>account</code></em>
2641
are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title="The “connection-status” property"><span class="type">“connection-status”</span></a> and
2642
<a class="link" href="telepathy-glib-account.html#TpAccount--connection-status-reason" title="The “connection-status-reason” property"><span class="type">“connection-status-reason”</span></a> properties.</p>
2643
<div class="refsect3">
2644
<a name="id-1.4.46.11.41.5"></a><h4>Parameters</h4>
2645
<div class="informaltable"><table width="100%" border="0">
2647
<col width="150px" class="parameters_name">
2648
<col class="parameters_description">
2649
<col width="200px" class="parameters_annotations">
2653
<td class="parameter_name"><p>account</p></td>
2654
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2655
<td class="parameter_annotations"> </td>
2658
<td class="parameter_name"><p>reason</p></td>
2659
<td class="parameter_description"><p> a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> to fill, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
2660
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
2665
<div class="refsect3">
2666
<a name="id-1.4.46.11.41.6"></a><h4>Returns</h4>
2667
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title="The “connection-status” property"><span class="type">“connection-status”</span></a> property</p>
2670
<p class="since">Since 0.9.0</p>
2673
<div class="refsect2">
2674
<a name="tp-account-get-detailed-error"></a><h3>tp_account_get_detailed_error ()</h3>
2675
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2676
tp_account_get_detailed_error (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2677
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **details</code></em>);</pre>
2678
<p>If the account's connection is not connected, return the D-Bus error name
1201
directly to this function without additional reference-count management.
1203
<div class="variablelist"><table border="0" class="variablelist">
1205
<col align="left" valign="top">
1210
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1211
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1215
<td><p><span class="term"><em class="parameter"><code>parameters</code></em> :</span></p></td>
1216
<td>a variant of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>
1217
containing new parameters to set on <em class="parameter"><code>account</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1221
<td><p><span class="term"><em class="parameter"><code>unset_parameters</code></em> :</span></p></td>
1222
<td>list of parameters to unset on <em class="parameter"><code>account</code></em>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
1226
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1227
<td>a callback to call when the request is satisfied</td>
1230
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1231
<td>data to pass to <em class="parameter"><code>callback</code></em>
1236
<p class="since">Since 0.17.6</p>
1239
<div class="refsect2">
1240
<a name="tp-account-update-parameters-vardict-finish"></a><h3>tp_account_update_parameters_vardict_finish ()</h3>
1241
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_update_parameters_vardict_finish
1242
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1243
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1244
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***reconnect_required</code></em>,
1245
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1247
Finishes an async update of the parameters on <em class="parameter"><code>account</code></em>.
1249
<div class="variablelist"><table border="0" class="variablelist">
1251
<col align="left" valign="top">
1256
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1257
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1261
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1262
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1266
<td><p><span class="term"><em class="parameter"><code>reconnect_required</code></em> :</span></p></td>
1267
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> to
1268
fill with properties that need a reconnect to take effect. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GStrv][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1272
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1273
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1276
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1278
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the request succeeded, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1283
<p class="since">Since 0.17.6</p>
1286
<div class="refsect2">
1287
<a name="tp-account-remove-async"></a><h3>tp_account_remove_async ()</h3>
1288
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_remove_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1289
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1290
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1292
Requests an asynchronous removal of <em class="parameter"><code>account</code></em>. When the operation is
1293
finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1294
<a class="link" href="telepathy-glib-account.html#tp-account-remove-finish" title="tp_account_remove_finish ()"><code class="function">tp_account_remove_finish()</code></a> to get the result of the operation.
1296
<div class="variablelist"><table border="0" class="variablelist">
1298
<col align="left" valign="top">
1303
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1304
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1308
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1309
<td>a callback to call when the request is satisfied</td>
1312
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1313
<td>data to pass to <em class="parameter"><code>callback</code></em>
1318
<p class="since">Since 0.9.0</p>
1321
<div class="refsect2">
1322
<a name="tp-account-remove-finish"></a><h3>tp_account_remove_finish ()</h3>
1323
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_remove_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1324
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1325
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1327
Finishes an async removal of <em class="parameter"><code>account</code></em>.
1329
<div class="variablelist"><table border="0" class="variablelist">
1331
<col align="left" valign="top">
1336
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1337
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1341
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1342
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1346
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1347
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1350
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1352
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1357
<p class="since">Since 0.9.0</p>
1360
<div class="refsect2">
1361
<a name="tp-account-set-display-name-async"></a><h3>tp_account_set_display_name_async ()</h3>
1362
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_display_name_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1363
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *display_name</code></em>,
1364
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1365
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1367
Requests an asynchronous set of the DisplayName property of <em class="parameter"><code>account</code></em>. When
1368
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1369
<a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()"><code class="function">tp_account_set_display_name_finish()</code></a> to get the result of the operation.
1371
<div class="variablelist"><table border="0" class="variablelist">
1373
<col align="left" valign="top">
1378
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1379
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1383
<td><p><span class="term"><em class="parameter"><code>display_name</code></em> :</span></p></td>
1384
<td>a new display name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the display name</td>
1387
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1388
<td>a callback to call when the request is satisfied</td>
1391
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1392
<td>data to pass to <em class="parameter"><code>callback</code></em>
1397
<p class="since">Since 0.9.0</p>
1400
<div class="refsect2">
1401
<a name="tp-account-set-display-name-finish"></a><h3>tp_account_set_display_name_finish ()</h3>
1402
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_display_name_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1403
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1404
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1406
Finishes an async set of the DisplayName property.
1408
<div class="variablelist"><table border="0" class="variablelist">
1410
<col align="left" valign="top">
1415
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1416
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1420
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1421
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1425
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1426
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1429
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1431
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1436
<p class="since">Since 0.9.0</p>
1439
<div class="refsect2">
1440
<a name="tp-account-set-icon-name-async"></a><h3>tp_account_set_icon_name_async ()</h3>
1441
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_icon_name_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1442
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
1443
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1444
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1446
Requests an asynchronous set of the Icon property of <em class="parameter"><code>account</code></em>. When
1447
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1448
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-finish" title="tp_account_set_icon_name_finish ()"><code class="function">tp_account_set_icon_name_finish()</code></a> to get the result of the operation.
1450
<div class="variablelist"><table border="0" class="variablelist">
1452
<col align="left" valign="top">
1457
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1458
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1462
<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
1463
<td>a new icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the icon name</td>
1466
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1467
<td>a callback to call when the request is satisfied</td>
1470
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1471
<td>data to pass to <em class="parameter"><code>callback</code></em>
1476
<p class="since">Since 0.9.0</p>
1479
<div class="refsect2">
1480
<a name="tp-account-set-icon-name-finish"></a><h3>tp_account_set_icon_name_finish ()</h3>
1481
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_icon_name_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1482
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1483
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1485
Finishes an async set of the Icon parameter.
1487
<div class="variablelist"><table border="0" class="variablelist">
1489
<col align="left" valign="top">
1494
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1495
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1499
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1500
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1504
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1505
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1508
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1510
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1515
<p class="since">Since 0.9.0</p>
1518
<div class="refsect2">
1519
<a name="tp-account-set-service-async"></a><h3>tp_account_set_service_async ()</h3>
1520
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_service_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
1521
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
1522
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1523
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1525
Requests an asynchronous set of the Service property on <em class="parameter"><code>self</code></em>. When
1526
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1527
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-finish" title="tp_account_set_service_finish ()"><code class="function">tp_account_set_service_finish()</code></a> to get the result of the operation.
1529
<div class="variablelist"><table border="0" class="variablelist">
1531
<col align="left" valign="top">
1536
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1537
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1541
<td><p><span class="term"><em class="parameter"><code>service</code></em> :</span></p></td>
1542
<td>a new service name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or the empty string to unset the
1543
service name (which will result in the <a class="link" href="telepathy-glib-account.html#TpAccount--service" title='The "service" property'><span class="type">"service"</span></a> property
1544
becoming the same as <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'><span class="type">"protocol"</span></a>)</td>
1547
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1548
<td>a callback to call when the request is satisfied</td>
1551
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1552
<td>data to pass to <em class="parameter"><code>callback</code></em>
1557
<p class="since">Since 0.11.9</p>
1560
<div class="refsect2">
1561
<a name="tp-account-set-service-finish"></a><h3>tp_account_set_service_finish ()</h3>
1562
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_service_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
1563
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1564
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1566
Finishes an async set of the Service parameter.
1568
<div class="variablelist"><table border="0" class="variablelist">
1570
<col align="left" valign="top">
1575
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1576
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1580
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1581
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1585
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1586
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1589
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1591
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1596
<p class="since">Since 0.11.9</p>
1599
<div class="refsect2">
1600
<a name="tp-account-request-presence-async"></a><h3>tp_account_request_presence_async ()</h3>
1601
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_request_presence_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1602
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
1603
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
1604
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
1605
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1606
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1608
Requests an asynchronous change of presence on <em class="parameter"><code>account</code></em>. When the
1609
operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1610
<a class="link" href="telepathy-glib-account.html#tp-account-request-presence-finish" title="tp_account_request_presence_finish ()"><code class="function">tp_account_request_presence_finish()</code></a> to get the result of the operation.
1612
<div class="variablelist"><table border="0" class="variablelist">
1614
<col align="left" valign="top">
1619
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1620
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1624
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
1625
<td>the requested presence</td>
1628
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
1629
<td>a status message to set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1633
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1634
<td>a message for the change, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1638
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1639
<td>a callback to call when the request is satisfied</td>
1642
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1643
<td>data to pass to <em class="parameter"><code>callback</code></em>
1648
<p class="since">Since 0.9.0</p>
1651
<div class="refsect2">
1652
<a name="tp-account-request-presence-finish"></a><h3>tp_account_request_presence_finish ()</h3>
1653
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_request_presence_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1654
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1655
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1657
Finishes an async presence change request on <em class="parameter"><code>account</code></em>.
1659
<div class="variablelist"><table border="0" class="variablelist">
1661
<col align="left" valign="top">
1666
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1667
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1671
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1672
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1676
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1677
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1680
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1682
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1687
<p class="since">Since 0.9.0</p>
1690
<div class="refsect2">
1691
<a name="tp-account-set-automatic-presence-async"></a><h3>tp_account_set_automatic_presence_async ()</h3>
1692
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_automatic_presence_async
1693
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1694
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> type</code></em>,
1695
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *status</code></em>,
1696
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message</code></em>,
1697
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1698
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1700
Requests an asynchronous change of <em class="parameter"><code>account</code></em>'s automatic presence. When the
1701
operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
1702
<a class="link" href="telepathy-glib-account.html#tp-account-set-automatic-presence-finish" title="tp_account_set_automatic_presence_finish ()"><code class="function">tp_account_set_automatic_presence_finish()</code></a> to get the result of the
1705
<div class="variablelist"><table border="0" class="variablelist">
1707
<col align="left" valign="top">
1712
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1713
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1717
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
1718
<td>the requested presence</td>
1721
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
1722
<td>a status message to set, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1726
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1727
<td>a message for the change, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1731
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1732
<td>a callback to call when the request is satisfied</td>
1735
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1736
<td>data to pass to <em class="parameter"><code>callback</code></em>
1741
<p class="since">Since 0.13.8</p>
1744
<div class="refsect2">
1745
<a name="tp-account-set-automatic-presence-finish"></a><h3>tp_account_set_automatic_presence_finish ()</h3>
1746
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_automatic_presence_finish
1747
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1748
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1749
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1751
Finishes an asynchronous request to change the automatic presence of
1752
<em class="parameter"><code>account</code></em>.
1754
<div class="variablelist"><table border="0" class="variablelist">
1756
<col align="left" valign="top">
1761
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1762
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1766
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1767
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1771
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1772
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1775
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1777
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1782
<p class="since">Since 0.13.8</p>
1785
<div class="refsect2">
1786
<a name="tp-account-get-connect-automatically"></a><h3>tp_account_get_connect_automatically ()</h3>
1787
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_get_connect_automatically
1788
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1792
<div class="variablelist"><table border="0" class="variablelist">
1794
<col align="left" valign="top">
1799
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1800
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1804
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1805
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connect-automatically" title='The "connect-automatically" property'><span class="type">"connect-automatically"</span></a> property</td>
1809
<p class="since">Since 0.9.0</p>
1812
<div class="refsect2">
1813
<a name="tp-account-set-connect-automatically-async"></a><h3>tp_account_set_connect_automatically_async ()</h3>
1814
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_connect_automatically_async
1815
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1816
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> connect_automatically</code></em>,
1817
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1818
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1820
Requests an asynchronous set of the ConnectAutomatically property of
1821
<em class="parameter"><code>account</code></em>. When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can
1822
then call <a class="link" href="telepathy-glib-account.html#tp-account-set-display-name-finish" title="tp_account_set_display_name_finish ()"><code class="function">tp_account_set_display_name_finish()</code></a> to get the result of the
1825
<div class="variablelist"><table border="0" class="variablelist">
1827
<col align="left" valign="top">
1832
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1833
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1837
<td><p><span class="term"><em class="parameter"><code>connect_automatically</code></em> :</span></p></td>
1838
<td>new value for the parameter</td>
1841
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1842
<td>a callback to call when the request is satisfied</td>
1845
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1846
<td>data to pass to <em class="parameter"><code>callback</code></em>
1851
<p class="since">Since 0.9.0</p>
1854
<div class="refsect2">
1855
<a name="tp-account-set-connect-automatically-finish"></a><h3>tp_account_set_connect_automatically_finish ()</h3>
1856
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_connect_automatically_finish
1857
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1858
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1859
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1861
Finishes an async set of the ConnectAutomatically property.
1863
<div class="variablelist"><table border="0" class="variablelist">
1865
<col align="left" valign="top">
1870
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1871
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1875
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1876
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
1880
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1881
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
1884
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1886
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1891
<p class="since">Since 0.9.0</p>
1894
<div class="refsect2">
1895
<a name="tp-account-get-has-been-online"></a><h3>tp_account_get_has_been_online ()</h3>
1896
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_get_has_been_online (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
1900
<div class="variablelist"><table border="0" class="variablelist">
1902
<col align="left" valign="top">
1907
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1908
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1912
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1913
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--has-been-online" title='The "has-been-online" property'><span class="type">"has-been-online"</span></a> property</td>
1917
<p class="since">Since 0.9.0</p>
1920
<div class="refsect2">
1921
<a name="tp-account-get-connection-status"></a><h3>tp_account_get_connection_status ()</h3>
1922
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a> tp_account_get_connection_status (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
1923
<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> *reason</code></em>);</pre>
1925
Gets the connection status and reason from <em class="parameter"><code>account</code></em>. The two values
1926
are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title='The "connection-status" property'><span class="type">"connection-status"</span></a> and
1927
<a class="link" href="telepathy-glib-account.html#TpAccount--connection-status-reason" title='The "connection-status-reason" property'><span class="type">"connection-status-reason"</span></a> properties.
1929
<div class="variablelist"><table border="0" class="variablelist">
1931
<col align="left" valign="top">
1936
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
1937
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
1941
<td><p><span class="term"><em class="parameter"><code>reason</code></em> :</span></p></td>
1942
<td>a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> to fill, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1946
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1947
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--connection-status" title='The "connection-status" property'><span class="type">"connection-status"</span></a> property</td>
1951
<p class="since">Since 0.9.0</p>
1954
<div class="refsect2">
1955
<a name="tp-account-get-detailed-error"></a><h3>tp_account_get_detailed_error ()</h3>
1956
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_detailed_error (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
1957
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **details</code></em>);</pre>
1959
If the account's connection is not connected, return the D-Bus error name
2679
1960
with which it last disconnected or failed to connect (in particular, this
2680
1961
is <a class="link" href="telepathy-glib-errors.html#TP-ERROR-STR-CANCELLED:CAPS" title="TP_ERROR_STR_CANCELLED"><code class="literal">TP_ERROR_STR_CANCELLED</code></a> if it was disconnected by a user request).
2681
This is the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title="The “connection-error” property"><span class="type">“connection-error”</span></a>.</p>
2682
<p>If <em class="parameter"><code>details</code></em>
2683
is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be used to return additional details about
2684
the error (the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title="The “connection-error-details” property"><span class="type">“connection-error-details”</span></a>).</p>
2685
<p>Otherwise, return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, without altering <em class="parameter"><code>details</code></em>
2687
<p>The returned string and <em class="parameter"><code>details</code></em>
2688
may become invalid when the main loop is
2689
re-entered or the account is destroyed.</p>
2690
<div class="refsect3">
2691
<a name="id-1.4.46.11.42.8"></a><h4>Parameters</h4>
2692
<div class="informaltable"><table width="100%" border="0">
1962
This is the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title='The "connection-error" property'><span class="type">"connection-error"</span></a>.
1965
If <em class="parameter"><code>details</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be used to return additional details about
1966
the error (the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title='The "connection-error-details" property'><span class="type">"connection-error-details"</span></a>).
1969
Otherwise, return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, without altering <em class="parameter"><code>details</code></em>.
1972
The returned string and <em class="parameter"><code>details</code></em> may become invalid when the main loop is
1973
re-entered or the account is destroyed.
1975
<div class="variablelist"><table border="0" class="variablelist">
2694
<col width="150px" class="parameters_name">
2695
<col class="parameters_description">
2696
<col width="200px" class="parameters_annotations">
1977
<col align="left" valign="top">
2700
<td class="parameter_name"><p>self</p></td>
2701
<td class="parameter_description"><p>an account</p></td>
2702
<td class="parameter_annotations"> </td>
2705
<td class="parameter_name"><p>details</p></td>
2706
<td class="parameter_description"><p> optionally used to return a map from string to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, which must not be
2707
modified, destroyed or unreffed by the caller. </p></td>
2708
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
1982
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1986
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
1987
<td>optionally used to return a map from string to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, which must not be
1988
modified, destroyed or unreffed by the caller. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1992
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1993
<td>a D-Bus error name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2713
<div class="refsect3">
2714
<a name="id-1.4.46.11.42.9"></a><h4>Returns</h4>
2715
<p> a D-Bus error name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
2716
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
2718
1998
<p class="since">Since 0.11.7</p>
2721
2001
<div class="refsect2">
2722
<a name="tp-account-dup-detailed-error-vardict"></a><h3>tp_account_dup_detailed_error_vardict ()</h3>
2723
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2724
tp_account_dup_detailed_error_vardict (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2725
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> **details</code></em>);</pre>
2726
<p>If the account's connection is not connected, return the D-Bus error name
2002
<a name="tp-account-dup-detailed-error-vardict"></a><h3>tp_account_dup_detailed_error_vardict ()</h3>
2003
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_dup_detailed_error_vardict
2004
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2005
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> **details</code></em>);</pre>
2007
If the account's connection is not connected, return the D-Bus error name
2727
2008
with which it last disconnected or failed to connect (in particular, this
2728
2009
is <a class="link" href="telepathy-glib-errors.html#TP-ERROR-STR-CANCELLED:CAPS" title="TP_ERROR_STR_CANCELLED"><code class="literal">TP_ERROR_STR_CANCELLED</code></a> if it was disconnected by a user request).
2729
This is the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title="The “connection-error” property"><span class="type">“connection-error”</span></a>.</p>
2730
<p>If <em class="parameter"><code>details</code></em>
2731
is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be used to return additional details about
2732
the error (the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title="The “connection-error-details” property"><span class="type">“connection-error-details”</span></a>).</p>
2733
<p>Otherwise, return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, without altering <em class="parameter"><code>details</code></em>
2735
<p>The returned string and <em class="parameter"><code>details</code></em>
2736
may become invalid when the main loop is
2737
re-entered or the account is destroyed.</p>
2738
<div class="refsect3">
2739
<a name="id-1.4.46.11.43.8"></a><h4>Parameters</h4>
2740
<div class="informaltable"><table width="100%" border="0">
2010
This is the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title='The "connection-error" property'><span class="type">"connection-error"</span></a>.
2013
If <em class="parameter"><code>details</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be used to return additional details about
2014
the error (the same as <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error-details" title='The "connection-error-details" property'><span class="type">"connection-error-details"</span></a>).
2017
Otherwise, return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, without altering <em class="parameter"><code>details</code></em>.
2020
The returned string and <em class="parameter"><code>details</code></em> may become invalid when the main loop is
2021
re-entered or the account is destroyed.
2023
<div class="variablelist"><table border="0" class="variablelist">
2742
<col width="150px" class="parameters_name">
2743
<col class="parameters_description">
2744
<col width="200px" class="parameters_annotations">
2025
<col align="left" valign="top">
2748
<td class="parameter_name"><p>self</p></td>
2749
<td class="parameter_description"><p>an account</p></td>
2750
<td class="parameter_annotations"> </td>
2753
<td class="parameter_name"><p>details</p></td>
2754
<td class="parameter_description"><p> optionally used to return a variant of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>,
2755
which must be unreffed by the caller with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>. </p></td>
2756
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
2030
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2034
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
2035
<td>optionally used to return a variant of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>,
2036
which must be unreffed by the caller with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2040
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2041
<td>a D-Bus error name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2761
<div class="refsect3">
2762
<a name="id-1.4.46.11.43.9"></a><h4>Returns</h4>
2763
<p> a D-Bus error name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
2764
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
2766
2046
<p class="since">Since 0.17.6</p>
2769
2049
<div class="refsect2">
2770
<a name="tp-account-get-changing-presence"></a><h3>tp_account_get_changing_presence ()</h3>
2771
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2772
tp_account_get_changing_presence (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
2774
<div class="refsect3">
2775
<a name="id-1.4.46.11.44.5"></a><h4>Parameters</h4>
2776
<div class="informaltable"><table width="100%" border="0">
2050
<a name="tp-account-get-changing-presence"></a><h3>tp_account_get_changing_presence ()</h3>
2051
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_get_changing_presence (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
2055
<div class="variablelist"><table border="0" class="variablelist">
2778
<col width="150px" class="parameters_name">
2779
<col class="parameters_description">
2780
<col width="200px" class="parameters_annotations">
2057
<col align="left" valign="top">
2783
<td class="parameter_name"><p>self</p></td>
2784
<td class="parameter_description"><p>an account</p></td>
2785
<td class="parameter_annotations"> </td>
2062
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2066
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2067
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--changing-presence" title='The "changing-presence" property'><span class="type">"changing-presence"</span></a> property</td>
2789
<div class="refsect3">
2790
<a name="id-1.4.46.11.44.6"></a><h4>Returns</h4>
2791
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--changing-presence" title="The “changing-presence” property"><span class="type">“changing-presence”</span></a> property</p>
2794
2071
<p class="since">Since 0.11.6</p>
2797
2074
<div class="refsect2">
2798
<a name="tp-account-get-current-presence"></a><h3>tp_account_get_current_presence ()</h3>
2799
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
2800
tp_account_get_current_presence (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2801
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2802
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2803
<p>Gets the current presence, status and status message of <em class="parameter"><code>account</code></em>
2805
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title="The “current-presence-type” property"><span class="type">“current-presence-type”</span></a>,
2806
<a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title="The “current-status” property"><span class="type">“current-status”</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title="The “current-status-message” property"><span class="type">“current-status-message”</span></a> properties.</p>
2807
<div class="refsect3">
2808
<a name="id-1.4.46.11.45.5"></a><h4>Parameters</h4>
2809
<div class="informaltable"><table width="100%" border="0">
2811
<col width="150px" class="parameters_name">
2812
<col class="parameters_description">
2813
<col width="200px" class="parameters_annotations">
2817
<td class="parameter_name"><p>account</p></td>
2818
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2819
<td class="parameter_annotations"> </td>
2822
<td class="parameter_name"><p>status</p></td>
2823
<td class="parameter_description"><p> return location for the current status. </p></td>
2824
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
2827
<td class="parameter_name"><p>status_message</p></td>
2828
<td class="parameter_description"><p> return location for the current
2829
status message. </p></td>
2830
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
2835
<div class="refsect3">
2836
<a name="id-1.4.46.11.45.6"></a><h4>Returns</h4>
2837
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title="The “current-presence-type” property"><span class="type">“current-presence-type”</span></a> property</p>
2840
<p class="since">Since 0.9.0</p>
2843
<div class="refsect2">
2844
<a name="tp-account-get-requested-presence"></a><h3>tp_account_get_requested_presence ()</h3>
2845
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
2846
tp_account_get_requested_presence (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2847
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2848
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2849
<p>Gets the requested presence, status and status message of <em class="parameter"><code>account</code></em>
2851
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title="The “requested-presence-type” property"><span class="type">“requested-presence-type”</span></a>,
2852
<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title="The “requested-status” property"><span class="type">“requested-status”</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title="The “requested-status-message” property"><span class="type">“requested-status-message”</span></a>
2854
<div class="refsect3">
2855
<a name="id-1.4.46.11.46.5"></a><h4>Parameters</h4>
2856
<div class="informaltable"><table width="100%" border="0">
2858
<col width="150px" class="parameters_name">
2859
<col class="parameters_description">
2860
<col width="200px" class="parameters_annotations">
2864
<td class="parameter_name"><p>account</p></td>
2865
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2866
<td class="parameter_annotations"> </td>
2869
<td class="parameter_name"><p>status</p></td>
2870
<td class="parameter_description"><p> return location for the requested status. </p></td>
2871
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
2874
<td class="parameter_name"><p>status_message</p></td>
2875
<td class="parameter_description"><p> return location for the requested
2876
status message. </p></td>
2877
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
2882
<div class="refsect3">
2883
<a name="id-1.4.46.11.46.6"></a><h4>Returns</h4>
2884
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title="The “requested-presence-type” property"><span class="type">“requested-presence-type”</span></a> property</p>
2887
<p class="since">Since 0.9.0</p>
2890
<div class="refsect2">
2891
<a name="tp-account-get-automatic-presence"></a><h3>tp_account_get_automatic_presence ()</h3>
2892
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a>
2893
tp_account_get_automatic_presence (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2894
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2895
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2896
<p>Gets the automatic presence, status and status message of <em class="parameter"><code>account</code></em>
2898
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title="The “automatic-presence-type” property"><span class="type">“automatic-presence-type”</span></a>,
2899
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status" title="The “automatic-status” property"><span class="type">“automatic-status”</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status-message" title="The “automatic-status-message” property"><span class="type">“automatic-status-message”</span></a>
2075
<a name="tp-account-get-current-presence"></a><h3>tp_account_get_current_presence ()</h3>
2076
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> tp_account_get_current_presence
2077
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2078
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2079
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2081
Gets the current presence, status and status message of <em class="parameter"><code>account</code></em>. These
2082
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title='The "current-presence-type" property'><span class="type">"current-presence-type"</span></a>,
2083
<a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title='The "current-status" property'><span class="type">"current-status"</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title='The "current-status-message" property'><span class="type">"current-status-message"</span></a> properties.
2085
<div class="variablelist"><table border="0" class="variablelist">
2087
<col align="left" valign="top">
2092
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2093
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2097
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
2098
<td>return location for the current status. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2102
<td><p><span class="term"><em class="parameter"><code>status_message</code></em> :</span></p></td>
2103
<td>return location for the current
2104
status message. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2108
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2109
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title='The "current-presence-type" property'><span class="type">"current-presence-type"</span></a> property</td>
2113
<p class="since">Since 0.9.0</p>
2116
<div class="refsect2">
2117
<a name="tp-account-get-requested-presence"></a><h3>tp_account_get_requested_presence ()</h3>
2118
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> tp_account_get_requested_presence
2119
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2120
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2121
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2123
Gets the requested presence, status and status message of <em class="parameter"><code>account</code></em>. These
2124
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title='The "requested-presence-type" property'><span class="type">"requested-presence-type"</span></a>,
2125
<a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title='The "requested-status" property'><span class="type">"requested-status"</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title='The "requested-status-message" property'><span class="type">"requested-status-message"</span></a>
2128
<div class="variablelist"><table border="0" class="variablelist">
2130
<col align="left" valign="top">
2135
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2136
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2140
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
2141
<td>return location for the requested status. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2145
<td><p><span class="term"><em class="parameter"><code>status_message</code></em> :</span></p></td>
2146
<td>return location for the requested
2147
status message. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2151
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2152
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title='The "requested-presence-type" property'><span class="type">"requested-presence-type"</span></a> property</td>
2156
<p class="since">Since 0.9.0</p>
2159
<div class="refsect2">
2160
<a name="tp-account-get-automatic-presence"></a><h3>tp_account_get_automatic_presence ()</h3>
2161
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> tp_account_get_automatic_presence
2162
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2163
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status</code></em>,
2164
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **status_message</code></em>);</pre>
2166
Gets the automatic presence, status and status message of <em class="parameter"><code>account</code></em>. These
2167
values are the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title='The "automatic-presence-type" property'><span class="type">"automatic-presence-type"</span></a>,
2168
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status" title='The "automatic-status" property'><span class="type">"automatic-status"</span></a> and <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-status-message" title='The "automatic-status-message" property'><span class="type">"automatic-status-message"</span></a>
2900
2169
properties, and are the values that will be used if the account should
2901
be put online automatically.</p>
2902
<div class="refsect3">
2903
<a name="id-1.4.46.11.47.5"></a><h4>Parameters</h4>
2904
<div class="informaltable"><table width="100%" border="0">
2170
be put online automatically.
2172
<div class="variablelist"><table border="0" class="variablelist">
2906
<col width="150px" class="parameters_name">
2907
<col class="parameters_description">
2908
<col width="200px" class="parameters_annotations">
2174
<col align="left" valign="top">
2912
<td class="parameter_name"><p>self</p></td>
2913
<td class="parameter_description"><p>an account</p></td>
2914
<td class="parameter_annotations"> </td>
2917
<td class="parameter_name"><p>status</p></td>
2918
<td class="parameter_description"><p> return location for the presence status. </p></td>
2919
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
2922
<td class="parameter_name"><p>status_message</p></td>
2923
<td class="parameter_description"><p> return location for the
2924
user-defined message. </p></td>
2925
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
2179
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2183
<td><p><span class="term"><em class="parameter"><code>status</code></em> :</span></p></td>
2184
<td>return location for the presence status. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2188
<td><p><span class="term"><em class="parameter"><code>status_message</code></em> :</span></p></td>
2189
<td>return location for the
2190
user-defined message. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2194
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2195
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title='The "automatic-presence-type" property'><span class="type">"automatic-presence-type"</span></a> property</td>
2930
<div class="refsect3">
2931
<a name="id-1.4.46.11.47.6"></a><h4>Returns</h4>
2932
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title="The “automatic-presence-type” property"><span class="type">“automatic-presence-type”</span></a> property</p>
2935
2199
<p class="since">Since 0.13.8</p>
2938
2202
<div class="refsect2">
2939
<a name="tp-account-get-parameters"></a><h3>tp_account_get_parameters ()</h3>
2940
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
2941
tp_account_get_parameters (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2942
<p>Returns the parameters of the account, in a hash table where each string
2203
<a name="tp-account-get-parameters"></a><h3>tp_account_get_parameters ()</h3>
2204
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * tp_account_get_parameters (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2206
Returns the parameters of the account, in a hash table where each string
2943
2207
is the parameter name (account, password, require-encryption etc.), and
2944
2208
each value is a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>. Using the tp_asv_get family of functions
2945
(<a class="link" href="telepathy-glib-asv.html#tp-asv-get-uint32" title="tp_asv_get_uint32 ()"><code class="function">tp_asv_get_uint32()</code></a>, <a class="link" href="telepathy-glib-asv.html#tp-asv-get-string" title="tp_asv_get_string ()"><code class="function">tp_asv_get_string()</code></a> etc.) to access the parameters is
2947
<p>The allowed parameters depend on the connection manager, and can be found
2948
via <a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-get-protocol" title="tp_connection_manager_get_protocol ()"><code class="function">tp_connection_manager_get_protocol()</code></a> and
2949
<a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-protocol-get-param" title="tp_connection_manager_protocol_get_param ()"><code class="function">tp_connection_manager_protocol_get_param()</code></a>. Well-known parameters are
2209
(<a class="link" href="telepathy-glib-asv.html#tp-asv-get-uint32" title="tp_asv_get_uint32 ()"><code class="function">tp_asv_get_uint32()</code></a>, <a class="link" href="telepathy-glib-asv.html#tp-asv-get-string" title="tp_asv_get_string ()"><code class="function">tp_asv_get_string()</code></a> etc.) to access the parameters is
2213
The allowed parameters depend on the connection manager, and can be found
2214
via <a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-get-protocol" title="tp_connection_manager_get_protocol ()"><code class="function">tp_connection_manager_get_protocol()</code></a> and
2215
<a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-protocol-get-param" title="tp_connection_manager_protocol_get_param ()"><code class="function">tp_connection_manager_protocol_get_param()</code></a>. Well-known parameters are
2951
2217
<a class="ulink" href="http://telepathy.freedesktop.org/spec/org.freedesktop.Telepathy.ConnectionManager.html#org.freedesktop.Telepathy.ConnectionManager.RequestConnection" target="_top">in
2952
2218
the Telepathy D-Bus Interface Specification</a>.
2953
<div class="refsect3">
2954
<a name="id-1.4.46.11.48.7"></a><h4>Parameters</h4>
2955
<div class="informaltable"><table width="100%" border="0">
2220
<div class="variablelist"><table border="0" class="variablelist">
2957
<col width="150px" class="parameters_name">
2958
<col class="parameters_description">
2959
<col width="200px" class="parameters_annotations">
2222
<col align="left" valign="top">
2962
<td class="parameter_name"><p>account</p></td>
2963
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
2964
<td class="parameter_annotations"> </td>
2227
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2228
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2232
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2233
<td>the hash table of
2234
parameters on <em class="parameter"><code>account</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span>
2968
<div class="refsect3">
2969
<a name="id-1.4.46.11.48.8"></a><h4>Returns</h4>
2970
<p> the hash table of
2971
parameters on <em class="parameter"><code>account</code></em>
2973
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value]</span></p>
2975
2239
<p class="since">Since 0.9.0</p>
2978
2242
<div class="refsect2">
2979
<a name="tp-account-dup-parameters-vardict"></a><h3>tp_account_dup_parameters_vardict ()</h3>
2980
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
2981
tp_account_dup_parameters_vardict (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2982
<p>Returns the parameters of the account, in a variant of type
2243
<a name="tp-account-dup-parameters-vardict"></a><h3>tp_account_dup_parameters_vardict ()</h3>
2244
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * tp_account_dup_parameters_vardict (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2246
Returns the parameters of the account, in a variant of type
2983
2247
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a> where the keys
2984
2248
are parameter names (account, password, require-encryption etc.).
2985
2249
Use <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-lookup"><code class="function">g_variant_lookup()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-lookup-value"><code class="function">g_variant_lookup_value()</code></a> for convenient
2986
access to the values.</p>
2987
<p>The allowed parameters depend on the connection manager, and can be found
2988
via <a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-get-protocol" title="tp_connection_manager_get_protocol ()"><code class="function">tp_connection_manager_get_protocol()</code></a> and
2989
<a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-protocol-get-param" title="tp_connection_manager_protocol_get_param ()"><code class="function">tp_connection_manager_protocol_get_param()</code></a>. Well-known parameters are
2250
access to the values.
2253
The allowed parameters depend on the connection manager, and can be found
2254
via <a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-get-protocol" title="tp_connection_manager_get_protocol ()"><code class="function">tp_connection_manager_get_protocol()</code></a> and
2255
<a class="link" href="telepathy-glib-connection-manager.html#tp-connection-manager-protocol-get-param" title="tp_connection_manager_protocol_get_param ()"><code class="function">tp_connection_manager_protocol_get_param()</code></a>. Well-known parameters are
2991
2257
<a class="ulink" href="http://telepathy.freedesktop.org/spec/org.freedesktop.Telepathy.ConnectionManager.html#org.freedesktop.Telepathy.ConnectionManager.RequestConnection" target="_top">in
2992
2258
the Telepathy D-Bus Interface Specification</a>.
2993
<div class="refsect3">
2994
<a name="id-1.4.46.11.49.7"></a><h4>Parameters</h4>
2995
<div class="informaltable"><table width="100%" border="0">
2260
<div class="variablelist"><table border="0" class="variablelist">
2997
<col width="150px" class="parameters_name">
2998
<col class="parameters_description">
2999
<col width="200px" class="parameters_annotations">
2262
<col align="left" valign="top">
3002
<td class="parameter_name"><p>account</p></td>
3003
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3004
<td class="parameter_annotations"> </td>
2267
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2268
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2272
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2273
<td>the dictionary of
2274
parameters on <em class="parameter"><code>account</code></em>, of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3008
<div class="refsect3">
3009
<a name="id-1.4.46.11.49.8"></a><h4>Returns</h4>
3010
<p> the dictionary of
3011
parameters on <em class="parameter"><code>account</code></em>
3012
, of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>. </p>
3013
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
3015
2279
<p class="since">Since 0.17.6</p>
3018
2282
<div class="refsect2">
3019
<a name="tp-account-get-nickname"></a><h3>tp_account_get_nickname ()</h3>
3020
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
3021
tp_account_get_nickname (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
3023
<div class="refsect3">
3024
<a name="id-1.4.46.11.50.5"></a><h4>Parameters</h4>
3025
<div class="informaltable"><table width="100%" border="0">
3027
<col width="150px" class="parameters_name">
3028
<col class="parameters_description">
3029
<col width="200px" class="parameters_annotations">
3032
<td class="parameter_name"><p>account</p></td>
3033
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3034
<td class="parameter_annotations"> </td>
3038
<div class="refsect3">
3039
<a name="id-1.4.46.11.50.6"></a><h4>Returns</h4>
3040
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--nickname" title="The “nickname” property"><span class="type">“nickname”</span></a> property</p>
3043
<p class="since">Since 0.9.0</p>
3046
<div class="refsect2">
3047
<a name="tp-account-set-nickname-async"></a><h3>tp_account_set_nickname_async ()</h3>
3048
<pre class="programlisting"><span class="returnvalue">void</span>
3049
tp_account_set_nickname_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3050
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nickname</code></em>,
3051
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3052
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3053
<p>Requests an asynchronous change of the Nickname parameter on <em class="parameter"><code>account</code></em>
3055
the operation is finished, <em class="parameter"><code>callback</code></em>
3056
will be called. You can then call
3057
<a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-finish" title="tp_account_set_nickname_finish ()"><code class="function">tp_account_set_nickname_finish()</code></a> to get the result of the operation.</p>
3058
<div class="refsect3">
3059
<a name="id-1.4.46.11.51.5"></a><h4>Parameters</h4>
3060
<div class="informaltable"><table width="100%" border="0">
3062
<col width="150px" class="parameters_name">
3063
<col class="parameters_description">
3064
<col width="200px" class="parameters_annotations">
3068
<td class="parameter_name"><p>account</p></td>
3069
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3070
<td class="parameter_annotations"> </td>
3073
<td class="parameter_name"><p>nickname</p></td>
3074
<td class="parameter_description"><p>a new nickname to set</p></td>
3075
<td class="parameter_annotations"> </td>
3078
<td class="parameter_name"><p>callback</p></td>
3079
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3080
<td class="parameter_annotations"> </td>
3083
<td class="parameter_name"><p>user_data</p></td>
3084
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3086
<td class="parameter_annotations"> </td>
3091
<p class="since">Since 0.9.0</p>
3094
<div class="refsect2">
3095
<a name="tp-account-set-nickname-finish"></a><h3>tp_account_set_nickname_finish ()</h3>
3096
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3097
tp_account_set_nickname_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3098
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3099
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3100
<p>Finishes an async nickname change request on <em class="parameter"><code>account</code></em>
3102
<div class="refsect3">
3103
<a name="id-1.4.46.11.52.5"></a><h4>Parameters</h4>
3104
<div class="informaltable"><table width="100%" border="0">
3106
<col width="150px" class="parameters_name">
3107
<col class="parameters_description">
3108
<col width="200px" class="parameters_annotations">
3112
<td class="parameter_name"><p>account</p></td>
3113
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3114
<td class="parameter_annotations"> </td>
3117
<td class="parameter_name"><p>result</p></td>
3118
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3119
<td class="parameter_annotations"> </td>
3122
<td class="parameter_name"><p>error</p></td>
3123
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3124
<td class="parameter_annotations"> </td>
3129
<div class="refsect3">
3130
<a name="id-1.4.46.11.52.6"></a><h4>Returns</h4>
3131
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
3134
<p class="since">Since 0.9.0</p>
3137
<div class="refsect2">
3138
<a name="tp-account-get-normalized-name"></a><h3>tp_account_get_normalized_name ()</h3>
3139
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
3140
tp_account_get_normalized_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3142
<div class="refsect3">
3143
<a name="id-1.4.46.11.53.5"></a><h4>Parameters</h4>
3144
<div class="informaltable"><table width="100%" border="0">
3146
<col width="150px" class="parameters_name">
3147
<col class="parameters_description">
3148
<col width="200px" class="parameters_annotations">
3151
<td class="parameter_name"><p>self</p></td>
3152
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3153
<td class="parameter_annotations"> </td>
3157
<div class="refsect3">
3158
<a name="id-1.4.46.11.53.6"></a><h4>Returns</h4>
3159
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--normalized-name" title="The “normalized-name” property"><span class="type">“normalized-name”</span></a>
3161
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2283
<a name="tp-account-get-nickname"></a><h3>tp_account_get_nickname ()</h3>
2284
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_nickname (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>);</pre>
2288
<div class="variablelist"><table border="0" class="variablelist">
2290
<col align="left" valign="top">
2295
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2296
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2300
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2301
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--nickname" title='The "nickname" property'><span class="type">"nickname"</span></a> property</td>
2305
<p class="since">Since 0.9.0</p>
2308
<div class="refsect2">
2309
<a name="tp-account-set-nickname-async"></a><h3>tp_account_set_nickname_async ()</h3>
2310
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_nickname_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2311
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nickname</code></em>,
2312
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2313
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2315
Requests an asynchronous change of the Nickname parameter on <em class="parameter"><code>account</code></em>. When
2316
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2317
<a class="link" href="telepathy-glib-account.html#tp-account-set-nickname-finish" title="tp_account_set_nickname_finish ()"><code class="function">tp_account_set_nickname_finish()</code></a> to get the result of the operation.
2319
<div class="variablelist"><table border="0" class="variablelist">
2321
<col align="left" valign="top">
2326
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2327
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2331
<td><p><span class="term"><em class="parameter"><code>nickname</code></em> :</span></p></td>
2332
<td>a new nickname to set</td>
2335
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2336
<td>a callback to call when the request is satisfied</td>
2339
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2340
<td>data to pass to <em class="parameter"><code>callback</code></em>
2345
<p class="since">Since 0.9.0</p>
2348
<div class="refsect2">
2349
<a name="tp-account-set-nickname-finish"></a><h3>tp_account_set_nickname_finish ()</h3>
2350
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_nickname_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2351
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2352
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2354
Finishes an async nickname change request on <em class="parameter"><code>account</code></em>.
2356
<div class="variablelist"><table border="0" class="variablelist">
2358
<col align="left" valign="top">
2363
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2364
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2368
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
2369
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
2373
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2374
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
2377
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2379
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2384
<p class="since">Since 0.9.0</p>
2387
<div class="refsect2">
2388
<a name="tp-account-get-normalized-name"></a><h3>tp_account_get_normalized_name ()</h3>
2389
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_normalized_name (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
2393
<div class="variablelist"><table border="0" class="variablelist">
2395
<col align="left" valign="top">
2400
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2401
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2405
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2406
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--normalized-name" title='The "normalized-name" property'><span class="type">"normalized-name"</span></a>
2407
property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
3163
2412
<p class="since">Since 0.13.8</p>
3166
2415
<div class="refsect2">
3167
<a name="tp-account-get-supersedes"></a><h3>tp_account_get_supersedes ()</h3>
3168
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
3169
tp_account_get_supersedes (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3170
<p>Return the same thing as the <a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title="The “supersedes” property"><span class="type">“supersedes”</span></a> property, in a way
3171
that may be more convenient for C code.</p>
3172
<p>The returned pointers are not guaranteed to remain valid after the
3173
main loop has been re-entered.</p>
3174
<div class="refsect3">
3175
<a name="id-1.4.46.11.54.6"></a><h4>Parameters</h4>
3176
<div class="informaltable"><table width="100%" border="0">
2416
<a name="tp-account-get-supersedes"></a><h3>tp_account_get_supersedes ()</h3>
2417
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * tp_account_get_supersedes (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
2419
Return the same thing as the <a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title='The "supersedes" property'><span class="type">"supersedes"</span></a> property, in a way
2420
that may be more convenient for C code.
2423
The returned pointers are not guaranteed to remain valid after the
2424
main loop has been re-entered.
2426
<div class="variablelist"><table border="0" class="variablelist">
3178
<col width="150px" class="parameters_name">
3179
<col class="parameters_description">
3180
<col width="200px" class="parameters_annotations">
2428
<col align="left" valign="top">
3183
<td class="parameter_name"><p>self</p></td>
3184
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3185
<td class="parameter_annotations"> </td>
2433
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2434
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2438
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2439
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title='The "supersedes" property'><span class="type">"supersedes"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
3189
<div class="refsect3">
3190
<a name="id-1.4.46.11.54.7"></a><h4>Returns</h4>
3191
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--supersedes" title="The “supersedes” property"><span class="type">“supersedes”</span></a> property. </p>
3192
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
3194
2444
<p class="since">Since 0.17.5</p>
3197
2447
<div class="refsect2">
3198
<a name="tp-account-get-avatar-async"></a><h3>tp_account_get_avatar_async ()</h3>
3199
<pre class="programlisting"><span class="returnvalue">void</span>
3200
tp_account_get_avatar_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3201
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3202
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3203
<p>Requests an asynchronous get of <em class="parameter"><code>account</code></em>
3205
the operation is finished, <em class="parameter"><code>callback</code></em>
3206
will be called. You can then call
3207
<a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-finish" title="tp_account_get_avatar_finish ()"><code class="function">tp_account_get_avatar_finish()</code></a> to get the result of the operation.</p>
3208
<div class="refsect3">
3209
<a name="id-1.4.46.11.55.5"></a><h4>Parameters</h4>
3210
<div class="informaltable"><table width="100%" border="0">
3212
<col width="150px" class="parameters_name">
3213
<col class="parameters_description">
3214
<col width="200px" class="parameters_annotations">
3218
<td class="parameter_name"><p>account</p></td>
3219
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3220
<td class="parameter_annotations"> </td>
3223
<td class="parameter_name"><p>callback</p></td>
3224
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3225
<td class="parameter_annotations"> </td>
3228
<td class="parameter_name"><p>user_data</p></td>
3229
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3231
<td class="parameter_annotations"> </td>
3236
<p class="since">Since 0.9.0</p>
3239
<div class="refsect2">
3240
<a name="tp-account-get-avatar-finish"></a><h3>tp_account_get_avatar_finish ()</h3>
3241
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *
3242
tp_account_get_avatar_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3243
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3244
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3245
<p>Finishes an async get operation of <em class="parameter"><code>account</code></em>
3247
<p>Beware that the returned value is only valid until <em class="parameter"><code>result</code></em>
3249
Copy it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-ref"><code class="function">g_array_ref()</code></a> if you need to keep it for longer.</p>
3250
<div class="refsect3">
3251
<a name="id-1.4.46.11.56.6"></a><h4>Parameters</h4>
3252
<div class="informaltable"><table width="100%" border="0">
3254
<col width="150px" class="parameters_name">
3255
<col class="parameters_description">
3256
<col width="200px" class="parameters_annotations">
3260
<td class="parameter_name"><p>account</p></td>
3261
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3262
<td class="parameter_annotations"> </td>
3265
<td class="parameter_name"><p>result</p></td>
3266
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3267
<td class="parameter_annotations"> </td>
3270
<td class="parameter_name"><p>error</p></td>
3271
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3272
<td class="parameter_annotations"> </td>
3277
<div class="refsect3">
3278
<a name="id-1.4.46.11.56.7"></a><h4>Returns</h4>
3279
<p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>
3280
containing the bytes of the account's avatar, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. </p>
3281
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guchar][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
3283
<p class="since">Since 0.9.0</p>
3286
<div class="refsect2">
3287
<a name="tp-account-set-avatar-async"></a><h3>tp_account_set_avatar_async ()</h3>
3288
<pre class="programlisting"><span class="returnvalue">void</span>
3289
tp_account_set_avatar_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3290
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *avatar</code></em>,
3291
<em class="parameter"><code><span class="type">gsize</span> len</code></em>,
3292
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mime_type</code></em>,
3293
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3294
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3295
<p>Requests an asynchronous change of the Avatar parameter on <em class="parameter"><code>self</code></em>
3297
the operation is finished, <em class="parameter"><code>callback</code></em>
3298
will be called. You can then call
3299
<a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-finish" title="tp_account_set_avatar_finish ()"><code class="function">tp_account_set_avatar_finish()</code></a> to get the result of the operation.</p>
3300
<p>If <em class="parameter"><code>len</code></em>
3301
equals 0, the avatar is cleared.</p>
3302
<div class="refsect3">
3303
<a name="id-1.4.46.11.57.6"></a><h4>Parameters</h4>
3304
<div class="informaltable"><table width="100%" border="0">
3306
<col width="150px" class="parameters_name">
3307
<col class="parameters_description">
3308
<col width="200px" class="parameters_annotations">
3312
<td class="parameter_name"><p>self</p></td>
3313
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3314
<td class="parameter_annotations"> </td>
3317
<td class="parameter_name"><p>avatar</p></td>
3318
<td class="parameter_description"><p> a new avatar to set; can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3319
only if <em class="parameter"><code>len</code></em>
3321
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=len]</span></td>
3324
<td class="parameter_name"><p>len</p></td>
3325
<td class="parameter_description"><p>the length of the new avatar</p></td>
3326
<td class="parameter_annotations"> </td>
3329
<td class="parameter_name"><p>mime_type</p></td>
3330
<td class="parameter_description"><p> the MIME type of the new avatar; can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3331
only if <em class="parameter"><code>len</code></em>
3333
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
3336
<td class="parameter_name"><p>callback</p></td>
3337
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3338
<td class="parameter_annotations"> </td>
3341
<td class="parameter_name"><p>user_data</p></td>
3342
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3344
<td class="parameter_annotations"> </td>
3349
<p class="since">Since 0.11.1</p>
3352
<div class="refsect2">
3353
<a name="tp-account-set-avatar-finish"></a><h3>tp_account_set_avatar_finish ()</h3>
3354
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3355
tp_account_set_avatar_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3356
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3357
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3358
<p>Finishes an async avatar change request on <em class="parameter"><code>account</code></em>
3360
<div class="refsect3">
3361
<a name="id-1.4.46.11.58.5"></a><h4>Parameters</h4>
3362
<div class="informaltable"><table width="100%" border="0">
3364
<col width="150px" class="parameters_name">
3365
<col class="parameters_description">
3366
<col width="200px" class="parameters_annotations">
3370
<td class="parameter_name"><p>self</p></td>
3371
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3372
<td class="parameter_annotations"> </td>
3375
<td class="parameter_name"><p>result</p></td>
3376
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3377
<td class="parameter_annotations"> </td>
3380
<td class="parameter_name"><p>error</p></td>
3381
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3382
<td class="parameter_annotations"> </td>
3387
<div class="refsect3">
3388
<a name="id-1.4.46.11.58.6"></a><h4>Returns</h4>
3389
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
3392
<p class="since">Since 0.11.1</p>
3395
<div class="refsect2">
3396
<a name="tp-account-bind-connection-status-to-property"></a><h3>tp_account_bind_connection_status_to_property ()</h3>
3397
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="returnvalue">GBinding</span></a> *
3398
tp_account_bind_connection_status_to_property
3399
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3400
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> target</code></em>,
3401
<em class="parameter"><code>const <span class="type">char</span> *target_property</code></em>,
3402
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invert</code></em>);</pre>
3403
<p>Binds the :connection-status of <em class="parameter"><code>self</code></em>
3404
to the boolean property of another
3405
object using a <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> such that the <em class="parameter"><code>target_property</code></em>
3407
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when <em class="parameter"><code>self</code></em>
3408
is connected (and <em class="parameter"><code>invert</code></em>
3409
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>).</p>
3410
<p><em class="parameter"><code>target_property</code></em>
3411
will be synchronised immediately (<code class="literal">G_BINDING_SYNC_CREATE</code>).
3412
<em class="parameter"><code>invert</code></em>
3413
can be interpreted as analogous to <code class="literal">G_BINDING_INVERT_BOOLEAN</code>.</p>
3414
<p>For instance, this function can be used to bind the GtkWidget:sensitive
3415
property to only make a widget sensitive when the account is connected.</p>
3416
<p>See <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html#g-object-bind-property"><code class="function">g_object_bind_property()</code></a> for more information.</p>
3417
<div class="refsect3">
3418
<a name="id-1.4.46.11.59.8"></a><h4>Parameters</h4>
3419
<div class="informaltable"><table width="100%" border="0">
3421
<col width="150px" class="parameters_name">
3422
<col class="parameters_description">
3423
<col width="200px" class="parameters_annotations">
3427
<td class="parameter_name"><p>self</p></td>
3428
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3429
<td class="parameter_annotations"> </td>
3432
<td class="parameter_name"><p>target</p></td>
3433
<td class="parameter_description"><p>the target <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a></p></td>
3434
<td class="parameter_annotations"> </td>
3437
<td class="parameter_name"><p>target_property</p></td>
3438
<td class="parameter_description"><p>the property on <em class="parameter"><code>target</code></em>
3439
to bind (must be <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>)</p></td>
3440
<td class="parameter_annotations"> </td>
3443
<td class="parameter_name"><p>invert</p></td>
3444
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if you wish to invert the value of <em class="parameter"><code>target_property</code></em>
3445
(i.e. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if connected)</p></td>
3446
<td class="parameter_annotations"> </td>
3451
<div class="refsect3">
3452
<a name="id-1.4.46.11.59.9"></a><h4>Returns</h4>
3453
<p> the <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> instance representing the binding
3454
between the <em class="parameter"><code>self</code></em>
3455
and the <em class="parameter"><code>target</code></em>
3456
. The binding is released whenever the
3457
<a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> reference count reaches zero. </p>
3458
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2448
<a name="tp-account-get-avatar-async"></a><h3>tp_account_get_avatar_async ()</h3>
2449
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_get_avatar_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2450
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2451
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2453
Requests an asynchronous get of <em class="parameter"><code>account</code></em>'s avatar. When
2454
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2455
<a class="link" href="telepathy-glib-account.html#tp-account-get-avatar-finish" title="tp_account_get_avatar_finish ()"><code class="function">tp_account_get_avatar_finish()</code></a> to get the result of the operation.
2457
<div class="variablelist"><table border="0" class="variablelist">
2459
<col align="left" valign="top">
2464
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2465
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2469
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2470
<td>a callback to call when the request is satisfied</td>
2473
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2474
<td>data to pass to <em class="parameter"><code>callback</code></em>
2479
<p class="since">Since 0.9.0</p>
2482
<div class="refsect2">
2483
<a name="tp-account-get-avatar-finish"></a><h3>tp_account_get_avatar_finish ()</h3>
2484
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> * tp_account_get_avatar_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2485
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2486
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2488
Finishes an async get operation of <em class="parameter"><code>account</code></em>'s avatar.
2491
Beware that the returned value is only valid until <em class="parameter"><code>result</code></em> is freed.
2492
Copy it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-ref"><code class="function">g_array_ref()</code></a> if you need to keep it for longer.
2494
<div class="variablelist"><table border="0" class="variablelist">
2496
<col align="left" valign="top">
2501
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2502
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2506
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
2507
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
2511
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2512
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
2515
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2516
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> of <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>
2517
containing the bytes of the account's avatar, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guchar][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2522
<p class="since">Since 0.9.0</p>
2525
<div class="refsect2">
2526
<a name="tp-account-set-avatar-async"></a><h3>tp_account_set_avatar_async ()</h3>
2527
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_avatar_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2528
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *avatar</code></em>,
2529
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> len</code></em>,
2530
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mime_type</code></em>,
2531
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2532
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2534
Requests an asynchronous change of the Avatar parameter on <em class="parameter"><code>self</code></em>. When
2535
the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You can then call
2536
<a class="link" href="telepathy-glib-account.html#tp-account-set-avatar-finish" title="tp_account_set_avatar_finish ()"><code class="function">tp_account_set_avatar_finish()</code></a> to get the result of the operation.
2539
If <em class="parameter"><code>len</code></em> equals 0, the avatar is cleared.
2541
<div class="variablelist"><table border="0" class="variablelist">
2543
<col align="left" valign="top">
2548
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2549
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2553
<td><p><span class="term"><em class="parameter"><code>avatar</code></em> :</span></p></td>
2554
<td>a new avatar to set; can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2555
only if <em class="parameter"><code>len</code></em> equals 0. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=len]</span>
2559
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2560
<td>the length of the new avatar</td>
2563
<td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
2564
<td>the MIME type of the new avatar; can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2565
only if <em class="parameter"><code>len</code></em> equals 0. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2569
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2570
<td>a callback to call when the request is satisfied</td>
2573
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2574
<td>data to pass to <em class="parameter"><code>callback</code></em>
2579
<p class="since">Since 0.11.1</p>
2582
<div class="refsect2">
2583
<a name="tp-account-set-avatar-finish"></a><h3>tp_account_set_avatar_finish ()</h3>
2584
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_avatar_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2585
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2586
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2588
Finishes an async avatar change request on <em class="parameter"><code>account</code></em>.
2590
<div class="variablelist"><table border="0" class="variablelist">
2592
<col align="left" valign="top">
2597
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2598
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2602
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
2603
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
2607
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2608
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
2611
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2613
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2618
<p class="since">Since 0.11.1</p>
2621
<div class="refsect2">
2622
<a name="tp-account-bind-connection-status-to-property"></a><h3>tp_account_bind_connection_status_to_property ()</h3>
2623
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="returnvalue">GBinding</span></a> * tp_account_bind_connection_status_to_property
2624
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2625
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> target</code></em>,
2626
<em class="parameter"><code>const <span class="type">char</span> *target_property</code></em>,
2627
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> invert</code></em>);</pre>
2629
Binds the :connection-status of <em class="parameter"><code>self</code></em> to the boolean property of another
2630
object using a <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> such that the <em class="parameter"><code>target_property</code></em> will be set to
2631
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when <em class="parameter"><code>self</code></em> is connected (and <em class="parameter"><code>invert</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>).
2634
<em class="parameter"><code>target_property</code></em> will be synchronised immediately (<a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html#G-BINDING-SYNC-CREATE:CAPS"><code class="literal">G_BINDING_SYNC_CREATE</code></a>).
2635
<em class="parameter"><code>invert</code></em> can be interpreted as analogous to <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html#G-BINDING-INVERT-BOOLEAN:CAPS"><code class="literal">G_BINDING_INVERT_BOOLEAN</code></a>.
2638
For instance, this function can be used to bind the GtkWidget:sensitive
2639
property to only make a widget sensitive when the account is connected.
2642
See <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html#g-object-bind-property"><code class="function">g_object_bind_property()</code></a> for more information.
2644
<div class="variablelist"><table border="0" class="variablelist">
2646
<col align="left" valign="top">
2651
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2652
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2656
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
2657
<td>the target <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
2661
<td><p><span class="term"><em class="parameter"><code>target_property</code></em> :</span></p></td>
2662
<td>the property on <em class="parameter"><code>target</code></em> to bind (must be <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOOLEAN:CAPS"><code class="literal">G_TYPE_BOOLEAN</code></a>)</td>
2665
<td><p><span class="term"><em class="parameter"><code>invert</code></em> :</span></p></td>
2667
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if you wish to invert the value of <em class="parameter"><code>target_property</code></em>
2668
(i.e. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if connected)</td>
2671
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2672
<td>the <a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> instance representing the binding
2673
between the <em class="parameter"><code>self</code></em> and the <em class="parameter"><code>target</code></em>. The binding is released whenever the
2674
<a href="http://library.gnome.org/devel/gobject/unstable/GBinding.html"><span class="type">GBinding</span></a> reference count reaches zero. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
3460
2679
<p class="since">Since 0.13.16</p>
3463
2682
<div class="refsect2">
3464
<a name="tp-account-is-prepared"></a><h3>tp_account_is_prepared ()</h3>
3465
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3466
tp_account_is_prepared (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3467
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> feature</code></em>);</pre>
3468
<div class="warning">
3469
<p><code class="literal">tp_account_is_prepared</code> is deprecated and should not be used in newly-written code.</p>
3470
<p>since 0.23.0, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-is-prepared" title="tp_proxy_is_prepared ()"><code class="function">tp_proxy_is_prepared()</code></a> instead.</p>
3473
<div class="refsect3">
3474
<a name="id-1.4.46.11.60.7"></a><h4>Parameters</h4>
3475
<div class="informaltable"><table width="100%" border="0">
3477
<col width="150px" class="parameters_name">
3478
<col class="parameters_description">
3479
<col width="200px" class="parameters_annotations">
3483
<td class="parameter_name"><p>account</p></td>
3484
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3485
<td class="parameter_annotations"> </td>
3488
<td class="parameter_name"><p>feature</p></td>
3489
<td class="parameter_description"><p>a feature which is required</p></td>
3490
<td class="parameter_annotations"> </td>
3495
<div class="refsect3">
3496
<a name="id-1.4.46.11.60.8"></a><h4>Returns</h4>
3497
<p> the same thing as <a class="link" href="telepathy-glib-proxy.html#tp-proxy-is-prepared" title="tp_proxy_is_prepared ()"><code class="function">tp_proxy_is_prepared()</code></a></p>
3500
<p class="since">Since 0.9.0</p>
3503
<div class="refsect2">
3504
<a name="tp-account-prepare-async"></a><h3>tp_account_prepare_async ()</h3>
3505
<pre class="programlisting"><span class="returnvalue">void</span>
3506
tp_account_prepare_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3507
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> *features</code></em>,
3508
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3509
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3510
<div class="warning">
3511
<p><code class="literal">tp_account_prepare_async</code> is deprecated and should not be used in newly-written code.</p>
3512
<p>since 0.15.6, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> instead.</p>
3514
<p>Requests an asynchronous preparation of <em class="parameter"><code>account</code></em>
3515
with the features specified
3516
by <em class="parameter"><code>features</code></em>
3517
. When the operation is finished, <em class="parameter"><code>callback</code></em>
3519
can then call <a class="link" href="telepathy-glib-account.html#tp-account-prepare-finish" title="tp_account_prepare_finish ()"><code class="function">tp_account_prepare_finish()</code></a> to get the result of the
3521
<p>If <em class="parameter"><code>features</code></em>
3522
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>callback</code></em>
3523
will be called when the implied
3524
<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.</p>
3525
<p>If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is given to <em class="parameter"><code>callback</code></em>
3526
, then no callback will be called when the
3527
operation is finished. Instead, it will simply set <em class="parameter"><code>features</code></em>
3528
on <em class="parameter"><code>manager</code></em>
3530
Note that if <em class="parameter"><code>callback</code></em>
3531
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>user_data</code></em>
3532
must also be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
3533
<p>Since 0.11.3, this is equivalent to calling the new function
3534
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> with the same arguments.</p>
3535
<div class="refsect3">
3536
<a name="id-1.4.46.11.61.10"></a><h4>Parameters</h4>
3537
<div class="informaltable"><table width="100%" border="0">
3539
<col width="150px" class="parameters_name">
3540
<col class="parameters_description">
3541
<col width="200px" class="parameters_annotations">
3545
<td class="parameter_name"><p>account</p></td>
3546
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3547
<td class="parameter_annotations"> </td>
3550
<td class="parameter_name"><p>features</p></td>
3551
<td class="parameter_description"><p>a 0-terminated list of features, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
3552
<td class="parameter_annotations"> </td>
3555
<td class="parameter_name"><p>callback</p></td>
3556
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3557
<td class="parameter_annotations"> </td>
3560
<td class="parameter_name"><p>user_data</p></td>
3561
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3563
<td class="parameter_annotations"> </td>
3568
<p class="since">Since 0.9.0</p>
3571
<div class="refsect2">
3572
<a name="tp-account-prepare-finish"></a><h3>tp_account_prepare_finish ()</h3>
3573
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3574
tp_account_prepare_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
3575
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3576
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3577
<div class="warning">
3578
<p><code class="literal">tp_account_prepare_finish</code> is deprecated and should not be used in newly-written code.</p>
3579
<p>since 0.15.6, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-finish" title="tp_proxy_prepare_finish ()"><code class="function">tp_proxy_prepare_finish()</code></a> instead.</p>
3581
<p>Finishes an async preparation of the account <em class="parameter"><code>account</code></em>
3583
<div class="refsect3">
3584
<a name="id-1.4.46.11.62.7"></a><h4>Parameters</h4>
3585
<div class="informaltable"><table width="100%" border="0">
3587
<col width="150px" class="parameters_name">
3588
<col class="parameters_description">
3589
<col width="200px" class="parameters_annotations">
3593
<td class="parameter_name"><p>account</p></td>
3594
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3595
<td class="parameter_annotations"> </td>
3598
<td class="parameter_name"><p>result</p></td>
3599
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3600
<td class="parameter_annotations"> </td>
3603
<td class="parameter_name"><p>error</p></td>
3604
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3605
<td class="parameter_annotations"> </td>
3610
<div class="refsect3">
3611
<a name="id-1.4.46.11.62.8"></a><h4>Returns</h4>
3612
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preparation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
3615
<p class="since">Since 0.9.0</p>
3618
<div class="refsect2">
3619
<a name="tp-account-get-uri-schemes"></a><h3>tp_account_get_uri_schemes ()</h3>
3620
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
3621
tp_account_get_uri_schemes (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3622
<p>Return the <a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title="The “uri-schemes” property"><span class="type">“uri-schemes”</span></a> property</p>
3623
<div class="refsect3">
3624
<a name="id-1.4.46.11.63.5"></a><h4>Parameters</h4>
3625
<div class="informaltable"><table width="100%" border="0">
3627
<col width="150px" class="parameters_name">
3628
<col class="parameters_description">
3629
<col width="200px" class="parameters_annotations">
3632
<td class="parameter_name"><p>self</p></td>
3633
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3634
<td class="parameter_annotations"> </td>
3638
<div class="refsect3">
3639
<a name="id-1.4.46.11.63.6"></a><h4>Returns</h4>
3640
<p> the value of <a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title="The “uri-schemes” property"><span class="type">“uri_schemes”</span></a> property. </p>
3641
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
3643
<p class="since">Since 0.13.8</p>
3646
<div class="refsect2">
3647
<a name="tp-account-associated-with-uri-scheme"></a><h3>tp_account_associated_with_uri_scheme ()</h3>
3648
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3649
tp_account_associated_with_uri_scheme (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3650
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>);</pre>
3652
<div class="refsect3">
3653
<a name="id-1.4.46.11.64.5"></a><h4>Parameters</h4>
3654
<div class="informaltable"><table width="100%" border="0">
3656
<col width="150px" class="parameters_name">
3657
<col class="parameters_description">
3658
<col width="200px" class="parameters_annotations">
3662
<td class="parameter_name"><p>self</p></td>
3663
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3664
<td class="parameter_annotations"> </td>
3667
<td class="parameter_name"><p>scheme</p></td>
3668
<td class="parameter_description"><p> a URI scheme such as "tel", "sip" or "xmpp". </p></td>
3669
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
3674
<div class="refsect3">
3675
<a name="id-1.4.46.11.64.6"></a><h4>Returns</h4>
3676
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the result of <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a> would include
3677
<em class="parameter"><code>scheme</code></em>
3681
<p class="since">Since 0.13.8</p>
3684
<div class="refsect2">
3685
<a name="tp-account-set-uri-scheme-association-async"></a><h3>tp_account_set_uri_scheme_association_async ()</h3>
3686
<pre class="programlisting"><span class="returnvalue">void</span>
3687
tp_account_set_uri_scheme_association_async
3688
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3689
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>,
3690
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> associate</code></em>,
3691
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3692
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3693
<p>Add <em class="parameter"><code>scheme</code></em>
3694
to the list of additional URI schemes that would be returned
3695
by <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a>, or remove it from that list.</p>
3696
<p><em class="parameter"><code>scheme</code></em>
3697
should not be the primary URI scheme for the account's
3698
protocol (for instance, "xmpp" for XMPP, or "sip" or "sips" for SIP),
3699
since the account should be assumed to be useful for those schemes
3700
regardless of the contents of the list.</p>
3701
<p>Calling this method does not require the <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING"><code class="literal">TP_ACCOUNT_FEATURE_ADDRESSING</code></a>
3702
feature to be enabled, but the change will not be reflected in the result
3703
of <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a> or <a class="link" href="telepathy-glib-account.html#tp-account-associated-with-uri-scheme" title="tp_account_associated_with_uri_scheme ()"><code class="function">tp_account_associated_with_uri_scheme()</code></a>
3704
unless that feature has been enabled.</p>
3705
<div class="refsect3">
3706
<a name="id-1.4.46.11.65.7"></a><h4>Parameters</h4>
3707
<div class="informaltable"><table width="100%" border="0">
3709
<col width="150px" class="parameters_name">
3710
<col class="parameters_description">
3711
<col width="200px" class="parameters_annotations">
3715
<td class="parameter_name"><p>self</p></td>
3716
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3717
<td class="parameter_annotations"> </td>
3720
<td class="parameter_name"><p>scheme</p></td>
3721
<td class="parameter_description"><p>a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> URI scheme such as "tel"</p></td>
3722
<td class="parameter_annotations"> </td>
3725
<td class="parameter_name"><p>associate</p></td>
3726
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to use this account for <em class="parameter"><code>scheme</code></em>
3727
, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to not use it</p></td>
3728
<td class="parameter_annotations"> </td>
3731
<td class="parameter_name"><p>callback</p></td>
3732
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3733
<td class="parameter_annotations"> </td>
3736
<td class="parameter_name"><p>user_data</p></td>
3737
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3739
<td class="parameter_annotations"> </td>
3744
<p class="since">Since 0.13.8</p>
3747
<div class="refsect2">
3748
<a name="tp-account-set-uri-scheme-association-finish"></a><h3>tp_account_set_uri_scheme_association_finish ()</h3>
3749
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
3750
tp_account_set_uri_scheme_association_finish
3751
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3752
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3753
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3754
<p>Interpret the result of <a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-async" title="tp_account_set_uri_scheme_association_async ()"><code class="function">tp_account_set_uri_scheme_association_async()</code></a>.</p>
3755
<div class="refsect3">
3756
<a name="id-1.4.46.11.66.5"></a><h4>Parameters</h4>
3757
<div class="informaltable"><table width="100%" border="0">
3759
<col width="150px" class="parameters_name">
3760
<col class="parameters_description">
3761
<col width="200px" class="parameters_annotations">
3765
<td class="parameter_name"><p>self</p></td>
3766
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3767
<td class="parameter_annotations"> </td>
3770
<td class="parameter_name"><p>result</p></td>
3771
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3772
<td class="parameter_annotations"> </td>
3775
<td class="parameter_name"><p>error</p></td>
3776
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3777
<td class="parameter_annotations"> </td>
3782
<div class="refsect3">
3783
<a name="id-1.4.46.11.66.6"></a><h4>Returns</h4>
3784
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
3787
<p class="since">Since 0.13.8</p>
3790
<div class="refsect2">
3791
<a name="tp-account-get-storage-provider"></a><h3>tp_account_get_storage_provider ()</h3>
3792
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
3793
tp_account_get_storage_provider (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3795
<div class="refsect3">
3796
<a name="id-1.4.46.11.67.5"></a><h4>Parameters</h4>
3797
<div class="informaltable"><table width="100%" border="0">
3799
<col width="150px" class="parameters_name">
3800
<col class="parameters_description">
3801
<col width="200px" class="parameters_annotations">
3804
<td class="parameter_name"><p>self</p></td>
3805
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3806
<td class="parameter_annotations"> </td>
3810
<div class="refsect3">
3811
<a name="id-1.4.46.11.67.6"></a><h4>Returns</h4>
3812
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property"><span class="type">“storage-provider”</span></a> property</p>
3815
<p class="since">Since 0.13.2</p>
3818
<div class="refsect2">
3819
<a name="tp-account-get-storage-identifier"></a><h3>tp_account_get_storage_identifier ()</h3>
3820
<pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *
3821
tp_account_get_storage_identifier (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3823
<div class="refsect3">
3824
<a name="id-1.4.46.11.68.5"></a><h4>Parameters</h4>
3825
<div class="informaltable"><table width="100%" border="0">
3827
<col width="150px" class="parameters_name">
3828
<col class="parameters_description">
3829
<col width="200px" class="parameters_annotations">
3832
<td class="parameter_name"><p>self</p></td>
3833
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3834
<td class="parameter_annotations"> </td>
3838
<div class="refsect3">
3839
<a name="id-1.4.46.11.68.6"></a><h4>Returns</h4>
3840
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier" title="The “storage-identifier” property"><span class="type">“storage-identifier”</span></a> property</p>
3843
<p class="since">Since 0.13.2</p>
3846
<div class="refsect2">
3847
<a name="tp-account-dup-storage-identifier-variant"></a><h3>tp_account_dup_storage_identifier_variant ()</h3>
3848
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
3849
tp_account_dup_storage_identifier_variant
3850
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3851
<p>Return provider-specific information used to identify this
3852
account. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-type"><code class="function">g_variant_get_type()</code></a> to check that the type
3853
is what you expect; for instance, if the
3854
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property"><span class="type">“storage-provider”</span></a> has string-based user identifiers,
3855
this variant should have type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS"><code class="literal">G_VARIANT_TYPE_STRING</code></a>.</p>
3856
<div class="refsect3">
3857
<a name="id-1.4.46.11.69.5"></a><h4>Parameters</h4>
3858
<div class="informaltable"><table width="100%" border="0">
3860
<col width="150px" class="parameters_name">
3861
<col class="parameters_description">
3862
<col width="200px" class="parameters_annotations">
3865
<td class="parameter_name"><p>self</p></td>
3866
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3867
<td class="parameter_annotations"> </td>
3871
<div class="refsect3">
3872
<a name="id-1.4.46.11.69.6"></a><h4>Returns</h4>
3874
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier-variant" title="The “storage-identifier-variant” property"><span class="type">“storage-identifier-variant”</span></a> property. </p>
3875
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
3877
<p class="since">Since 0.13.2</p>
3880
<div class="refsect2">
3881
<a name="tp-account-get-storage-restrictions"></a><h3>tp_account_get_storage_restrictions ()</h3>
3882
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="returnvalue">TpStorageRestrictionFlags</span></a>
3883
tp_account_get_storage_restrictions (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3885
<div class="refsect3">
3886
<a name="id-1.4.46.11.70.5"></a><h4>Parameters</h4>
3887
<div class="informaltable"><table width="100%" border="0">
3889
<col width="150px" class="parameters_name">
3890
<col class="parameters_description">
3891
<col width="200px" class="parameters_annotations">
3894
<td class="parameter_name"><p>self</p></td>
3895
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3896
<td class="parameter_annotations"> </td>
3900
<div class="refsect3">
3901
<a name="id-1.4.46.11.70.6"></a><h4>Returns</h4>
3902
<p> the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-restrictions" title="The “storage-restrictions” property"><span class="type">“storage-restrictions”</span></a> property</p>
3905
<p class="since">Since 0.13.2</p>
3908
<div class="refsect2">
3909
<a name="tp-account-get-storage-specific-information-async"></a><h3>tp_account_get_storage_specific_information_async ()</h3>
3910
<pre class="programlisting"><span class="returnvalue">void</span>
3911
tp_account_get_storage_specific_information_async
3912
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3913
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3914
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3915
<p>Makes an asynchronous request of <em class="parameter"><code>self</code></em>
3916
's StorageSpecificInformation
3917
property (part of the Account.Interface.Storage interface).</p>
3918
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
3919
will be called. You must then
3920
call <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-finish" title="tp_account_get_storage_specific_information_finish ()"><code class="function">tp_account_get_storage_specific_information_finish()</code></a> to get the
3921
result of the request.</p>
3922
<div class="refsect3">
3923
<a name="id-1.4.46.11.71.6"></a><h4>Parameters</h4>
3924
<div class="informaltable"><table width="100%" border="0">
3926
<col width="150px" class="parameters_name">
3927
<col class="parameters_description">
3928
<col width="200px" class="parameters_annotations">
3932
<td class="parameter_name"><p>self</p></td>
3933
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3934
<td class="parameter_annotations"> </td>
3937
<td class="parameter_name"><p>callback</p></td>
3938
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
3939
<td class="parameter_annotations"> </td>
3942
<td class="parameter_name"><p>user_data</p></td>
3943
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
3945
<td class="parameter_annotations"> </td>
3950
<p class="since">Since 0.13.2</p>
3953
<div class="refsect2">
3954
<a name="tp-account-get-storage-specific-information-finish"></a><h3>tp_account_get_storage_specific_information_finish ()</h3>
3955
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
3956
tp_account_get_storage_specific_information_finish
3957
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3958
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3959
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3960
<p>Retrieve the value of the request begun with
3961
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-async" title="tp_account_get_storage_specific_information_async ()"><code class="function">tp_account_get_storage_specific_information_async()</code></a>.</p>
3962
<p>Beware that the returned value is only valid until <em class="parameter"><code>result</code></em>
3964
Copy it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-ref"><code class="function">g_hash_table_ref()</code></a> if you need to keep it for longer.</p>
3965
<div class="refsect3">
3966
<a name="id-1.4.46.11.72.6"></a><h4>Parameters</h4>
3967
<div class="informaltable"><table width="100%" border="0">
3969
<col width="150px" class="parameters_name">
3970
<col class="parameters_description">
3971
<col width="200px" class="parameters_annotations">
3975
<td class="parameter_name"><p>self</p></td>
3976
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
3977
<td class="parameter_annotations"> </td>
3980
<td class="parameter_name"><p>result</p></td>
3981
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
3982
<td class="parameter_annotations"> </td>
3985
<td class="parameter_name"><p>error</p></td>
3986
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
3987
<td class="parameter_annotations"> </td>
3992
<div class="refsect3">
3993
<a name="id-1.4.46.11.72.7"></a><h4>Returns</h4>
3994
<p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>
3995
of strings to GValues representing the D-Bus type a{sv}. </p>
3996
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
3998
<p class="since">Since 0.13.2</p>
4001
<div class="refsect2">
4002
<a name="tp-account-dup-storage-specific-information-vardict-async"></a><h3>tp_account_dup_storage_specific_information_vardict_async ()</h3>
4003
<pre class="programlisting"><span class="returnvalue">void</span>
4004
tp_account_dup_storage_specific_information_vardict_async
4005
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
4006
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
4007
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
4008
<p>Makes an asynchronous request of <em class="parameter"><code>self</code></em>
4009
's StorageSpecificInformation
4010
property (part of the Account.Interface.Storage interface).</p>
4011
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
4012
will be called. You must then
4013
call <a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-finish" title="tp_account_dup_storage_specific_information_vardict_finish ()"><code class="function">tp_account_dup_storage_specific_information_vardict_finish()</code></a> to get the
4014
result of the request.</p>
4015
<div class="refsect3">
4016
<a name="id-1.4.46.11.73.6"></a><h4>Parameters</h4>
4017
<div class="informaltable"><table width="100%" border="0">
4019
<col width="150px" class="parameters_name">
4020
<col class="parameters_description">
4021
<col width="200px" class="parameters_annotations">
4025
<td class="parameter_name"><p>self</p></td>
4026
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
4027
<td class="parameter_annotations"> </td>
4030
<td class="parameter_name"><p>callback</p></td>
4031
<td class="parameter_description"><p>a callback to call when the request is satisfied</p></td>
4032
<td class="parameter_annotations"> </td>
4035
<td class="parameter_name"><p>user_data</p></td>
4036
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
4038
<td class="parameter_annotations"> </td>
4043
<p class="since">Since 0.17.6</p>
4046
<div class="refsect2">
4047
<a name="tp-account-dup-storage-specific-information-vardict-finish"></a><h3>tp_account_dup_storage_specific_information_vardict_finish ()</h3>
4048
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
4049
tp_account_dup_storage_specific_information_vardict_finish
4050
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
4051
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
4052
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4053
<p>Retrieve the value of the request begun with
4054
<a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-async" title="tp_account_dup_storage_specific_information_vardict_async ()"><code class="function">tp_account_dup_storage_specific_information_vardict_async()</code></a>.</p>
4055
<div class="refsect3">
4056
<a name="id-1.4.46.11.74.5"></a><h4>Parameters</h4>
4057
<div class="informaltable"><table width="100%" border="0">
4059
<col width="150px" class="parameters_name">
4060
<col class="parameters_description">
4061
<col width="200px" class="parameters_annotations">
4065
<td class="parameter_name"><p>self</p></td>
4066
<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a></p></td>
4067
<td class="parameter_annotations"> </td>
4070
<td class="parameter_name"><p>result</p></td>
4071
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
4072
<td class="parameter_annotations"> </td>
4075
<td class="parameter_name"><p>error</p></td>
4076
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
4077
<td class="parameter_annotations"> </td>
4082
<div class="refsect3">
4083
<a name="id-1.4.46.11.74.6"></a><h4>Returns</h4>
4084
<p> a map from strings to variants,
4085
of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>. </p>
4086
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
4088
<p class="since">Since 0.17.6</p>
4091
<div class="refsect2">
4092
<a name="tp-cli-account-callback-for-reconnect"></a><h3>tp_cli_account_callback_for_reconnect ()</h3>
4093
<pre class="programlisting"><span class="returnvalue">void</span>
4094
<span class="c_punctuation">(</span>*tp_cli_account_callback_for_reconnect<span class="c_punctuation">)</span>
4095
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4096
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
4097
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4098
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4099
<p>Signature of the callback called when a Reconnect method call
4100
succeeds or fails.</p>
4101
<div class="refsect3">
4102
<a name="id-1.4.46.11.75.5"></a><h4>Parameters</h4>
4103
<div class="informaltable"><table width="100%" border="0">
4105
<col width="150px" class="parameters_name">
4106
<col class="parameters_description">
4107
<col width="200px" class="parameters_annotations">
4111
<td class="parameter_name"><p>proxy</p></td>
4112
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
4113
<td class="parameter_annotations"> </td>
4116
<td class="parameter_name"><p>error</p></td>
4117
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
4118
<td class="parameter_annotations"> </td>
4121
<td class="parameter_name"><p>user_data</p></td>
4122
<td class="parameter_description"><p>user-supplied data</p></td>
4123
<td class="parameter_annotations"> </td>
4126
<td class="parameter_name"><p>weak_object</p></td>
4127
<td class="parameter_description"><p>user-supplied object</p></td>
4128
<td class="parameter_annotations"> </td>
4135
<div class="refsect2">
4136
<a name="tp-cli-account-call-reconnect"></a><h3>tp_cli_account_call_reconnect ()</h3>
4137
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
4138
tp_cli_account_call_reconnect (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4139
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
4140
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()"><span class="type">tp_cli_account_callback_for_reconnect</span></a> callback</code></em>,
4141
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4142
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4143
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4144
<p>Start a Reconnect method call.</p>
4145
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Re-connect this account. If the account is currently disconnected and the requested presence is offline, or if the account is not <tp:member-ref>Enabled</tp:member-ref> or not <tp:member-ref>Valid</tp:member-ref>, this does nothing.</p> <p>If the account is disconnected and the requested presence is not offline, this forces an attempt to connect with the requested presence immediately.</p> <p>If the account is connecting or connected, this is equivalent to remembering the current value of <tp:member-ref>RequestedPresence</tp:member-ref>, setting its value to (OFFLINE, &quot;offline&quot;, &quot;&quot;), waiting for the change to take effect, then setting its value to the value that was previously remembered.</p> <tp:rationale> <p>Clients desiring &quot;instant apply&quot; semantics for CM parameters MAY call this method to achieve that.</p> </tp:rationale> <p>In particular, if the account's <tp:member-ref>Connection</tp:member-ref> is in the Connecting state, calling this method causes the attempt to connect to be aborted and re-tried.</p> <tp:rationale> <p>This is necessary to ensure that the new parameters are picked up.</p> </tp:rationale></p>
4146
<div class="refsect3">
4147
<a name="id-1.4.46.11.76.6"></a><h4>Parameters</h4>
4148
<div class="informaltable"><table width="100%" border="0">
4150
<col width="150px" class="parameters_name">
4151
<col class="parameters_description">
4152
<col width="200px" class="parameters_annotations">
4156
<td class="parameter_name"><p>proxy</p></td>
4157
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
4158
<td class="parameter_annotations"> </td>
4161
<td class="parameter_name"><p>timeout_ms</p></td>
4162
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
4164
<td class="parameter_annotations"> </td>
4167
<td class="parameter_name"><p>callback</p></td>
4168
<td class="parameter_description"><p>called when the method call succeeds or fails;
4169
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4170
reply tracking</p></td>
4171
<td class="parameter_annotations"> </td>
4174
<td class="parameter_name"><p>user_data</p></td>
4175
<td class="parameter_description"><p>user-supplied data passed to the callback;
4176
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4177
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4178
<td class="parameter_annotations"> </td>
4181
<td class="parameter_name"><p>destroy</p></td>
4182
<td class="parameter_description"><p>called with the user_data as argument, after the
4183
call has succeeded, failed or been cancelled;
4184
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4185
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4186
<td class="parameter_annotations"> </td>
4189
<td class="parameter_name"><p>weak_object</p></td>
4190
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
4191
weakly referenced; if it is destroyed, this call
4192
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
4193
<em class="parameter"><code>callback</code></em>
4194
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4195
<td class="parameter_annotations"> </td>
4200
<div class="refsect3">
4201
<a name="id-1.4.46.11.76.7"></a><h4>Returns</h4>
4202
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
4203
progress. It is borrowed from the object, and will become
4204
invalid when the callback is called, the call is
4205
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
4210
<div class="refsect2">
4211
<a name="tp-cli-account-callback-for-remove"></a><h3>tp_cli_account_callback_for_remove ()</h3>
4212
<pre class="programlisting"><span class="returnvalue">void</span>
4213
<span class="c_punctuation">(</span>*tp_cli_account_callback_for_remove<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4214
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
4215
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4216
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4217
<p>Signature of the callback called when a Remove method call
4218
succeeds or fails.</p>
4219
<div class="refsect3">
4220
<a name="id-1.4.46.11.77.5"></a><h4>Parameters</h4>
4221
<div class="informaltable"><table width="100%" border="0">
4223
<col width="150px" class="parameters_name">
4224
<col class="parameters_description">
4225
<col width="200px" class="parameters_annotations">
4229
<td class="parameter_name"><p>proxy</p></td>
4230
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
4231
<td class="parameter_annotations"> </td>
4234
<td class="parameter_name"><p>error</p></td>
4235
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
4236
<td class="parameter_annotations"> </td>
4239
<td class="parameter_name"><p>user_data</p></td>
4240
<td class="parameter_description"><p>user-supplied data</p></td>
4241
<td class="parameter_annotations"> </td>
4244
<td class="parameter_name"><p>weak_object</p></td>
4245
<td class="parameter_description"><p>user-supplied object</p></td>
4246
<td class="parameter_annotations"> </td>
4253
<div class="refsect2">
4254
<a name="tp-cli-account-call-remove"></a><h3>tp_cli_account_call_remove ()</h3>
4255
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
4256
tp_cli_account_call_remove (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4257
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
4258
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()"><span class="type">tp_cli_account_callback_for_remove</span></a> callback</code></em>,
4259
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4260
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4261
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4262
<p>Start a Remove method call.</p>
4263
<p>Delete the account.</p>
4264
<div class="refsect3">
4265
<a name="id-1.4.46.11.78.6"></a><h4>Parameters</h4>
4266
<div class="informaltable"><table width="100%" border="0">
4268
<col width="150px" class="parameters_name">
4269
<col class="parameters_description">
4270
<col width="200px" class="parameters_annotations">
4274
<td class="parameter_name"><p>proxy</p></td>
4275
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
4276
<td class="parameter_annotations"> </td>
4279
<td class="parameter_name"><p>timeout_ms</p></td>
4280
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
4282
<td class="parameter_annotations"> </td>
4285
<td class="parameter_name"><p>callback</p></td>
4286
<td class="parameter_description"><p>called when the method call succeeds or fails;
4287
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4288
reply tracking</p></td>
4289
<td class="parameter_annotations"> </td>
4292
<td class="parameter_name"><p>user_data</p></td>
4293
<td class="parameter_description"><p>user-supplied data passed to the callback;
4294
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4295
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4296
<td class="parameter_annotations"> </td>
4299
<td class="parameter_name"><p>destroy</p></td>
4300
<td class="parameter_description"><p>called with the user_data as argument, after the
4301
call has succeeded, failed or been cancelled;
4302
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4303
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4304
<td class="parameter_annotations"> </td>
4307
<td class="parameter_name"><p>weak_object</p></td>
4308
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
4309
weakly referenced; if it is destroyed, this call
4310
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
4311
<em class="parameter"><code>callback</code></em>
4312
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4313
<td class="parameter_annotations"> </td>
4318
<div class="refsect3">
4319
<a name="id-1.4.46.11.78.7"></a><h4>Returns</h4>
4320
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
4321
progress. It is borrowed from the object, and will become
4322
invalid when the callback is called, the call is
4323
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
4328
<div class="refsect2">
4329
<a name="tp-cli-account-callback-for-update-parameters"></a><h3>tp_cli_account_callback_for_update_parameters ()</h3>
4330
<pre class="programlisting"><span class="returnvalue">void</span>
4331
<span class="c_punctuation">(</span>*tp_cli_account_callback_for_update_parameters<span class="c_punctuation">)</span>
4332
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4333
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Reconnect_Required</code></em>,
4334
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
4335
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4336
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4337
<p>Signature of the callback called when a UpdateParameters method call
4338
succeeds or fails.</p>
4339
<div class="refsect3">
4340
<a name="id-1.4.46.11.79.5"></a><h4>Parameters</h4>
4341
<div class="informaltable"><table width="100%" border="0">
4343
<col width="150px" class="parameters_name">
4344
<col class="parameters_description">
4345
<col width="200px" class="parameters_annotations">
4349
<td class="parameter_name"><p>proxy</p></td>
4350
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
4351
<td class="parameter_annotations"> </td>
4354
<td class="parameter_name"><p>out_Reconnect_Required</p></td>
4355
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
4356
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If all of the updates could be applied to the active <tp:member-ref>Connection</tp:member-ref> (if any), the empty list, signifying that no reconnection is required for the new parameters to take effect. For example, if the only parameter updated is <tt>...Cellular.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Cellular">MessageValidityPeriod</tp:dbus-ref></tt>, the new value can be applied immediately to the connection.</p> <p>Otherwise, a list of the names of parameters with changes that will not take effect until the account is reconnected. User interfaces that require &quot;instant apply&quot; semantics MAY call <tp:member-ref>Reconnect</tp:member-ref> in response to receiving a non-empty list. For example, if the caller updates both <tt>...Anonymity.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Anonymity">AnonymityMandatory</tp:dbus-ref></tt> and <tt>require-encryption</tt>, the former can be applied to the current connection, but the latter needs a reconnect to take effect, so this method should return <code>[&quot;require-encryption&quot;]</code>.</p></p></td>
4357
<td class="parameter_annotations"> </td>
4360
<td class="parameter_name"><p>error</p></td>
4361
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
4362
<td class="parameter_annotations"> </td>
4365
<td class="parameter_name"><p>user_data</p></td>
4366
<td class="parameter_description"><p>user-supplied data</p></td>
4367
<td class="parameter_annotations"> </td>
4370
<td class="parameter_name"><p>weak_object</p></td>
4371
<td class="parameter_description"><p>user-supplied object</p></td>
4372
<td class="parameter_annotations"> </td>
4379
<div class="refsect2">
4380
<a name="tp-cli-account-call-update-parameters"></a><h3>tp_cli_account_call_update_parameters ()</h3>
4381
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
4382
tp_cli_account_call_update_parameters (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4383
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
4384
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Set</code></em>,
4385
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Unset</code></em>,
4386
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()"><span class="type">tp_cli_account_callback_for_update_parameters</span></a> callback</code></em>,
4387
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4388
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4389
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4390
<p>Start a UpdateParameters method call.</p>
4391
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Change the value of the <tp:member-ref>Parameters</tp:member-ref> property.</p> <p>If any of the <var>Set</var> parameters’ <tp:type>Conn_Mgr_Param_Flags</tp:type> include <code>DBus_Property</code>, the change will be applied immediately to the corresponding D-Bus Property on the active <tp:member-ref>Connection</tp:member-ref>, if there is one. If any of the <var>Unset</var> parameters’ <tp:type>Conn_Mgr_Param_Flags</tp:type> include both <code>DBus_Property</code> and <code>Has_Default</code>, the corresponding D-Bus Property on the connection will be set to the default value. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected. (If parameters are explicitly set to their default value, or are unset when previously set to their default value, the account manager MAY decide that no reconnection is necessary to make the change take effect.)</p> <tp:rationale> <p>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.</p> </tp:rationale></p>
4392
<div class="refsect3">
4393
<a name="id-1.4.46.11.80.6"></a><h4>Parameters</h4>
4394
<div class="informaltable"><table width="100%" border="0">
4396
<col width="150px" class="parameters_name">
4397
<col class="parameters_description">
4398
<col width="200px" class="parameters_annotations">
4402
<td class="parameter_name"><p>proxy</p></td>
4403
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
4404
<td class="parameter_annotations"> </td>
4407
<td class="parameter_name"><p>timeout_ms</p></td>
4408
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
4410
<td class="parameter_annotations"> </td>
4413
<td class="parameter_name"><p>in_Set</p></td>
4414
<td class="parameter_description"><p>Used to pass an 'in' argument: A mapping from parameter names to their values. These parameters should be stored for future use.</p></td>
4415
<td class="parameter_annotations"> </td>
4418
<td class="parameter_name"><p>in_Unset</p></td>
4419
<td class="parameter_description"><p>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.</p></td>
4420
<td class="parameter_annotations"> </td>
4423
<td class="parameter_name"><p>callback</p></td>
4424
<td class="parameter_description"><p>called when the method call succeeds or fails;
4425
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4426
reply tracking</p></td>
4427
<td class="parameter_annotations"> </td>
4430
<td class="parameter_name"><p>user_data</p></td>
4431
<td class="parameter_description"><p>user-supplied data passed to the callback;
4432
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4433
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4434
<td class="parameter_annotations"> </td>
4437
<td class="parameter_name"><p>destroy</p></td>
4438
<td class="parameter_description"><p>called with the user_data as argument, after the
4439
call has succeeded, failed or been cancelled;
4440
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4441
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4442
<td class="parameter_annotations"> </td>
4445
<td class="parameter_name"><p>weak_object</p></td>
4446
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
4447
weakly referenced; if it is destroyed, this call
4448
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
4449
<em class="parameter"><code>callback</code></em>
4450
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4451
<td class="parameter_annotations"> </td>
4456
<div class="refsect3">
4457
<a name="id-1.4.46.11.80.7"></a><h4>Returns</h4>
4458
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
4459
progress. It is borrowed from the object, and will become
4460
invalid when the callback is called, the call is
4461
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
4466
<div class="refsect2">
4467
<a name="tp-cli-account-signal-callback-account-property-changed"></a><h3>tp_cli_account_signal_callback_account_property_changed ()</h3>
4468
<pre class="programlisting"><span class="returnvalue">void</span>
4469
<span class="c_punctuation">(</span>*tp_cli_account_signal_callback_account_property_changed<span class="c_punctuation">)</span>
4470
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4471
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Properties</code></em>,
4472
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4473
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4474
<p>Represents the signature of a callback for the signal AccountPropertyChanged.</p>
4475
<div class="refsect3">
4476
<a name="id-1.4.46.11.81.5"></a><h4>Parameters</h4>
4477
<div class="informaltable"><table width="100%" border="0">
4479
<col width="150px" class="parameters_name">
4480
<col class="parameters_description">
4481
<col width="200px" class="parameters_annotations">
4485
<td class="parameter_name"><p>proxy</p></td>
4486
<td class="parameter_description"><p>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>
4488
<td class="parameter_annotations"> </td>
4491
<td class="parameter_name"><p>arg_Properties</p></td>
4492
<td class="parameter_description"><p>A map from property names in this namespace (e.g. <tp:member-ref>Nickname</tp:member-ref>) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done.</p></td>
4493
<td class="parameter_annotations"> </td>
4496
<td class="parameter_name"><p>user_data</p></td>
4497
<td class="parameter_description"><p>User-supplied data</p></td>
4498
<td class="parameter_annotations"> </td>
4501
<td class="parameter_name"><p>weak_object</p></td>
4502
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
4503
<td class="parameter_annotations"> </td>
4510
<div class="refsect2">
4511
<a name="tp-cli-account-connect-to-account-property-changed"></a><h3>tp_cli_account_connect_to_account_property_changed ()</h3>
4512
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
4513
tp_cli_account_connect_to_account_property_changed
4514
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4515
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_signal_callback_account_property_changed</span></a> callback</code></em>,
4516
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4517
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4518
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
4519
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4520
<p>Connect a handler to the signal AccountPropertyChanged.</p>
4521
<p>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>
4522
<div class="refsect3">
4523
<a name="id-1.4.46.11.82.6"></a><h4>Parameters</h4>
4524
<div class="informaltable"><table width="100%" border="0">
4526
<col width="150px" class="parameters_name">
4527
<col class="parameters_description">
4528
<col width="200px" class="parameters_annotations">
4532
<td class="parameter_name"><p>proxy</p></td>
4533
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</p></td>
4534
<td class="parameter_annotations"> </td>
4537
<td class="parameter_name"><p>callback</p></td>
4538
<td class="parameter_description"><p>Callback to be called when the signal is
4540
<td class="parameter_annotations"> </td>
4543
<td class="parameter_name"><p>user_data</p></td>
4544
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
4545
<td class="parameter_annotations"> </td>
4548
<td class="parameter_name"><p>destroy</p></td>
4549
<td class="parameter_description"><p>Destructor for the user-supplied data, which
4550
will be called when this signal is disconnected, or
4551
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4552
<td class="parameter_annotations"> </td>
4555
<td class="parameter_name"><p>weak_object</p></td>
4556
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
4557
if it is destroyed, this callback will automatically be
4558
disconnected</p></td>
4559
<td class="parameter_annotations"> </td>
4562
<td class="parameter_name"><p>error</p></td>
4563
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
4565
<td class="parameter_annotations"> </td>
4570
<div class="refsect3">
4571
<a name="id-1.4.46.11.82.7"></a><h4>Returns</h4>
4572
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4573
above, which can be used to disconnect the signal; or
4574
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4575
or has become invalid.</p>
4580
<div class="refsect2">
4581
<a name="tp-cli-account-signal-callback-removed"></a><h3>tp_cli_account_signal_callback_removed ()</h3>
4582
<pre class="programlisting"><span class="returnvalue">void</span>
4583
<span class="c_punctuation">(</span>*tp_cli_account_signal_callback_removed<span class="c_punctuation">)</span>
4584
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4585
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4586
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4587
<p>Represents the signature of a callback for the signal Removed.</p>
4588
<div class="refsect3">
4589
<a name="id-1.4.46.11.83.5"></a><h4>Parameters</h4>
4590
<div class="informaltable"><table width="100%" border="0">
4592
<col width="150px" class="parameters_name">
4593
<col class="parameters_description">
4594
<col width="200px" class="parameters_annotations">
4598
<td class="parameter_name"><p>proxy</p></td>
4599
<td class="parameter_description"><p>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>
4601
<td class="parameter_annotations"> </td>
4604
<td class="parameter_name"><p>user_data</p></td>
4605
<td class="parameter_description"><p>User-supplied data</p></td>
4606
<td class="parameter_annotations"> </td>
4609
<td class="parameter_name"><p>weak_object</p></td>
4610
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
4611
<td class="parameter_annotations"> </td>
4618
<div class="refsect2">
4619
<a name="tp-cli-account-connect-to-removed"></a><h3>tp_cli_account_connect_to_removed ()</h3>
4620
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
4621
tp_cli_account_connect_to_removed (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4622
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()"><span class="type">tp_cli_account_signal_callback_removed</span></a> callback</code></em>,
4623
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4624
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4625
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
4626
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4627
<p>Connect a handler to the signal Removed.</p>
4628
<p>This account has been removed. <tp:rationale> This is redundant with <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">AccountRemoved</tp:dbus-ref>, 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. </tp:rationale></p>
4629
<div class="refsect3">
4630
<a name="id-1.4.46.11.84.6"></a><h4>Parameters</h4>
4631
<div class="informaltable"><table width="100%" border="0">
4633
<col width="150px" class="parameters_name">
4634
<col class="parameters_description">
4635
<col width="200px" class="parameters_annotations">
4639
<td class="parameter_name"><p>proxy</p></td>
4640
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</p></td>
4641
<td class="parameter_annotations"> </td>
4644
<td class="parameter_name"><p>callback</p></td>
4645
<td class="parameter_description"><p>Callback to be called when the signal is
4647
<td class="parameter_annotations"> </td>
4650
<td class="parameter_name"><p>user_data</p></td>
4651
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
4652
<td class="parameter_annotations"> </td>
4655
<td class="parameter_name"><p>destroy</p></td>
4656
<td class="parameter_description"><p>Destructor for the user-supplied data, which
4657
will be called when this signal is disconnected, or
4658
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4659
<td class="parameter_annotations"> </td>
4662
<td class="parameter_name"><p>weak_object</p></td>
4663
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
4664
if it is destroyed, this callback will automatically be
4665
disconnected</p></td>
4666
<td class="parameter_annotations"> </td>
4669
<td class="parameter_name"><p>error</p></td>
4670
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
4672
<td class="parameter_annotations"> </td>
4677
<div class="refsect3">
4678
<a name="id-1.4.46.11.84.7"></a><h4>Returns</h4>
4679
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4680
above, which can be used to disconnect the signal; or
4681
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4682
or has become invalid.</p>
4687
<div class="refsect2">
4688
<a name="tp-cli-account-interface-avatar-signal-callback-avatar-changed"></a><h3>tp_cli_account_interface_avatar_signal_callback_avatar_changed ()</h3>
4689
<pre class="programlisting"><span class="returnvalue">void</span>
4690
<span class="c_punctuation">(</span>*tp_cli_account_interface_avatar_signal_callback_avatar_changed<span class="c_punctuation">)</span>
4691
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4692
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4693
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4694
<p>Represents the signature of a callback for the signal AvatarChanged.</p>
4695
<div class="refsect3">
4696
<a name="id-1.4.46.11.85.5"></a><h4>Parameters</h4>
4697
<div class="informaltable"><table width="100%" border="0">
4699
<col width="150px" class="parameters_name">
4700
<col class="parameters_description">
4701
<col width="200px" class="parameters_annotations">
4705
<td class="parameter_name"><p>proxy</p></td>
4706
<td class="parameter_description"><p>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>
4708
<td class="parameter_annotations"> </td>
4711
<td class="parameter_name"><p>user_data</p></td>
4712
<td class="parameter_description"><p>User-supplied data</p></td>
4713
<td class="parameter_annotations"> </td>
4716
<td class="parameter_name"><p>weak_object</p></td>
4717
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
4718
<td class="parameter_annotations"> </td>
4725
<div class="refsect2">
4726
<a name="tp-cli-account-interface-avatar-connect-to-avatar-changed"></a><h3>tp_cli_account_interface_avatar_connect_to_avatar_changed ()</h3>
4727
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
4728
tp_cli_account_interface_avatar_connect_to_avatar_changed
4729
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4730
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_interface_avatar_signal_callback_avatar_changed</span></a> callback</code></em>,
4731
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4732
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4733
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
4734
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
4735
<p>Connect a handler to the signal AvatarChanged.</p>
4736
<p>Emitted when the Avatar property changes. <tp:rationale>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.</tp:rationale></p>
4737
<div class="refsect3">
4738
<a name="id-1.4.46.11.86.6"></a><h4>Parameters</h4>
4739
<div class="informaltable"><table width="100%" border="0">
4741
<col width="150px" class="parameters_name">
4742
<col class="parameters_description">
4743
<col width="200px" class="parameters_annotations">
4747
<td class="parameter_name"><p>proxy</p></td>
4748
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</p></td>
4749
<td class="parameter_annotations"> </td>
4752
<td class="parameter_name"><p>callback</p></td>
4753
<td class="parameter_description"><p>Callback to be called when the signal is
4755
<td class="parameter_annotations"> </td>
4758
<td class="parameter_name"><p>user_data</p></td>
4759
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
4760
<td class="parameter_annotations"> </td>
4763
<td class="parameter_name"><p>destroy</p></td>
4764
<td class="parameter_description"><p>Destructor for the user-supplied data, which
4765
will be called when this signal is disconnected, or
4766
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4767
<td class="parameter_annotations"> </td>
4770
<td class="parameter_name"><p>weak_object</p></td>
4771
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
4772
if it is destroyed, this callback will automatically be
4773
disconnected</p></td>
4774
<td class="parameter_annotations"> </td>
4777
<td class="parameter_name"><p>error</p></td>
4778
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
4780
<td class="parameter_annotations"> </td>
4785
<div class="refsect3">
4786
<a name="id-1.4.46.11.86.7"></a><h4>Returns</h4>
4787
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4788
above, which can be used to disconnect the signal; or
4789
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4790
or has become invalid.</p>
4795
<div class="refsect2">
4796
<a name="tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association"></a><h3>tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()</h3>
4797
<pre class="programlisting"><span class="returnvalue">void</span>
4798
<span class="c_punctuation">(</span>*tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association<span class="c_punctuation">)</span>
4799
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4800
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
4801
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4802
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4803
<p>Signature of the callback called when a SetURISchemeAssociation method call
4804
succeeds or fails.</p>
4805
<div class="refsect3">
4806
<a name="id-1.4.46.11.87.5"></a><h4>Parameters</h4>
4807
<div class="informaltable"><table width="100%" border="0">
4809
<col width="150px" class="parameters_name">
4810
<col class="parameters_description">
4811
<col width="200px" class="parameters_annotations">
4815
<td class="parameter_name"><p>proxy</p></td>
4816
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
4817
<td class="parameter_annotations"> </td>
4820
<td class="parameter_name"><p>error</p></td>
4821
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
4822
<td class="parameter_annotations"> </td>
4825
<td class="parameter_name"><p>user_data</p></td>
4826
<td class="parameter_description"><p>user-supplied data</p></td>
4827
<td class="parameter_annotations"> </td>
4830
<td class="parameter_name"><p>weak_object</p></td>
4831
<td class="parameter_description"><p>user-supplied object</p></td>
4832
<td class="parameter_annotations"> </td>
4839
<div class="refsect2">
4840
<a name="tp-cli-account-interface-addressing-call-set-uri-scheme-association"></a><h3>tp_cli_account_interface_addressing_call_set_uri_scheme_association ()</h3>
4841
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
4842
tp_cli_account_interface_addressing_call_set_uri_scheme_association
4843
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4844
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
4845
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_URI_Scheme</code></em>,
4846
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Association</code></em>,
4847
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association" title="tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()"><span class="type">tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association</span></a> callback</code></em>,
4848
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4849
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4850
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4851
<p>Start a SetURISchemeAssociation method call.</p>
4852
<p><p>Associate (or disassociate) an account with a particular URI addressing scheme, (such as 'tel' for telephony)</p></p>
4853
<div class="refsect3">
4854
<a name="id-1.4.46.11.88.6"></a><h4>Parameters</h4>
4855
<div class="informaltable"><table width="100%" border="0">
4857
<col width="150px" class="parameters_name">
4858
<col class="parameters_description">
4859
<col width="200px" class="parameters_annotations">
4863
<td class="parameter_name"><p>proxy</p></td>
4864
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
4865
<td class="parameter_annotations"> </td>
4868
<td class="parameter_name"><p>timeout_ms</p></td>
4869
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
4871
<td class="parameter_annotations"> </td>
4874
<td class="parameter_name"><p>in_URI_Scheme</p></td>
4875
<td class="parameter_description"><p>Used to pass an 'in' argument: <p>URI scheme to associate/disassociate the account with/from</p></p></td>
4876
<td class="parameter_annotations"> </td>
4879
<td class="parameter_name"><p>in_Association</p></td>
4880
<td class="parameter_description"><p>Used to pass an 'in' argument: <p>True to associate this account with a given addressing scheme</p> <p>False if the account should not be associated with said scheme</p></p></td>
4881
<td class="parameter_annotations"> </td>
4884
<td class="parameter_name"><p>callback</p></td>
4885
<td class="parameter_description"><p>called when the method call succeeds or fails;
4886
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4887
reply tracking</p></td>
4888
<td class="parameter_annotations"> </td>
4891
<td class="parameter_name"><p>user_data</p></td>
4892
<td class="parameter_description"><p>user-supplied data passed to the callback;
4893
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4894
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4895
<td class="parameter_annotations"> </td>
4898
<td class="parameter_name"><p>destroy</p></td>
4899
<td class="parameter_description"><p>called with the user_data as argument, after the
4900
call has succeeded, failed or been cancelled;
4901
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em>
4902
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4903
<td class="parameter_annotations"> </td>
4906
<td class="parameter_name"><p>weak_object</p></td>
4907
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
4908
weakly referenced; if it is destroyed, this call
4909
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
4910
<em class="parameter"><code>callback</code></em>
4911
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
4912
<td class="parameter_annotations"> </td>
4917
<div class="refsect3">
4918
<a name="id-1.4.46.11.88.7"></a><h4>Returns</h4>
4919
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
4920
progress. It is borrowed from the object, and will become
4921
invalid when the callback is called, the call is
4922
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
4927
<div class="refsect1">
4928
<a name="telepathy-glib-account.other_details"></a><h2>Types and Values</h2>
4929
<div class="refsect2">
4930
<a name="TpAccount-struct"></a><h3>TpAccount</h3>
4931
<pre class="programlisting">typedef struct _TpAccount TpAccount;</pre>
4932
<p>The Telepathy Account Manager stores the user's configured real-time
4933
communication accounts. This object represents a stored account.</p>
4934
<p>If this account is deleted from the account manager, the
4935
<a class="link" href="telepathy-glib-proxy.html#TpProxy-invalidated" title="The “invalidated” signal"><span class="type">“invalidated”</span></a> signal will be emitted
4936
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
4937
<a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-OBJECT-REMOVED:CAPS"><code class="literal">TP_DBUS_ERROR_OBJECT_REMOVED</code></a>.</p>
4938
<p>One can connect to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to get change notifications
4939
for many of the properties on this object. Refer to each property's
4940
documentation for whether it can be used in this way.</p>
4941
<p><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> objects should normally be obtained from the <a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a>.</p>
4942
<p>Since 0.16, <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> always has a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title="The “factory” property"><span class="type">“factory”</span></a>, and its
4943
<a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title="The “factory” property"><span class="type">“factory”</span></a> will be propagated to its <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
4944
(if any). If a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> is created without going via the
4945
<a class="link" href="telepathy-glib-account-manager.html#TpAccountManager"><span class="type">TpAccountManager</span></a> or specifying a <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title="The “factory” property"><span class="type">“factory”</span></a>, the default
4946
is to use a new <a class="link" href="telepathy-glib-automatic-client-factory.html#TpAutomaticClientFactory"><span class="type">TpAutomaticClientFactory</span></a>.</p>
4947
<p class="since">Since 0.7.32</p>
4950
<div class="refsect2">
4951
<a name="TpAccountClass"></a><h3>struct TpAccountClass</h3>
4952
<pre class="programlisting">struct TpAccountClass {
4955
<p>The class of a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
4958
<div class="refsect2">
4959
2683
<a name="TP-ACCOUNT-FEATURE-CORE:CAPS"></a><h3>TP_ACCOUNT_FEATURE_CORE</h3>
4960
2684
<pre class="programlisting">#define TP_ACCOUNT_FEATURE_CORE</pre>
4961
<p>Expands to a call to a function that returns a quark for the "core" feature
4962
on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
4963
<p>When this feature is prepared, the basic properties of the Account have
2686
Expands to a call to a function that returns a quark for the "core" feature
2687
on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.
2690
When this feature is prepared, the basic properties of the Account have
4964
2691
been retrieved and are available for use, and change-notification has been
4966
<p>One can ask for a feature to be prepared using the
4967
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.</p>
2695
One can ask for a feature to be prepared using the
2696
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.
4968
2698
<p class="since">Since 0.9.0</p>
4971
2701
<div class="refsect2">
4972
2702
<a name="TP-ACCOUNT-FEATURE-CONNECTION:CAPS"></a><h3>TP_ACCOUNT_FEATURE_CONNECTION</h3>
4973
2703
<pre class="programlisting">#define TP_ACCOUNT_FEATURE_CONNECTION</pre>
4974
<p>Expands to a call to a function that returns a quark for the "connection"
4975
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
4976
<p>When this feature is prepared, it is guaranteed that <a class="link" href="telepathy-glib-account.html#TpAccount--connection" title="The “connection” property"><span class="type">“connection”</span></a>
4977
will always be either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or prepared. The account's <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title="The “factory” property"><span class="type">“factory”</span></a>
2705
Expands to a call to a function that returns a quark for the "connection"
2706
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.
2709
When this feature is prepared, it is guaranteed that <a class="link" href="telepathy-glib-account.html#TpAccount--connection" title='The "connection" property'><span class="type">"connection"</span></a>
2710
will always be either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or prepared. The account's <a class="link" href="telepathy-glib-proxy.html#TpProxy--factory" title='The "factory" property'><span class="type">"factory"</span></a>
4978
2711
will be used to create the <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> object and to determine its
4979
2712
desired connection features. Change notification of the
4980
<a class="link" href="telepathy-glib-account.html#TpAccount--connection" title="The “connection” property"><span class="type">“connection”</span></a> property will be delayed until all features (at least
2713
<a class="link" href="telepathy-glib-account.html#TpAccount--connection" title='The "connection" property'><span class="type">"connection"</span></a> property will be delayed until all features (at least
4981
2714
<a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CORE:CAPS" title="TP_CONNECTION_FEATURE_CORE"><code class="literal">TP_CONNECTION_FEATURE_CORE</code></a>) are prepared. See
4982
<a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-add-account-features" title="tp_simple_client_factory_add_account_features ()"><code class="function">tp_simple_client_factory_add_account_features()</code></a> to define which features
4983
needs to be prepared.</p>
4984
<p>One can ask for a feature to be prepared using the
4985
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.</p>
2715
<a class="link" href="telepathy-glib-simple-client-factory.html#tp-simple-client-factory-add-account-features" title="tp_simple_client_factory_add_account_features ()"><code class="function">tp_simple_client_factory_add_account_features()</code></a> to define which features
2716
needs to be prepared.
2719
One can ask for a feature to be prepared using the
2720
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.
4986
2722
<p class="since">Since 0.15.5</p>
4989
2725
<div class="refsect2">
2726
<a name="tp-account-is-prepared"></a><h3>tp_account_is_prepared ()</h3>
2727
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_is_prepared (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2728
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> feature</code></em>);</pre>
2729
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2730
<h3 class="title">Warning</h3>
2731
<p><code class="literal">tp_account_is_prepared</code> is deprecated and should not be used in newly-written code. since 0.23.0, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-is-prepared" title="tp_proxy_is_prepared ()"><code class="function">tp_proxy_is_prepared()</code></a> instead.</p>
2736
<div class="variablelist"><table border="0" class="variablelist">
2738
<col align="left" valign="top">
2743
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2744
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2748
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
2749
<td>a feature which is required</td>
2752
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2753
<td>the same thing as <a class="link" href="telepathy-glib-proxy.html#tp-proxy-is-prepared" title="tp_proxy_is_prepared ()"><code class="function">tp_proxy_is_prepared()</code></a>
2758
<p class="since">Since 0.9.0</p>
2761
<div class="refsect2">
2762
<a name="tp-account-prepare-async"></a><h3>tp_account_prepare_async ()</h3>
2763
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_prepare_async (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2764
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> *features</code></em>,
2765
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2766
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2767
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2768
<h3 class="title">Warning</h3>
2769
<p><code class="literal">tp_account_prepare_async</code> is deprecated and should not be used in newly-written code. since 0.15.6, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> instead.</p>
2772
Requests an asynchronous preparation of <em class="parameter"><code>account</code></em> with the features specified
2773
by <em class="parameter"><code>features</code></em>. When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You
2774
can then call <a class="link" href="telepathy-glib-account.html#tp-account-prepare-finish" title="tp_account_prepare_finish ()"><code class="function">tp_account_prepare_finish()</code></a> to get the result of the
2778
If <em class="parameter"><code>features</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>callback</code></em> will be called when the implied
2779
<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.
2782
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is given to <em class="parameter"><code>callback</code></em>, then no callback will be called when the
2783
operation is finished. Instead, it will simply set <em class="parameter"><code>features</code></em> on <em class="parameter"><code>manager</code></em>.
2784
Note that if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>user_data</code></em> must also be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
2787
Since 0.11.3, this is equivalent to calling the new function
2788
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> with the same arguments.
2790
<div class="variablelist"><table border="0" class="variablelist">
2792
<col align="left" valign="top">
2797
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2798
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2802
<td><p><span class="term"><em class="parameter"><code>features</code></em> :</span></p></td>
2803
<td>a 0-terminated list of features, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2807
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2808
<td>a callback to call when the request is satisfied</td>
2811
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2812
<td>data to pass to <em class="parameter"><code>callback</code></em>
2817
<p class="since">Since 0.9.0</p>
2820
<div class="refsect2">
2821
<a name="tp-account-prepare-finish"></a><h3>tp_account_prepare_finish ()</h3>
2822
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_prepare_finish (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
2823
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
2824
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2825
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2826
<h3 class="title">Warning</h3>
2827
<p><code class="literal">tp_account_prepare_finish</code> is deprecated and should not be used in newly-written code. since 0.15.6, use <a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-finish" title="tp_proxy_prepare_finish ()"><code class="function">tp_proxy_prepare_finish()</code></a> instead.</p>
2830
Finishes an async preparation of the account <em class="parameter"><code>account</code></em>.
2832
<div class="variablelist"><table border="0" class="variablelist">
2834
<col align="left" valign="top">
2839
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
2840
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2844
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
2845
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
2849
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2850
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
2853
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2855
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preparation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2860
<p class="since">Since 0.9.0</p>
2863
<div class="refsect2">
4990
2864
<a name="TP-ACCOUNT-FEATURE-ADDRESSING:CAPS"></a><h3>TP_ACCOUNT_FEATURE_ADDRESSING</h3>
4991
2865
<pre class="programlisting">#define TP_ACCOUNT_FEATURE_ADDRESSING</pre>
4992
<p>Expands to a call to a function that returns a quark for the "addressing"
4993
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
4994
<p>When this feature is prepared, the list of URI schemes from
4995
Account.Interface.Addressing has been retrieved and is available for use.</p>
4996
<p>One can ask for a feature to be prepared using the
4997
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.</p>
2867
Expands to a call to a function that returns a quark for the "addressing"
2868
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.
2871
When this feature is prepared, the list of URI schemes from
2872
Account.Interface.Addressing has been retrieved and is available for use.
2875
One can ask for a feature to be prepared using the
2876
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.
2878
<p class="since">Since 0.13.8</p>
2881
<div class="refsect2">
2882
<a name="tp-account-get-uri-schemes"></a><h3>tp_account_get_uri_schemes ()</h3>
2883
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * tp_account_get_uri_schemes (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
2885
Return the <a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title='The "uri-schemes" property'><span class="type">"uri-schemes"</span></a> property
2887
<div class="variablelist"><table border="0" class="variablelist">
2889
<col align="left" valign="top">
2894
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2895
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2899
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2900
<td>the value of <a class="link" href="telepathy-glib-account.html#TpAccount--uri-schemes" title='The "uri-schemes" property'><span class="type">"uri_schemes"</span></a> property. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2905
<p class="since">Since 0.13.8</p>
2908
<div class="refsect2">
2909
<a name="tp-account-associated-with-uri-scheme"></a><h3>tp_account_associated_with_uri_scheme ()</h3>
2910
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_associated_with_uri_scheme
2911
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2912
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>);</pre>
2916
<div class="variablelist"><table border="0" class="variablelist">
2918
<col align="left" valign="top">
2923
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2924
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2928
<td><p><span class="term"><em class="parameter"><code>scheme</code></em> :</span></p></td>
2929
<td>a URI scheme such as "tel", "sip" or "xmpp". <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2933
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2935
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the result of <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a> would include
2936
<em class="parameter"><code>scheme</code></em>
2941
<p class="since">Since 0.13.8</p>
2944
<div class="refsect2">
2945
<a name="tp-account-set-uri-scheme-association-async"></a><h3>tp_account_set_uri_scheme_association_async ()</h3>
2946
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_set_uri_scheme_association_async
2947
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
2948
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>,
2949
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> associate</code></em>,
2950
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
2951
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2953
Add <em class="parameter"><code>scheme</code></em> to the list of additional URI schemes that would be returned
2954
by <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a>, or remove it from that list.
2957
<em class="parameter"><code>scheme</code></em> should not be the primary URI scheme for the account's
2958
protocol (for instance, "xmpp" for XMPP, or "sip" or "sips" for SIP),
2959
since the account should be assumed to be useful for those schemes
2960
regardless of the contents of the list.
2963
Calling this method does not require the <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING"><code class="literal">TP_ACCOUNT_FEATURE_ADDRESSING</code></a>
2964
feature to be enabled, but the change will not be reflected in the result
2965
of <a class="link" href="telepathy-glib-account.html#tp-account-get-uri-schemes" title="tp_account_get_uri_schemes ()"><code class="function">tp_account_get_uri_schemes()</code></a> or <a class="link" href="telepathy-glib-account.html#tp-account-associated-with-uri-scheme" title="tp_account_associated_with_uri_scheme ()"><code class="function">tp_account_associated_with_uri_scheme()</code></a>
2966
unless that feature has been enabled.
2968
<div class="variablelist"><table border="0" class="variablelist">
2970
<col align="left" valign="top">
2975
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
2976
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
2980
<td><p><span class="term"><em class="parameter"><code>scheme</code></em> :</span></p></td>
2981
<td>a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> URI scheme such as "tel"</td>
2984
<td><p><span class="term"><em class="parameter"><code>associate</code></em> :</span></p></td>
2986
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to use this account for <em class="parameter"><code>scheme</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to not use it</td>
2989
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2990
<td>a callback to call when the request is satisfied</td>
2993
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2994
<td>data to pass to <em class="parameter"><code>callback</code></em>
2999
<p class="since">Since 0.13.8</p>
3002
<div class="refsect2">
3003
<a name="tp-account-set-uri-scheme-association-finish"></a><h3>tp_account_set_uri_scheme_association_finish ()</h3>
3004
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_account_set_uri_scheme_association_finish
3005
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3006
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3007
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3009
Interpret the result of <a class="link" href="telepathy-glib-account.html#tp-account-set-uri-scheme-association-async" title="tp_account_set_uri_scheme_association_async ()"><code class="function">tp_account_set_uri_scheme_association_async()</code></a>.
3011
<div class="variablelist"><table border="0" class="variablelist">
3013
<col align="left" valign="top">
3018
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3019
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3023
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
3024
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
3028
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3029
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
3032
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3034
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
4998
3039
<p class="since">Since 0.13.8</p>
5001
3042
<div class="refsect2">
5002
3043
<a name="TP-ACCOUNT-FEATURE-STORAGE:CAPS"></a><h3>TP_ACCOUNT_FEATURE_STORAGE</h3>
5003
3044
<pre class="programlisting">#define TP_ACCOUNT_FEATURE_STORAGE</pre>
5004
<p>Expands to a call to a function that returns a quark for the "storage"
5005
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.</p>
5006
<p>When this feature is prepared, the Account.Interface.Storage properties have
5007
been retrieved and are available for use.</p>
5008
<p>One can ask for a feature to be prepared using the
5009
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.</p>
5010
<p class="since">Since 0.13.2</p>
3046
Expands to a call to a function that returns a quark for the "storage"
3047
feature on a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>.
3050
When this feature is prepared, the Account.Interface.Storage properties have
3051
been retrieved and are available for use.
3054
One can ask for a feature to be prepared using the
3055
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> function, and waiting for it to callback.
3057
<p class="since">Since 0.13.2</p>
3060
<div class="refsect2">
3061
<a name="tp-account-get-storage-provider"></a><h3>tp_account_get_storage_provider ()</h3>
3062
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * tp_account_get_storage_provider (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3066
<div class="variablelist"><table border="0" class="variablelist">
3068
<col align="left" valign="top">
3073
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3074
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3078
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3079
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'><span class="type">"storage-provider"</span></a> property</td>
3083
<p class="since">Since 0.13.2</p>
3086
<div class="refsect2">
3087
<a name="tp-account-get-storage-identifier"></a><h3>tp_account_get_storage_identifier ()</h3>
3088
<pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> * tp_account_get_storage_identifier (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3092
<div class="variablelist"><table border="0" class="variablelist">
3094
<col align="left" valign="top">
3099
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3100
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3104
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3105
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier" title='The "storage-identifier" property'><span class="type">"storage-identifier"</span></a> property</td>
3109
<p class="since">Since 0.13.2</p>
3112
<div class="refsect2">
3113
<a name="tp-account-dup-storage-identifier-variant"></a><h3>tp_account_dup_storage_identifier_variant ()</h3>
3114
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * tp_account_dup_storage_identifier_variant
3115
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3117
Return provider-specific information used to identify this
3118
account. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-type"><code class="function">g_variant_get_type()</code></a> to check that the type
3119
is what you expect; for instance, if the
3120
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'><span class="type">"storage-provider"</span></a> has string-based user identifiers,
3121
this variant should have type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS"><code class="literal">G_VARIANT_TYPE_STRING</code></a>.
3123
<div class="variablelist"><table border="0" class="variablelist">
3125
<col align="left" valign="top">
3130
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3131
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3135
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3137
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-identifier-variant" title='The "storage-identifier-variant" property'><span class="type">"storage-identifier-variant"</span></a> property. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3142
<p class="since">Since 0.13.2</p>
3145
<div class="refsect2">
3146
<a name="tp-account-get-storage-restrictions"></a><h3>tp_account_get_storage_restrictions ()</h3>
3147
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="returnvalue">TpStorageRestrictionFlags</span></a> tp_account_get_storage_restrictions
3148
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>);</pre>
3152
<div class="variablelist"><table border="0" class="variablelist">
3154
<col align="left" valign="top">
3159
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3160
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3164
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3165
<td>the same as the <a class="link" href="telepathy-glib-account.html#TpAccount--storage-restrictions" title='The "storage-restrictions" property'><span class="type">"storage-restrictions"</span></a> property</td>
3169
<p class="since">Since 0.13.2</p>
3172
<div class="refsect2">
3173
<a name="tp-account-get-storage-specific-information-async"></a><h3>tp_account_get_storage_specific_information_async ()</h3>
3174
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_get_storage_specific_information_async
3175
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3176
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3177
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3179
Makes an asynchronous request of <em class="parameter"><code>self</code></em>'s StorageSpecificInformation
3180
property (part of the Account.Interface.Storage interface).
3183
When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You must then
3184
call <a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-finish" title="tp_account_get_storage_specific_information_finish ()"><code class="function">tp_account_get_storage_specific_information_finish()</code></a> to get the
3185
result of the request.
3187
<div class="variablelist"><table border="0" class="variablelist">
3189
<col align="left" valign="top">
3194
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3195
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3199
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3200
<td>a callback to call when the request is satisfied</td>
3203
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3204
<td>data to pass to <em class="parameter"><code>callback</code></em>
3209
<p class="since">Since 0.13.2</p>
3212
<div class="refsect2">
3213
<a name="tp-account-get-storage-specific-information-finish"></a><h3>tp_account_get_storage_specific_information_finish ()</h3>
3214
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> * tp_account_get_storage_specific_information_finish
3215
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3216
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3217
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3219
Retrieve the value of the request begun with
3220
<a class="link" href="telepathy-glib-account.html#tp-account-get-storage-specific-information-async" title="tp_account_get_storage_specific_information_async ()"><code class="function">tp_account_get_storage_specific_information_async()</code></a>.
3223
Beware that the returned value is only valid until <em class="parameter"><code>result</code></em> is freed.
3224
Copy it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-ref"><code class="function">g_hash_table_ref()</code></a> if you need to keep it for longer.
3226
<div class="variablelist"><table border="0" class="variablelist">
3228
<col align="left" valign="top">
3233
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3234
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3238
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
3239
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
3243
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3244
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
3247
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3248
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>
3249
of strings to GValues representing the D-Bus type a{sv}. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8 GObject.Value][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
3254
<p class="since">Since 0.13.2</p>
3257
<div class="refsect2">
3258
<a name="tp-account-dup-storage-specific-information-vardict-async"></a><h3>tp_account_dup_storage_specific_information_vardict_async ()</h3>
3259
<pre class="programlisting"><span class="returnvalue">void</span> tp_account_dup_storage_specific_information_vardict_async
3260
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3261
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
3262
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
3264
Makes an asynchronous request of <em class="parameter"><code>self</code></em>'s StorageSpecificInformation
3265
property (part of the Account.Interface.Storage interface).
3268
When the operation is finished, <em class="parameter"><code>callback</code></em> will be called. You must then
3269
call <a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-finish" title="tp_account_dup_storage_specific_information_vardict_finish ()"><code class="function">tp_account_dup_storage_specific_information_vardict_finish()</code></a> to get the
3270
result of the request.
3272
<div class="variablelist"><table border="0" class="variablelist">
3274
<col align="left" valign="top">
3279
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3280
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3284
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3285
<td>a callback to call when the request is satisfied</td>
3288
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3289
<td>data to pass to <em class="parameter"><code>callback</code></em>
3294
<p class="since">Since 0.17.6</p>
3297
<div class="refsect2">
3298
<a name="tp-account-dup-storage-specific-information-vardict-finish"></a><h3>tp_account_dup_storage_specific_information_vardict_finish ()</h3>
3299
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * tp_account_dup_storage_specific_information_vardict_finish
3300
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *self</code></em>,
3301
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
3302
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3304
Retrieve the value of the request begun with
3305
<a class="link" href="telepathy-glib-account.html#tp-account-dup-storage-specific-information-vardict-async" title="tp_account_dup_storage_specific_information_vardict_async ()"><code class="function">tp_account_dup_storage_specific_information_vardict_async()</code></a>.
3307
<div class="variablelist"><table border="0" class="variablelist">
3309
<col align="left" valign="top">
3314
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
3315
<td>a <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
3319
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
3320
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
3324
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3325
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
3328
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3329
<td>a map from strings to variants,
3330
of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-VARDICT:CAPS"><code class="literal">G_VARIANT_TYPE_VARDICT</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
3335
<p class="since">Since 0.17.6</p>
3338
<div class="refsect2">
3339
<a name="tp-cli-account-callback-for-reconnect"></a><h3>tp_cli_account_callback_for_reconnect ()</h3>
3340
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_callback_for_reconnect)
3341
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3342
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
3343
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3344
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3346
Signature of the callback called when a Reconnect method call
3349
<div class="variablelist"><table border="0" class="variablelist">
3351
<col align="left" valign="top">
3356
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3357
<td>the proxy on which the call was made</td>
3360
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3362
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
3365
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3366
<td>user-supplied data</td>
3369
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3370
<td>user-supplied object</td>
3376
<div class="refsect2">
3377
<a name="tp-cli-account-call-reconnect"></a><h3>tp_cli_account_call_reconnect ()</h3>
3378
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_account_call_reconnect (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3379
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
3380
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-reconnect" title="tp_cli_account_callback_for_reconnect ()"><span class="type">tp_cli_account_callback_for_reconnect</span></a> callback</code></em>,
3381
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3382
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3383
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3385
Start a Reconnect method call.
3388
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Re-connect this account. If the account is currently disconnected and the requested presence is offline, or if the account is not <tp:member-ref>Enabled</tp:member-ref> or not <tp:member-ref>Valid</tp:member-ref>, this does nothing.</p> <p>If the account is disconnected and the requested presence is not offline, this forces an attempt to connect with the requested presence immediately.</p> <p>If the account is connecting or connected, this is equivalent to remembering the current value of <tp:member-ref>RequestedPresence</tp:member-ref>, setting its value to (OFFLINE, &quot;offline&quot;, &quot;&quot;), waiting for the change to take effect, then setting its value to the value that was previously remembered.</p> <tp:rationale> <p>Clients desiring &quot;instant apply&quot; semantics for CM parameters MAY call this method to achieve that.</p> </tp:rationale> <p>In particular, if the account's <tp:member-ref>Connection</tp:member-ref> is in the Connecting state, calling this method causes the attempt to connect to be aborted and re-tried.</p> <tp:rationale> <p>This is necessary to ensure that the new parameters are picked up.</p> </tp:rationale>
3390
<div class="variablelist"><table border="0" class="variablelist">
3392
<col align="left" valign="top">
3397
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3398
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3402
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3403
<td>the timeout in milliseconds, or -1 to use the
3407
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3408
<td>called when the method call succeeds or fails;
3409
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3413
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3414
<td>user-supplied data passed to the callback;
3415
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3419
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3420
<td>called with the user_data as argument, after the
3421
call has succeeded, failed or been cancelled;
3422
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3426
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3427
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
3428
weakly referenced; if it is destroyed, this call
3429
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
3430
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3434
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3435
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
3436
progress. It is borrowed from the object, and will become
3437
invalid when the callback is called, the call is
3438
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
3444
<div class="refsect2">
3445
<a name="tp-cli-account-callback-for-remove"></a><h3>tp_cli_account_callback_for_remove ()</h3>
3446
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_callback_for_remove)
3447
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3448
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
3449
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3450
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3452
Signature of the callback called when a Remove method call
3455
<div class="variablelist"><table border="0" class="variablelist">
3457
<col align="left" valign="top">
3462
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3463
<td>the proxy on which the call was made</td>
3466
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3468
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
3471
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3472
<td>user-supplied data</td>
3475
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3476
<td>user-supplied object</td>
3482
<div class="refsect2">
3483
<a name="tp-cli-account-call-remove"></a><h3>tp_cli_account_call_remove ()</h3>
3484
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_account_call_remove (<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3485
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
3486
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-remove" title="tp_cli_account_callback_for_remove ()"><span class="type">tp_cli_account_callback_for_remove</span></a> callback</code></em>,
3487
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3488
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3489
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3491
Start a Remove method call.
3496
<div class="variablelist"><table border="0" class="variablelist">
3498
<col align="left" valign="top">
3503
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3504
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3508
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3509
<td>the timeout in milliseconds, or -1 to use the
3513
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3514
<td>called when the method call succeeds or fails;
3515
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3519
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3520
<td>user-supplied data passed to the callback;
3521
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3525
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3526
<td>called with the user_data as argument, after the
3527
call has succeeded, failed or been cancelled;
3528
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3532
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3533
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
3534
weakly referenced; if it is destroyed, this call
3535
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
3536
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3540
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3541
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
3542
progress. It is borrowed from the object, and will become
3543
invalid when the callback is called, the call is
3544
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
3550
<div class="refsect2">
3551
<a name="tp-cli-account-callback-for-update-parameters"></a><h3>tp_cli_account_callback_for_update_parameters ()</h3>
3552
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_callback_for_update_parameters)
3553
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3554
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Reconnect_Required</code></em>,
3555
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
3556
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3557
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3559
Signature of the callback called when a UpdateParameters method call
3562
<div class="variablelist"><table border="0" class="variablelist">
3564
<col align="left" valign="top">
3569
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3570
<td>the proxy on which the call was made</td>
3573
<td><p><span class="term"><em class="parameter"><code>out_Reconnect_Required</code></em> :</span></p></td>
3574
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If all of the updates could be applied to the active <tp:member-ref>Connection</tp:member-ref> (if any), the empty list, signifying that no reconnection is required for the new parameters to take effect. For example, if the only parameter updated is <tt>...Cellular.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Cellular">MessageValidityPeriod</tp:dbus-ref></tt>, the new value can be applied immediately to the connection.</p> <p>Otherwise, a list of the names of parameters with changes that will not take effect until the account is reconnected. User interfaces that require &quot;instant apply&quot; semantics MAY call <tp:member-ref>Reconnect</tp:member-ref> in response to receiving a non-empty list. For example, if the caller updates both <tt>...Anonymity.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Anonymity">AnonymityMandatory</tp:dbus-ref></tt> and <tt>require-encryption</tt>, the former can be applied to the current connection, but the latter needs a reconnect to take effect, so this method should return <code>[&quot;require-encryption&quot;]</code>.</p></td>
3577
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3579
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
3582
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3583
<td>user-supplied data</td>
3586
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3587
<td>user-supplied object</td>
3593
<div class="refsect2">
3594
<a name="tp-cli-account-call-update-parameters"></a><h3>tp_cli_account_call_update_parameters ()</h3>
3595
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_account_call_update_parameters
3596
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3597
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
3598
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Set</code></em>,
3599
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Unset</code></em>,
3600
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-callback-for-update-parameters" title="tp_cli_account_callback_for_update_parameters ()"><span class="type">tp_cli_account_callback_for_update_parameters</span></a> callback</code></em>,
3601
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3602
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3603
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3605
Start a UpdateParameters method call.
3608
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Change the value of the <tp:member-ref>Parameters</tp:member-ref> property.</p> <p>If any of the <var>Set</var> parameters’ <tp:type>Conn_Mgr_Param_Flags</tp:type> include <code>DBus_Property</code>, the change will be applied immediately to the corresponding D-Bus Property on the active <tp:member-ref>Connection</tp:member-ref>, if there is one. If any of the <var>Unset</var> parameters’ <tp:type>Conn_Mgr_Param_Flags</tp:type> include both <code>DBus_Property</code> and <code>Has_Default</code>, the corresponding D-Bus Property on the connection will be set to the default value. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected. (If parameters are explicitly set to their default value, or are unset when previously set to their default value, the account manager MAY decide that no reconnection is necessary to make the change take effect.)</p> <tp:rationale> <p>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.</p> </tp:rationale>
3610
<div class="variablelist"><table border="0" class="variablelist">
3612
<col align="left" valign="top">
3617
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3618
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3622
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3623
<td>the timeout in milliseconds, or -1 to use the
3627
<td><p><span class="term"><em class="parameter"><code>in_Set</code></em> :</span></p></td>
3628
<td>Used to pass an 'in' argument: A mapping from parameter names to their values. These parameters should be stored for future use.</td>
3631
<td><p><span class="term"><em class="parameter"><code>in_Unset</code></em> :</span></p></td>
3632
<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.</td>
3635
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3636
<td>called when the method call succeeds or fails;
3637
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
3641
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3642
<td>user-supplied data passed to the callback;
3643
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3647
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3648
<td>called with the user_data as argument, after the
3649
call has succeeded, failed or been cancelled;
3650
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3654
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3655
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
3656
weakly referenced; if it is destroyed, this call
3657
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
3658
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3662
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3663
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
3664
progress. It is borrowed from the object, and will become
3665
invalid when the callback is called, the call is
3666
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
3672
<div class="refsect2">
3673
<a name="tp-cli-account-signal-callback-account-property-changed"></a><h3>tp_cli_account_signal_callback_account_property_changed ()</h3>
3674
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_signal_callback_account_property_changed)
3675
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3676
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Properties</code></em>,
3677
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3678
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3680
Represents the signature of a callback for the signal AccountPropertyChanged.
3682
<div class="variablelist"><table border="0" class="variablelist">
3684
<col align="left" valign="top">
3689
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3690
<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>
3694
<td><p><span class="term"><em class="parameter"><code>arg_Properties</code></em> :</span></p></td>
3695
<td>A map from property names in this namespace (e.g. <tp:member-ref>Nickname</tp:member-ref>) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done.</td>
3698
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3699
<td>User-supplied data</td>
3702
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3703
<td>User-supplied weakly referenced object</td>
3709
<div class="refsect2">
3710
<a name="tp-cli-account-connect-to-account-property-changed"></a><h3>tp_cli_account_connect_to_account_property_changed ()</h3>
3711
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_account_connect_to_account_property_changed
3712
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3713
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_signal_callback_account_property_changed</span></a> callback</code></em>,
3714
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3715
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3716
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
3717
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3719
Connect a handler to the signal AccountPropertyChanged.
3722
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.
3724
<div class="variablelist"><table border="0" class="variablelist">
3726
<col align="left" valign="top">
3731
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3732
<td>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</td>
3735
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3736
<td>Callback to be called when the signal is
3740
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3741
<td>User-supplied data for the callback</td>
3744
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3745
<td>Destructor for the user-supplied data, which
3746
will be called when this signal is disconnected, or
3747
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3751
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3752
<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
3753
if it is destroyed, this callback will automatically be
3757
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3758
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3762
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3763
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3764
above, which can be used to disconnect the signal; or
3765
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3766
or has become invalid.</td>
3772
<div class="refsect2">
3773
<a name="tp-cli-account-signal-callback-removed"></a><h3>tp_cli_account_signal_callback_removed ()</h3>
3774
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_signal_callback_removed)
3775
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3776
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3777
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3779
Represents the signature of a callback for the signal Removed.
3781
<div class="variablelist"><table border="0" class="variablelist">
3783
<col align="left" valign="top">
3788
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3789
<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>
3793
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3794
<td>User-supplied data</td>
3797
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3798
<td>User-supplied weakly referenced object</td>
3804
<div class="refsect2">
3805
<a name="tp-cli-account-connect-to-removed"></a><h3>tp_cli_account_connect_to_removed ()</h3>
3806
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_account_connect_to_removed
3807
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3808
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-signal-callback-removed" title="tp_cli_account_signal_callback_removed ()"><span class="type">tp_cli_account_signal_callback_removed</span></a> callback</code></em>,
3809
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3810
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3811
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
3812
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3814
Connect a handler to the signal Removed.
3817
This account has been removed. <tp:rationale> This is redundant with <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">AccountRemoved</tp:dbus-ref>, 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. </tp:rationale>
3819
<div class="variablelist"><table border="0" class="variablelist">
3821
<col align="left" valign="top">
3826
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3827
<td>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</td>
3830
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3831
<td>Callback to be called when the signal is
3835
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3836
<td>User-supplied data for the callback</td>
3839
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3840
<td>Destructor for the user-supplied data, which
3841
will be called when this signal is disconnected, or
3842
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3846
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3847
<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
3848
if it is destroyed, this callback will automatically be
3852
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3853
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3857
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3858
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3859
above, which can be used to disconnect the signal; or
3860
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3861
or has become invalid.</td>
3867
<div class="refsect2">
3868
<a name="tp-cli-account-interface-avatar-signal-callback-avatar-changed"></a><h3>tp_cli_account_interface_avatar_signal_callback_avatar_changed ()</h3>
3869
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_interface_avatar_signal_callback_avatar_changed)
3870
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3871
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3872
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3874
Represents the signature of a callback for the signal AvatarChanged.
3876
<div class="variablelist"><table border="0" class="variablelist">
3878
<col align="left" valign="top">
3883
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3884
<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>
3888
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3889
<td>User-supplied data</td>
3892
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3893
<td>User-supplied weakly referenced object</td>
3899
<div class="refsect2">
3900
<a name="tp-cli-account-interface-avatar-connect-to-avatar-changed"></a><h3>tp_cli_account_interface_avatar_connect_to_avatar_changed ()</h3>
3901
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_account_interface_avatar_connect_to_avatar_changed
3902
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3903
<em class="parameter"><code><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 ()"><span class="type">tp_cli_account_interface_avatar_signal_callback_avatar_changed</span></a> callback</code></em>,
3904
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3905
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
3906
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
3907
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3909
Connect a handler to the signal AvatarChanged.
3912
Emitted when the Avatar property changes. <tp:rationale>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.</tp:rationale>
3914
<div class="variablelist"><table border="0" class="variablelist">
3916
<col align="left" valign="top">
3921
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3922
<td>A <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> or subclass</td>
3925
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3926
<td>Callback to be called when the signal is
3930
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3931
<td>User-supplied data for the callback</td>
3934
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3935
<td>Destructor for the user-supplied data, which
3936
will be called when this signal is disconnected, or
3937
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3941
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3942
<td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
3943
if it is destroyed, this callback will automatically be
3947
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3948
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3952
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3953
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3954
above, which can be used to disconnect the signal; or
3955
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3956
or has become invalid.</td>
3962
<div class="refsect2">
3963
<a name="tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association"></a><h3>tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()</h3>
3964
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association)
3965
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
3966
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
3967
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
3968
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3970
Signature of the callback called when a SetURISchemeAssociation method call
3973
<div class="variablelist"><table border="0" class="variablelist">
3975
<col align="left" valign="top">
3980
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3981
<td>the proxy on which the call was made</td>
3984
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3986
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
3989
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3990
<td>user-supplied data</td>
3993
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3994
<td>user-supplied object</td>
4000
<div class="refsect2">
4001
<a name="tp-cli-account-interface-addressing-call-set-uri-scheme-association"></a><h3>tp_cli_account_interface_addressing_call_set_uri_scheme_association ()</h3>
4002
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_account_interface_addressing_call_set_uri_scheme_association
4003
(<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *proxy</code></em>,
4004
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
4005
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_URI_Scheme</code></em>,
4006
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Association</code></em>,
4007
<em class="parameter"><code><a class="link" href="telepathy-glib-account.html#tp-cli-account-interface-addressing-callback-for-set-uri-scheme-association" title="tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association ()"><span class="type">tp_cli_account_interface_addressing_callback_for_set_uri_scheme_association</span></a> callback</code></em>,
4008
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
4009
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
4010
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
4012
Start a SetURISchemeAssociation method call.
4015
<p>Associate (or disassociate) an account with a particular URI addressing scheme, (such as 'tel' for telephony)</p>
4017
<div class="variablelist"><table border="0" class="variablelist">
4019
<col align="left" valign="top">
4024
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
4025
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
4029
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
4030
<td>the timeout in milliseconds, or -1 to use the
4034
<td><p><span class="term"><em class="parameter"><code>in_URI_Scheme</code></em> :</span></p></td>
4035
<td>Used to pass an 'in' argument: <p>URI scheme to associate/disassociate the account with/from</p></td>
4038
<td><p><span class="term"><em class="parameter"><code>in_Association</code></em> :</span></p></td>
4039
<td>Used to pass an 'in' argument: <p>True to associate this account with a given addressing scheme</p> <p>False if the account should not be associated with said scheme</p></td>
4042
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4043
<td>called when the method call succeeds or fails;
4044
may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no
4048
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4049
<td>user-supplied data passed to the callback;
4050
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4054
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
4055
<td>called with the user_data as argument, after the
4056
call has succeeded, failed or been cancelled;
4057
must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4061
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
4062
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
4063
weakly referenced; if it is destroyed, this call
4064
will automatically be cancelled. Must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
4065
<em class="parameter"><code>callback</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4069
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4070
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
4071
progress. It is borrowed from the object, and will become
4072
invalid when the callback is called, the call is
4073
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
5013
4079
<div class="refsect1">
5014
4080
<a name="telepathy-glib-account.property-details"></a><h2>Property Details</h2>
5015
4081
<div class="refsect2">
5016
<a name="TpAccount--automatic-presence-type"></a><h3>The <code class="literal">“automatic-presence-type”</code> property</h3>
5017
<pre class="programlisting"> “automatic-presence-type” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5018
<p>The account's automatic presence type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>).</p>
5019
<p>When the account is put online automatically, for instance to make a
4082
<a name="TpAccount--automatic-presence-type"></a><h3>The <code class="literal">"automatic-presence-type"</code> property</h3>
4083
<pre class="programlisting"> "automatic-presence-type" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4085
The account's automatic presence type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>).
4088
When the account is put online automatically, for instance to make a
5020
4089
channel request or because network connectivity becomes available,
5021
4090
the automatic presence type, status and message will be copied to
5022
their "requested" counterparts.</p>
5023
<p>One can receive change notifications on this property by connecting
5024
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
4091
their "requested" counterparts.
4094
One can receive change notifications on this property by connecting
4095
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
5025
4096
detail. Change notifications for automatic-presence-type,
5026
4097
automatic-status and automatic-status-message are always emitted together,
5027
so it is sufficient to connect to one of the notification signals.</p>
5028
<p>This is not guaranteed to have been retrieved until
5029
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5030
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-PRESENCE-TYPE-UNSET:CAPS"><code class="literal">TP_CONNECTION_PRESENCE_TYPE_UNSET</code></a>.</p>
4098
so it is sufficient to connect to one of the notification signals.
4101
This is not guaranteed to have been retrieved until
4102
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4103
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-PRESENCE-TYPE-UNSET:CAPS"><code class="literal">TP_CONNECTION_PRESENCE_TYPE_UNSET</code></a>.
5032
4105
<p>Allowed values: <= 9</p>
5033
4106
<p>Default value: 0</p>
5034
4107
<p class="since">Since 0.13.8</p>
5037
4110
<div class="refsect2">
5038
<a name="TpAccount--automatic-status"></a><h3>The <code class="literal">“automatic-status”</code> property</h3>
5039
<pre class="programlisting"> “automatic-status” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5040
<p>The string status name to use in conjunction with the
5041
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title="The “automatic-presence-type” property"><span class="type">“automatic-presence-type”</span></a>.</p>
5042
<p>One can receive change notifications on this property by connecting
5043
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5044
detail. Change notifications for automatic-presence-type,
5045
automatic-status and automatic-status-message are always emitted together,
5046
so it is sufficient to connect to one of the notification signals.</p>
5047
<p>This is not guaranteed to have been retrieved until
5048
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5049
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5051
<p>Default value: NULL</p>
5052
<p class="since">Since 0.13.8</p>
5055
<div class="refsect2">
5056
<a name="TpAccount--automatic-status-message"></a><h3>The <code class="literal">“automatic-status-message”</code> property</h3>
5057
<pre class="programlisting"> “automatic-status-message” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5058
<p>The user-defined message to use in conjunction with the
5059
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title="The “automatic-presence-type” property"><span class="type">“automatic-presence-type”</span></a>.</p>
5060
<p>One can receive change notifications on this property by connecting
5061
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5062
detail. Change notifications for automatic-presence-type,
5063
automatic-status and automatic-status-message are always emitted together,
5064
so it is sufficient to connect to one of the notification signals.</p>
5065
<p>This is not guaranteed to have been retrieved until
5066
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5067
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5069
<p>Default value: NULL</p>
5070
<p class="since">Since 0.13.8</p>
5073
<div class="refsect2">
5074
<a name="TpAccount--changing-presence"></a><h3>The <code class="literal">“changing-presence”</code> property</h3>
5075
<pre class="programlisting"> “changing-presence” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
5076
<p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an attempt is currently being made to change the account's
5077
presence (<a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title="The “current-presence-type” property"><span class="type">“current-presence-type”</span></a>, <a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title="The “current-status” property"><span class="type">“current-status”</span></a>
5078
and <a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title="The “current-status-message” property"><span class="type">“current-status-message”</span></a>) to match its requested presence
5079
(<a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title="The “requested-presence-type” property"><span class="type">“requested-presence-type”</span></a>, <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title="The “requested-status” property"><span class="type">“requested-status”</span></a>
5080
and <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title="The “requested-status-message” property"><span class="type">“requested-status-message”</span></a>).</p>
5081
<p>One can receive change notifications on this property by connecting
5082
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5084
<p>This is not guaranteed to have been retrieved until
5085
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5086
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
4111
<a name="TpAccount--automatic-status"></a><h3>The <code class="literal">"automatic-status"</code> property</h3>
4112
<pre class="programlisting"> "automatic-status" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4114
The string status name to use in conjunction with the
4115
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title='The "automatic-presence-type" property'><span class="type">"automatic-presence-type"</span></a>.
4118
One can receive change notifications on this property by connecting
4119
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4120
detail. Change notifications for automatic-presence-type,
4121
automatic-status and automatic-status-message are always emitted together,
4122
so it is sufficient to connect to one of the notification signals.
4125
This is not guaranteed to have been retrieved until
4126
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4127
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4129
<p>Default value: NULL</p>
4130
<p class="since">Since 0.13.8</p>
4133
<div class="refsect2">
4134
<a name="TpAccount--automatic-status-message"></a><h3>The <code class="literal">"automatic-status-message"</code> property</h3>
4135
<pre class="programlisting"> "automatic-status-message" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4137
The user-defined message to use in conjunction with the
4138
<a class="link" href="telepathy-glib-account.html#TpAccount--automatic-presence-type" title='The "automatic-presence-type" property'><span class="type">"automatic-presence-type"</span></a>.
4141
One can receive change notifications on this property by connecting
4142
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4143
detail. Change notifications for automatic-presence-type,
4144
automatic-status and automatic-status-message are always emitted together,
4145
so it is sufficient to connect to one of the notification signals.
4148
This is not guaranteed to have been retrieved until
4149
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4150
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4152
<p>Default value: NULL</p>
4153
<p class="since">Since 0.13.8</p>
4156
<div class="refsect2">
4157
<a name="TpAccount--changing-presence"></a><h3>The <code class="literal">"changing-presence"</code> property</h3>
4158
<pre class="programlisting"> "changing-presence" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
4160
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an attempt is currently being made to change the account's
4161
presence (<a class="link" href="telepathy-glib-account.html#TpAccount--current-presence-type" title='The "current-presence-type" property'><span class="type">"current-presence-type"</span></a>, <a class="link" href="telepathy-glib-account.html#TpAccount--current-status" title='The "current-status" property'><span class="type">"current-status"</span></a>
4162
and <a class="link" href="telepathy-glib-account.html#TpAccount--current-status-message" title='The "current-status-message" property'><span class="type">"current-status-message"</span></a>) to match its requested presence
4163
(<a class="link" href="telepathy-glib-account.html#TpAccount--requested-presence-type" title='The "requested-presence-type" property'><span class="type">"requested-presence-type"</span></a>, <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status" title='The "requested-status" property'><span class="type">"requested-status"</span></a>
4164
and <a class="link" href="telepathy-glib-account.html#TpAccount--requested-status-message" title='The "requested-status-message" property'><span class="type">"requested-status-message"</span></a>).
4167
One can receive change notifications on this property by connecting
4168
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4172
This is not guaranteed to have been retrieved until
4173
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4174
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
5088
4176
<p>Default value: FALSE</p>
5089
4177
<p class="since">Since 0.11.6</p>
5092
4180
<div class="refsect2">
5093
<a name="TpAccount--cm-name"></a><h3>The <code class="literal">“cm-name”</code> property</h3>
5094
<pre class="programlisting"> “cm-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5095
<p>The account's connection manager name.</p>
4181
<a name="TpAccount--cm-name"></a><h3>The <code class="literal">"cm-name"</code> property</h3>
4182
<pre class="programlisting"> "cm-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4184
The account's connection manager name.
5097
4186
<p>Default value: NULL</p>
5098
4187
<p class="since">Since 0.19.3</p>
5101
4190
<div class="refsect2">
5102
<a name="TpAccount--connect-automatically"></a><h3>The <code class="literal">“connect-automatically”</code> property</h3>
5103
<pre class="programlisting"> “connect-automatically” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
5104
<p>Whether the account should connect automatically or not. To change this
5105
property, use <a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-async" title="tp_account_set_connect_automatically_async ()"><code class="function">tp_account_set_connect_automatically_async()</code></a>.</p>
5106
<p>One can receive change notifications on this property by connecting
5107
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5109
<p>This is not guaranteed to have been retrieved until
5110
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5111
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
4191
<a name="TpAccount--connect-automatically"></a><h3>The <code class="literal">"connect-automatically"</code> property</h3>
4192
<pre class="programlisting"> "connect-automatically" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
4194
Whether the account should connect automatically or not. To change this
4195
property, use <a class="link" href="telepathy-glib-account.html#tp-account-set-connect-automatically-async" title="tp_account_set_connect_automatically_async ()"><code class="function">tp_account_set_connect_automatically_async()</code></a>.
4198
One can receive change notifications on this property by connecting
4199
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4203
This is not guaranteed to have been retrieved until
4204
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4205
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
5113
4207
<p>Default value: FALSE</p>
5114
4208
<p class="since">Since 0.9.0</p>
5117
4211
<div class="refsect2">
5118
<a name="TpAccount--connection"></a><h3>The <code class="literal">“connection”</code> property</h3>
5119
<pre class="programlisting"> “connection” <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *</pre>
5120
<p>The connection of the account, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if account is offline.
4212
<a name="TpAccount--connection"></a><h3>The <code class="literal">"connection"</code> property</h3>
4213
<pre class="programlisting"> "connection" <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>* : Read</pre>
4215
The connection of the account, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if account is offline.
5121
4216
Note that the returned <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> is not guaranteed to have any
5122
4217
features pre-prepared (not even <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CORE:CAPS" title="TP_CONNECTION_FEATURE_CORE"><code class="literal">TP_CONNECTION_FEATURE_CORE</code></a>) unless
5123
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS" title="TP_ACCOUNT_FEATURE_CONNECTION"><code class="literal">TP_ACCOUNT_FEATURE_CONNECTION</code></a> has been prepared on the account</p>
5124
<p>One can receive change notifications on this property by connecting
5125
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
4218
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS" title="TP_ACCOUNT_FEATURE_CONNECTION"><code class="literal">TP_ACCOUNT_FEATURE_CONNECTION</code></a> has been prepared on the account
4221
One can receive change notifications on this property by connecting
4222
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
5126
4223
detail. If <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-CONNECTION:CAPS" title="TP_ACCOUNT_FEATURE_CONNECTION"><code class="literal">TP_ACCOUNT_FEATURE_CONNECTION</code></a> has been prepared, this signal
5127
will be delayed until the connection is ready.</p>
5128
<p>This is not guaranteed to have been retrieved until
5129
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5130
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4224
will be delayed until the connection is ready.
4227
This is not guaranteed to have been retrieved until
4228
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4229
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5132
4231
<p class="since">Since 0.9.0</p>
5135
4234
<div class="refsect2">
5136
<a name="TpAccount--connection-error"></a><h3>The <code class="literal">“connection-error”</code> property</h3>
5137
<pre class="programlisting"> “connection-error” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5138
<p>The D-Bus error name for the last disconnection or connection failure,
4235
<a name="TpAccount--connection-error"></a><h3>The <code class="literal">"connection-error"</code> property</h3>
4236
<pre class="programlisting"> "connection-error" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4238
The D-Bus error name for the last disconnection or connection failure,
5139
4239
(in particular, <a class="link" href="telepathy-glib-errors.html#TP-ERROR-STR-CANCELLED:CAPS" title="TP_ERROR_STR_CANCELLED"><code class="literal">TP_ERROR_STR_CANCELLED</code></a> if it was disconnected by user
5140
request), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the account is connected.</p>
5141
<p>One can receive change notifications on this property by connecting
5142
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title="The “status-changed” signal"><span class="type">“status-changed”</span></a> signal, or by connecting
5143
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5145
<p>This is not guaranteed to have been retrieved until
5146
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5147
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4240
request), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the account is connected.
4243
One can receive change notifications on this property by connecting
4244
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title='The "status-changed" signal'><span class="type">"status-changed"</span></a> signal, or by connecting
4245
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4249
This is not guaranteed to have been retrieved until
4250
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4251
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5149
4253
<p>Default value: NULL</p>
5150
4254
<p class="since">Since 0.11.7</p>
5153
4257
<div class="refsect2">
5154
<a name="TpAccount--connection-error-details"></a><h3>The <code class="literal">“connection-error-details”</code> property</h3>
5155
<pre class="programlisting"> “connection-error-details” <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *</pre>
5156
<p>A map from string to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing extensible error details
5157
related to <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title="The “connection-error” property"><span class="type">“connection-error”</span></a>. Functions like <a class="link" href="telepathy-glib-asv.html#tp-asv-get-string" title="tp_asv_get_string ()"><code class="function">tp_asv_get_string()</code></a>
5158
can be used to read from this map.</p>
5159
<p>The keys for this map are defined by</p>
4258
<a name="TpAccount--connection-error-details"></a><h3>The <code class="literal">"connection-error-details"</code> property</h3>
4259
<pre class="programlisting"> "connection-error-details" <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>* : Read</pre>
4261
A map from string to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing extensible error details
4262
related to <a class="link" href="telepathy-glib-account.html#TpAccount--connection-error" title='The "connection-error" property'><span class="type">"connection-error"</span></a>. Functions like <a class="link" href="telepathy-glib-asv.html#tp-asv-get-string" title="tp_asv_get_string ()"><code class="function">tp_asv_get_string()</code></a>
4263
can be used to read from this map.
4266
The keys for this map are defined by
5160
4267
<a class="ulink" href="http://telepathy.freedesktop.org/spec/" target="_top">the Telepathy D-Bus
5161
4268
Interface Specification</a>. They will typically include
5162
<p><code class="literal">debug-message</code>, which is a debugging message in the C
5163
locale, analogous to <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.message.</p>
5164
<p>One can receive change notifications on this property by connecting
5165
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title="The “status-changed” signal"><span class="type">“status-changed”</span></a> signal, or by connecting
5166
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5168
<p>This is not guaranteed to have been retrieved until
5169
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4269
<code class="literal">debug-message</code>, which is a debugging message in the C
4270
locale, analogous to <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>.message.
4273
One can receive change notifications on this property by connecting
4274
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title='The "status-changed" signal'><span class="type">"status-changed"</span></a> signal, or by connecting
4275
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4279
This is not guaranteed to have been retrieved until
4280
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5172
4283
<p class="since">Since 0.11.7</p>
5175
4286
<div class="refsect2">
5176
<a name="TpAccount--connection-manager"></a><h3>The <code class="literal">“connection-manager”</code> property</h3>
5177
<pre class="programlisting"> “connection-manager” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5178
<p>The account's connection manager name.</p>
5179
<div class="warning">
5180
<p><code class="literal">TpAccount:connection-manager</code> is deprecated and should not be used in newly-written code.</p>
5181
<p>Use <a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title="The “cm-name” property"><span class="type">“cm-name”</span></a> instead.</p>
4287
<a name="TpAccount--connection-manager"></a><h3>The <code class="literal">"connection-manager"</code> property</h3>
4288
<pre class="programlisting"> "connection-manager" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4289
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
4290
<h3 class="title">Warning</h3>
4291
<p><code class="literal">TpAccount:connection-manager</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-account.html#TpAccount--cm-name" title='The "cm-name" property'><span class="type">"cm-name"</span></a> instead.</p>
4294
The account's connection manager name.
5184
4296
<p>Default value: NULL</p>
5185
4297
<p class="since">Since 0.9.0</p>
5188
4300
<div class="refsect2">
5189
<a name="TpAccount--connection-status"></a><h3>The <code class="literal">“connection-status”</code> property</h3>
5190
<pre class="programlisting"> “connection-status” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5191
<p>The account's connection status type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><code class="literal">TpConnectionStatus</code></a>).</p>
5192
<p>One can receive change notifications on this property by connecting
5193
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title="The “status-changed” signal"><span class="type">“status-changed”</span></a> signal, or by connecting
5194
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5196
<p>This is not guaranteed to have been retrieved until
5197
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5198
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-DISCONNECTED:CAPS"><code class="literal">TP_CONNECTION_STATUS_DISCONNECTED</code></a>.</p>
4301
<a name="TpAccount--connection-status"></a><h3>The <code class="literal">"connection-status"</code> property</h3>
4302
<pre class="programlisting"> "connection-status" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4304
The account's connection status type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><code class="literal">TpConnectionStatus</code></a>).
4307
One can receive change notifications on this property by connecting
4308
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title='The "status-changed" signal'><span class="type">"status-changed"</span></a> signal, or by connecting
4309
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4313
This is not guaranteed to have been retrieved until
4314
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4315
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-DISCONNECTED:CAPS"><code class="literal">TP_CONNECTION_STATUS_DISCONNECTED</code></a>.
5200
4317
<p>Allowed values: <= 3</p>
5201
4318
<p>Default value: 2</p>
5202
4319
<p class="since">Since 0.9.0</p>
5205
4322
<div class="refsect2">
5206
<a name="TpAccount--connection-status-reason"></a><h3>The <code class="literal">“connection-status-reason”</code> property</h3>
5207
<pre class="programlisting"> “connection-status-reason” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5208
<p>The account's connection status reason (a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><code class="literal">TpConnectionStatusReason</code></a>).</p>
5209
<p>One can receive change notifications on this property by connecting
5210
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title="The “status-changed” signal"><span class="type">“status-changed”</span></a> signal, or by connecting
5211
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5213
<p>This is not guaranteed to have been retrieved until
5214
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5215
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-REASON-NONE-SPECIFIED:CAPS"><code class="literal">TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED</code></a>.</p>
4323
<a name="TpAccount--connection-status-reason"></a><h3>The <code class="literal">"connection-status-reason"</code> property</h3>
4324
<pre class="programlisting"> "connection-status-reason" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4326
The account's connection status reason (a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><code class="literal">TpConnectionStatusReason</code></a>).
4329
One can receive change notifications on this property by connecting
4330
to the <a class="link" href="telepathy-glib-account.html#TpAccount-status-changed" title='The "status-changed" signal'><span class="type">"status-changed"</span></a> signal, or by connecting
4331
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4335
This is not guaranteed to have been retrieved until
4336
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4337
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-REASON-NONE-SPECIFIED:CAPS"><code class="literal">TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED</code></a>.
5217
4339
<p>Allowed values: <= 17</p>
5218
4340
<p>Default value: 0</p>
5219
4341
<p class="since">Since 0.9.0</p>
5222
4344
<div class="refsect2">
5223
<a name="TpAccount--current-presence-type"></a><h3>The <code class="literal">“current-presence-type”</code> property</h3>
5224
<pre class="programlisting"> “current-presence-type” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5225
<p>The account connection's current presence type
5226
(a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><code class="literal">TpConnectionPresenceType</code></a>).</p>
5227
<p>One can receive change notifications on this property by connecting
5228
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
4345
<a name="TpAccount--current-presence-type"></a><h3>The <code class="literal">"current-presence-type"</code> property</h3>
4346
<pre class="programlisting"> "current-presence-type" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4348
The account connection's current presence type
4349
(a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><code class="literal">TpConnectionPresenceType</code></a>).
4352
One can receive change notifications on this property by connecting
4353
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
5229
4354
detail. Change notifications for current-presence-type,
5230
4355
current-status and current-status-message are always emitted together,
5231
so it is sufficient to connect to one of the notification signals.</p>
5232
<p>This is not guaranteed to have been retrieved until
5233
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5234
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-PRESENCE-TYPE-UNSET:CAPS"><code class="literal">TP_CONNECTION_PRESENCE_TYPE_UNSET</code></a>.</p>
4356
so it is sufficient to connect to one of the notification signals.
4359
This is not guaranteed to have been retrieved until
4360
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4361
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-PRESENCE-TYPE-UNSET:CAPS"><code class="literal">TP_CONNECTION_PRESENCE_TYPE_UNSET</code></a>.
5236
4363
<p>Allowed values: <= 9</p>
5237
4364
<p>Default value: 0</p>
5238
4365
<p class="since">Since 0.9.0</p>
5241
4368
<div class="refsect2">
5242
<a name="TpAccount--current-status"></a><h3>The <code class="literal">“current-status”</code> property</h3>
5243
<pre class="programlisting"> “current-status” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5244
<p>The current Status string of the account.</p>
5245
<p>One can receive change notifications on this property by connecting
5246
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5247
detail. Change notifications for current-presence-type,
5248
current-status and current-status-message are always emitted together,
5249
so it is sufficient to connect to one of the notification signals.</p>
5250
<p>This is not guaranteed to have been retrieved until
5251
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5252
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5254
<p>Default value: NULL</p>
5255
<p class="since">Since 0.9.0</p>
5258
<div class="refsect2">
5259
<a name="TpAccount--current-status-message"></a><h3>The <code class="literal">“current-status-message”</code> property</h3>
5260
<pre class="programlisting"> “current-status-message” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5261
<p>The current status message message of the account.</p>
5262
<p>One can receive change notifications on this property by connecting
5263
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5264
detail. Change notifications for current-presence-type,
5265
current-status and current-status-message are always emitted together,
5266
so it is sufficient to connect to one of the notification signals.</p>
5267
<p>This is not guaranteed to have been retrieved until
5268
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5269
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5271
<p>Default value: NULL</p>
5272
<p class="since">Since 0.9.0</p>
5275
<div class="refsect2">
5276
<a name="TpAccount--display-name"></a><h3>The <code class="literal">“display-name”</code> property</h3>
5277
<pre class="programlisting"> “display-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5278
<p>The account's display name, from the DisplayName property.</p>
5279
<p>One can receive change notifications on this property by connecting
5280
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5282
<p>This is not guaranteed to have been retrieved until
5283
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5284
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5286
<p>Default value: NULL</p>
5287
<p class="since">Since 0.9.0</p>
5290
<div class="refsect2">
5291
<a name="TpAccount--enabled"></a><h3>The <code class="literal">“enabled”</code> property</h3>
5292
<pre class="programlisting"> “enabled” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
5293
<p>Whether this account is enabled or not.</p>
5294
<p>One can receive change notifications on this property by connecting
5295
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5297
<p>This is not guaranteed to have been retrieved until
5298
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is FALSE.</p>
5300
<p>Default value: FALSE</p>
5301
<p class="since">Since 0.9.0</p>
5304
<div class="refsect2">
5305
<a name="TpAccount--has-been-online"></a><h3>The <code class="literal">“has-been-online”</code> property</h3>
5306
<pre class="programlisting"> “has-been-online” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
5307
<p>Whether this account has been online or not.</p>
5308
<p>One can receive change notifications on this property by connecting
5309
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5311
<p>This is not guaranteed to have been retrieved until
5312
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5313
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
5315
<p>Default value: FALSE</p>
5316
<p class="since">Since 0.9.0</p>
5319
<div class="refsect2">
5320
<a name="TpAccount--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
5321
<pre class="programlisting"> “icon-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5322
<p>The account's icon name. To change this propery, use
5323
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-async" title="tp_account_set_icon_name_async ()"><code class="function">tp_account_set_icon_name_async()</code></a>.</p>
5324
<p>One can receive change notifications on this property by connecting
5325
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5327
<p>This is not guaranteed to have been retrieved until
5328
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5329
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5331
<p>Default value: NULL</p>
5332
<p class="since">Since 0.9.0</p>
5335
<div class="refsect2">
5336
<a name="TpAccount--nickname"></a><h3>The <code class="literal">“nickname”</code> property</h3>
5337
<pre class="programlisting"> “nickname” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5338
<p>The nickname that should be set for the user on this account.</p>
5339
<p>One can receive change notifications on this property by connecting
5340
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5342
<p>This is not guaranteed to have been retrieved until
5343
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5344
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5346
<p>Default value: NULL</p>
5347
<p class="since">Since 0.9.0</p>
5350
<div class="refsect2">
5351
<a name="TpAccount--normalized-name"></a><h3>The <code class="literal">“normalized-name”</code> property</h3>
5352
<pre class="programlisting"> “normalized-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5353
<p>The normalized form of the user's own unique identifier on this
4369
<a name="TpAccount--current-status"></a><h3>The <code class="literal">"current-status"</code> property</h3>
4370
<pre class="programlisting"> "current-status" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4372
The current Status string of the account.
4375
One can receive change notifications on this property by connecting
4376
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4377
detail. Change notifications for current-presence-type,
4378
current-status and current-status-message are always emitted together,
4379
so it is sufficient to connect to one of the notification signals.
4382
This is not guaranteed to have been retrieved until
4383
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4384
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4386
<p>Default value: NULL</p>
4387
<p class="since">Since 0.9.0</p>
4390
<div class="refsect2">
4391
<a name="TpAccount--current-status-message"></a><h3>The <code class="literal">"current-status-message"</code> property</h3>
4392
<pre class="programlisting"> "current-status-message" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4394
The current status message message of the account.
4397
One can receive change notifications on this property by connecting
4398
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4399
detail. Change notifications for current-presence-type,
4400
current-status and current-status-message are always emitted together,
4401
so it is sufficient to connect to one of the notification signals.
4404
This is not guaranteed to have been retrieved until
4405
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4406
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4408
<p>Default value: NULL</p>
4409
<p class="since">Since 0.9.0</p>
4412
<div class="refsect2">
4413
<a name="TpAccount--display-name"></a><h3>The <code class="literal">"display-name"</code> property</h3>
4414
<pre class="programlisting"> "display-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4416
The account's display name, from the DisplayName property.
4419
One can receive change notifications on this property by connecting
4420
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4424
This is not guaranteed to have been retrieved until
4425
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4426
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4428
<p>Default value: NULL</p>
4429
<p class="since">Since 0.9.0</p>
4432
<div class="refsect2">
4433
<a name="TpAccount--enabled"></a><h3>The <code class="literal">"enabled"</code> property</h3>
4434
<pre class="programlisting"> "enabled" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
4436
Whether this account is enabled or not.
4439
One can receive change notifications on this property by connecting
4440
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4444
This is not guaranteed to have been retrieved until
4445
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is FALSE.
4447
<p>Default value: FALSE</p>
4448
<p class="since">Since 0.9.0</p>
4451
<div class="refsect2">
4452
<a name="TpAccount--has-been-online"></a><h3>The <code class="literal">"has-been-online"</code> property</h3>
4453
<pre class="programlisting"> "has-been-online" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
4455
Whether this account has been online or not.
4458
One can receive change notifications on this property by connecting
4459
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4463
This is not guaranteed to have been retrieved until
4464
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4465
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
4467
<p>Default value: FALSE</p>
4468
<p class="since">Since 0.9.0</p>
4471
<div class="refsect2">
4472
<a name="TpAccount--icon-name"></a><h3>The <code class="literal">"icon-name"</code> property</h3>
4473
<pre class="programlisting"> "icon-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4475
The account's icon name. To change this propery, use
4476
<a class="link" href="telepathy-glib-account.html#tp-account-set-icon-name-async" title="tp_account_set_icon_name_async ()"><code class="function">tp_account_set_icon_name_async()</code></a>.
4479
One can receive change notifications on this property by connecting
4480
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4484
This is not guaranteed to have been retrieved until
4485
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4486
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4488
<p>Default value: NULL</p>
4489
<p class="since">Since 0.9.0</p>
4492
<div class="refsect2">
4493
<a name="TpAccount--nickname"></a><h3>The <code class="literal">"nickname"</code> property</h3>
4494
<pre class="programlisting"> "nickname" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4496
The nickname that should be set for the user on this account.
4499
One can receive change notifications on this property by connecting
4500
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4504
This is not guaranteed to have been retrieved until
4505
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4506
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4508
<p>Default value: NULL</p>
4509
<p class="since">Since 0.9.0</p>
4512
<div class="refsect2">
4513
<a name="TpAccount--normalized-name"></a><h3>The <code class="literal">"normalized-name"</code> property</h3>
4514
<pre class="programlisting"> "normalized-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4516
The normalized form of the user's own unique identifier on this
5354
4517
protocol. For example, on XMPP accounts this is the user's JID; on
5355
ICQ this is the user's UIN; and so on.</p>
5356
<p>One can receive change notifications on this property by connecting
5357
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5359
<p>This is not guaranteed to have been retrieved until
5360
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5361
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4518
ICQ this is the user's UIN; and so on.
4521
One can receive change notifications on this property by connecting
4522
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4526
This is not guaranteed to have been retrieved until
4527
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4528
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5363
4530
<p>Default value: NULL</p>
5364
4531
<p class="since">Since 0.13.8</p>
5367
4534
<div class="refsect2">
5368
<a name="TpAccount--protocol"></a><h3>The <code class="literal">“protocol”</code> property</h3>
5369
<pre class="programlisting"> “protocol” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5370
<p>The account's machine-readable protocol name, such as "jabber", "msn" or
4535
<a name="TpAccount--protocol"></a><h3>The <code class="literal">"protocol"</code> property</h3>
4536
<pre class="programlisting"> "protocol" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4537
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
4538
<h3 class="title">Warning</h3>
4539
<p><code class="literal">TpAccount:protocol</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title='The "protocol-name" property'><span class="type">"protocol-name"</span></a> instead.</p>
4542
The account's machine-readable protocol name, such as "jabber", "msn" or
5371
4543
"local-xmpp". Recommended names for most protocols can be found in the
5372
Telepathy D-Bus Interface Specification.</p>
5373
<div class="warning">
5374
<p><code class="literal">TpAccount:protocol</code> is deprecated and should not be used in newly-written code.</p>
5375
<p>Use <a class="link" href="telepathy-glib-account.html#TpAccount--protocol-name" title="The “protocol-name” property"><span class="type">“protocol-name”</span></a> instead.</p>
4544
Telepathy D-Bus Interface Specification.
5378
4546
<p>Default value: NULL</p>
5379
4547
<p class="since">Since 0.9.0</p>
5382
4550
<div class="refsect2">
5383
<a name="TpAccount--protocol-name"></a><h3>The <code class="literal">“protocol-name”</code> property</h3>
5384
<pre class="programlisting"> “protocol-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5385
<p>The account's machine-readable protocol name, such as "jabber", "msn" or
4551
<a name="TpAccount--protocol-name"></a><h3>The <code class="literal">"protocol-name"</code> property</h3>
4552
<pre class="programlisting"> "protocol-name" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4554
The account's machine-readable protocol name, such as "jabber", "msn" or
5386
4555
"local-xmpp". Recommended names for most protocols can be found in the
5387
Telepathy D-Bus Interface Specification.</p>
4556
Telepathy D-Bus Interface Specification.
5389
4558
<p>Default value: NULL</p>
5390
4559
<p class="since">Since 0.19.3</p>
5393
4562
<div class="refsect2">
5394
<a name="TpAccount--requested-presence-type"></a><h3>The <code class="literal">“requested-presence-type”</code> property</h3>
5395
<pre class="programlisting"> “requested-presence-type” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5396
<p>The account's requested presence type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>).</p>
4563
<a name="TpAccount--requested-presence-type"></a><h3>The <code class="literal">"requested-presence-type"</code> property</h3>
4564
<pre class="programlisting"> "requested-presence-type" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4566
The account's requested presence type (a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>).
5398
4570
one can receive change notifications on this property by connecting
5399
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
4571
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
5400
4572
detail. Change notifications for requested-presence-type,
5401
4573
requested-status and requested-status-message are always emitted together,
5402
so it is sufficient to connect to one of the notification signals.</p>
5403
<p>This is not guaranteed to have been retrieved until
5404
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5405
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4574
so it is sufficient to connect to one of the notification signals.
4577
This is not guaranteed to have been retrieved until
4578
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4579
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5407
4581
<p>Allowed values: <= 9</p>
5408
4582
<p>Default value: 0</p>
5409
4583
<p class="since">Since 0.9.0</p>
5412
4586
<div class="refsect2">
5413
<a name="TpAccount--requested-status"></a><h3>The <code class="literal">“requested-status”</code> property</h3>
5414
<pre class="programlisting"> “requested-status” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5415
<p>The requested Status string of the account.</p>
5417
one can receive change notifications on this property by connecting
5418
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5419
detail. Change notifications for requested-presence-type,
5420
requested-status and requested-status-message are always emitted together,
5421
so it is sufficient to connect to one of the notification signals.</p>
5422
<p>This is not guaranteed to have been retrieved until
5423
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5424
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5426
<p>Default value: NULL</p>
5427
<p class="since">Since 0.9.0</p>
5430
<div class="refsect2">
5431
<a name="TpAccount--requested-status-message"></a><h3>The <code class="literal">“requested-status-message”</code> property</h3>
5432
<pre class="programlisting"> “requested-status-message” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5433
<p>The requested status message message of the account.</p>
5435
one can receive change notifications on this property by connecting
5436
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5437
detail. Change notifications for requested-presence-type,
5438
requested-status and requested-status-message are always emitted together,
5439
so it is sufficient to connect to one of the notification signals.</p>
5440
<p>This is not guaranteed to have been retrieved until
5441
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5442
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5444
<p>Default value: NULL</p>
5445
<p class="since">Since 0.9.0</p>
5448
<div class="refsect2">
5449
<a name="TpAccount--service"></a><h3>The <code class="literal">“service”</code> property</h3>
5450
<pre class="programlisting"> “service” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5451
<p>A machine-readable name identifying a specific service to which this
5452
account connects, or a copy of <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title="The “protocol” property"><span class="type">“protocol”</span></a> if there is no more
5453
specific service.</p>
5454
<p>Well-known names for various services can be found in the Telepathy D-Bus
5455
Interface Specification.</p>
5456
<p>For instance, accounts for the "jabber" protocol should have the service
4587
<a name="TpAccount--requested-status"></a><h3>The <code class="literal">"requested-status"</code> property</h3>
4588
<pre class="programlisting"> "requested-status" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4590
The requested Status string of the account.
4594
one can receive change notifications on this property by connecting
4595
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4596
detail. Change notifications for requested-presence-type,
4597
requested-status and requested-status-message are always emitted together,
4598
so it is sufficient to connect to one of the notification signals.
4601
This is not guaranteed to have been retrieved until
4602
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4603
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4605
<p>Default value: NULL</p>
4606
<p class="since">Since 0.9.0</p>
4609
<div class="refsect2">
4610
<a name="TpAccount--requested-status-message"></a><h3>The <code class="literal">"requested-status-message"</code> property</h3>
4611
<pre class="programlisting"> "requested-status-message" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4613
The requested status message message of the account.
4617
one can receive change notifications on this property by connecting
4618
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4619
detail. Change notifications for requested-presence-type,
4620
requested-status and requested-status-message are always emitted together,
4621
so it is sufficient to connect to one of the notification signals.
4624
This is not guaranteed to have been retrieved until
4625
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4626
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4628
<p>Default value: NULL</p>
4629
<p class="since">Since 0.9.0</p>
4632
<div class="refsect2">
4633
<a name="TpAccount--service"></a><h3>The <code class="literal">"service"</code> property</h3>
4634
<pre class="programlisting"> "service" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4636
A machine-readable name identifying a specific service to which this
4637
account connects, or a copy of <a class="link" href="telepathy-glib-account.html#TpAccount--protocol" title='The "protocol" property'><span class="type">"protocol"</span></a> if there is no more
4641
Well-known names for various services can be found in the Telepathy D-Bus
4642
Interface Specification.
4645
For instance, accounts for the "jabber" protocol should have the service
5457
4646
names "google-talk", "ovi-chat", "facebook" and "lj-talk" for accounts
5458
4647
that connect to Google Talk, Ovi Chat, Facebook and Livejournal,
5459
4648
respectively, and this property will be "jabber" for accounts that
5460
connect to a generic Jabber server.</p>
5461
<p>To change this property, use
5462
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()"><code class="function">tp_account_set_service_async()</code></a>.</p>
4649
connect to a generic Jabber server.
4652
To change this property, use
4653
<a class="link" href="telepathy-glib-account.html#tp-account-set-service-async" title="tp_account_set_service_async ()"><code class="function">tp_account_set_service_async()</code></a>.
5464
4655
<p>Default value: NULL</p>
5465
4656
<p class="since">Since 0.11.9</p>
5468
4659
<div class="refsect2">
5469
<a name="TpAccount--storage-identifier"></a><h3>The <code class="literal">“storage-identifier”</code> property</h3>
5470
<pre class="programlisting"> “storage-identifier” <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *</pre>
5471
<p>The storage identifier for this account.</p>
5472
<p>A provider-specific variant type used to identify this account with the
5473
provider. This value will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property"><span class="type">“storage-provider”</span></a> is
5474
an empty string.</p>
5475
<p>This property cannot change once an Account has been created.</p>
5476
<p>This is not guaranteed to have been retrieved until the
4660
<a name="TpAccount--storage-identifier"></a><h3>The <code class="literal">"storage-identifier"</code> property</h3>
4661
<pre class="programlisting"> "storage-identifier" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>* : Read</pre>
4663
The storage identifier for this account.
4666
A provider-specific variant type used to identify this account with the
4667
provider. This value will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'><span class="type">"storage-provider"</span></a> is
4671
This property cannot change once an Account has been created.
4674
This is not guaranteed to have been retrieved until the
5477
4675
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE"><code class="literal">TP_ACCOUNT_FEATURE_STORAGE</code></a> feature has been prepared; until then,
5478
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4676
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5480
4678
<p class="since">Since 0.13.2</p>
5483
4681
<div class="refsect2">
5484
<a name="TpAccount--storage-identifier-variant"></a><h3>The <code class="literal">“storage-identifier-variant”</code> property</h3>
5485
<pre class="programlisting"> “storage-identifier-variant” <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *</pre>
5486
<p>Provider-specific information used to identify this
4682
<a name="TpAccount--storage-identifier-variant"></a><h3>The <code class="literal">"storage-identifier-variant"</code> property</h3>
4683
<pre class="programlisting"> "storage-identifier-variant" <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>* : Read</pre>
4685
Provider-specific information used to identify this
5487
4686
account. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-type"><code class="function">g_variant_get_type()</code></a> to check that the type
5488
4687
is what you expect. For instance, if you use a
5489
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property"><span class="type">“storage-provider”</span></a> with numeric identifiers for accounts,
4688
<a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'><span class="type">"storage-provider"</span></a> with numeric identifiers for accounts,
5490
4689
this variant might have type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-UINT32:CAPS"><code class="literal">G_VARIANT_TYPE_UINT32</code></a>;
5491
4690
if the storage provider has string-based identifiers, it should
5492
have type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS"><code class="literal">G_VARIANT_TYPE_STRING</code></a>.</p>
5493
<p>This property cannot change once an Account has been created.</p>
5494
<p>This is not guaranteed to have been retrieved until the
4691
have type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS"><code class="literal">G_VARIANT_TYPE_STRING</code></a>.
4694
This property cannot change once an Account has been created.
4697
This is not guaranteed to have been retrieved until the
5495
4698
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE"><code class="literal">TP_ACCOUNT_FEATURE_STORAGE</code></a> feature has been prepared; until then,
5496
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4699
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5498
4701
<p>Allowed values: GVariant<*></p>
5499
4702
<p>Default value: NULL</p>
5500
4703
<p class="since">Since 0.13.2</p>
5503
4706
<div class="refsect2">
5504
<a name="TpAccount--storage-provider"></a><h3>The <code class="literal">“storage-provider”</code> property</h3>
5505
<pre class="programlisting"> “storage-provider” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
5506
<p>The storage provider for this account.</p>
5507
<p>The name of the account storage implementation. When this
5508
is the empty string the account is internally stored.</p>
5509
<p>This property cannot change once an Account has been created.</p>
5510
<p>This is not guaranteed to have been retrieved until the
4707
<a name="TpAccount--storage-provider"></a><h3>The <code class="literal">"storage-provider"</code> property</h3>
4708
<pre class="programlisting"> "storage-provider" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read</pre>
4710
The storage provider for this account.
4713
The name of the account storage implementation. When this
4714
is the empty string the account is internally stored.
4717
This property cannot change once an Account has been created.
4720
This is not guaranteed to have been retrieved until the
5511
4721
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE"><code class="literal">TP_ACCOUNT_FEATURE_STORAGE</code></a> feature has been prepared; until then,
5512
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
4722
the value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
5514
4724
<p>Default value: NULL</p>
5515
4725
<p class="since">Since 0.13.2</p>
5518
4728
<div class="refsect2">
5519
<a name="TpAccount--storage-restrictions"></a><h3>The <code class="literal">“storage-restrictions”</code> property</h3>
5520
<pre class="programlisting"> “storage-restrictions” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
5521
<p>The storage restrictions for this account.</p>
5522
<p>A bitfield of <a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="type">TpStorageRestrictionFlags</span></a> that give the limitations of
4729
<a name="TpAccount--storage-restrictions"></a><h3>The <code class="literal">"storage-restrictions"</code> property</h3>
4730
<pre class="programlisting"> "storage-restrictions" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre>
4732
The storage restrictions for this account.
4735
A bitfield of <a class="link" href="telepathy-glib-enums.html#TpStorageRestrictionFlags" title="enum TpStorageRestrictionFlags"><span class="type">TpStorageRestrictionFlags</span></a> that give the limitations of
5523
4736
this account imposed by the storage provider. This value will be 0
5524
if <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title="The “storage-provider” property"><span class="type">“storage-provider”</span></a> is an empty string.</p>
5525
<p>This property cannot change once an Account has been created.</p>
5526
<p>This is not guaranteed to have been retrieved until the
4737
if <a class="link" href="telepathy-glib-account.html#TpAccount--storage-provider" title='The "storage-provider" property'><span class="type">"storage-provider"</span></a> is an empty string.
4740
This property cannot change once an Account has been created.
4743
This is not guaranteed to have been retrieved until the
5527
4744
<a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-STORAGE:CAPS" title="TP_ACCOUNT_FEATURE_STORAGE"><code class="literal">TP_ACCOUNT_FEATURE_STORAGE</code></a> feature has been prepared; until then,
5530
4747
<p>Default value: 0</p>
5531
4748
<p class="since">Since 0.13.2</p>
5534
4751
<div class="refsect2">
5535
<a name="TpAccount--supersedes"></a><h3>The <code class="literal">“supersedes”</code> property</h3>
5536
<pre class="programlisting"> “supersedes” <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></pre>
5537
<p>The object paths of previously-active accounts superseded by this one.
4752
<a name="TpAccount--supersedes"></a><h3>The <code class="literal">"supersedes"</code> property</h3>
4753
<pre class="programlisting"> "supersedes" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> : Read</pre>
4755
The object paths of previously-active accounts superseded by this one.
5538
4756
For instance, this can be used in a logger to read old logs for an
5539
account that has been migrated from one connection manager to another.</p>
5540
<p>This is not guaranteed to have been retrieved until the
4757
account that has been migrated from one connection manager to another.
4760
This is not guaranteed to have been retrieved until the
5541
4761
<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 has been prepared; until then,
5542
the value is NULL.</p>
5544
4764
<p class="since">Since 0.17.5</p>
5547
4767
<div class="refsect2">
5548
<a name="TpAccount--uri-schemes"></a><h3>The <code class="literal">“uri-schemes”</code> property</h3>
5549
<pre class="programlisting"> “uri-schemes” <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></pre>
5550
<p>If the <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING"><code class="literal">TP_ACCOUNT_FEATURE_ADDRESSING</code></a> feature has been prepared
4768
<a name="TpAccount--uri-schemes"></a><h3>The <code class="literal">"uri-schemes"</code> property</h3>
4769
<pre class="programlisting"> "uri-schemes" <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> : Read</pre>
4771
If the <a class="link" href="telepathy-glib-account.html#TP-ACCOUNT-FEATURE-ADDRESSING:CAPS" title="TP_ACCOUNT_FEATURE_ADDRESSING"><code class="literal">TP_ACCOUNT_FEATURE_ADDRESSING</code></a> feature has been prepared
5551
4772
successfully, a list of additional URI schemes for which this
5552
account should be used if possible. Otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
5553
<p>For instance, a SIP or Skype account might have "tel" in this list if the
5554
user would like to use that account to call phone numbers.</p>
5555
<p>This list should not contain the primary URI scheme(s) for the account's
4773
account should be used if possible. Otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
4776
For instance, a SIP or Skype account might have "tel" in this list if the
4777
user would like to use that account to call phone numbers.
4780
This list should not contain the primary URI scheme(s) for the account's
5556
4781
protocol (for instance, "xmpp" for XMPP, or "sip" or "sips" for SIP),
5557
since it should be assumed to be useful for those schemes in any case.</p>
5558
<p>The notify::uri-schemes signal cannot be relied on if the Account Manager
5559
is Mission Control version 5.14.0 or older.</p>
4782
since it should be assumed to be useful for those schemes in any case.
4785
The notify::uri-schemes signal cannot be relied on if the Account Manager
4786
is Mission Control version 5.14.0 or older.
5561
4788
<p class="since">Since 0.21.0</p>
5564
4791
<div class="refsect2">
5565
<a name="TpAccount--valid"></a><h3>The <code class="literal">“valid”</code> property</h3>
5566
<pre class="programlisting"> “valid” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
5567
<p>Whether this account is valid.</p>
5568
<p>One can receive change notifications on this property by connecting
5569
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal and using this property as the signal
5571
<p>This is not guaranteed to have been retrieved until
5572
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
5573
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
4792
<a name="TpAccount--valid"></a><h3>The <code class="literal">"valid"</code> property</h3>
4793
<pre class="programlisting"> "valid" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
4795
Whether this account is valid.
4798
One can receive change notifications on this property by connecting
4799
to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal and using this property as the signal
4803
This is not guaranteed to have been retrieved until
4804
<a class="link" href="telepathy-glib-proxy.html#tp-proxy-prepare-async" title="tp_proxy_prepare_async ()"><code class="function">tp_proxy_prepare_async()</code></a> has finished; until then, the value is
4805
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
5575
4807
<p>Default value: FALSE</p>
5576
4808
<p class="since">Since 0.9.0</p>