← Back to branch summary

~ubuntu-branches/ubuntu/maverick/telepathy-glib/maverick

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-connection.html

  • Committer: Bazaar Package Importer
  • Author(s): Simon McVittie
  • Date: 2010-05-10 17:59:54 UTC
  • mfrom: (1.6.1 upstream) (27.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20100510175954-bxvqq3xx0sy4itmp
Tags: 0.11.5-1
New upstream version with new API/ABI

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/telepathy-glib-connection.html
8
8
<link rel="up" href="ch-client.html" title="Client-side proxies">
9
9
<link rel="prev" href="telepathy-glib-connection-manager.html" title="TpConnectionManager">
10
10
<link rel="next" href="telepathy-glib-contact.html" title="TpContact">
11
 
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="ch-dbus.html" title="General D-Bus support">
14
 
<link rel="chapter" href="ch-protocol.html" title="The Telepathy protocol">
15
 
<link rel="chapter" href="ch-client.html" title="Client-side proxies">
16
 
<link rel="chapter" href="ch-service-dbus.html" title="Service-side D-Bus interfaces">
17
 
<link rel="chapter" href="ch-service-base.html" title="Service-side implementation">
18
 
<link rel="chapter" href="ch-service-handles.html" title="Service-side handle repositories">
19
 
<link rel="chapter" href="ch-utilities.html" title="Utilities">
20
13
</head>
21
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
22
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
51
44
<a name="TpConnection"></a><pre class="synopsis">
52
45
#include &lt;telepathy-glib/connection.h&gt;
53
46
 
54
 
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()">*TpConnectionNameListCb</a>)           (const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *names,
55
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a> n,
56
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *cms,
57
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *protocols,
58
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
59
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
60
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
61
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()">tp_list_connection_names</a>            (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="returnvalue">TpDBusDaemon</span></a> *bus_daemon,
62
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()"><span class="returnvalue">TpConnectionNameListCb</span></a> callback,
63
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
64
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
65
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
66
 
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *      <a class="link" href="telepathy-glib-connection.html#tp-connection-new" title="tp_connection_new ()">tp_connection_new</a>                   (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="returnvalue">TpDBusDaemon</span></a> *dbus,
67
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *bus_name,
68
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *object_path,
69
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
70
 
<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-connection.html#tp-connection-run-until-ready" title="tp_connection_run_until_ready ()">tp_connection_run_until_ready</a>       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
71
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> connect,
72
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
73
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
74
 
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()">*TpConnectionWhenReadyCb</a>)          (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
75
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
76
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
77
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()">tp_connection_call_when_ready</a>       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
78
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()"><span class="returnvalue">TpConnectionWhenReadyCb</span></a> callback,
79
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
80
 
<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-connection.html#tp-connection-is-ready" title="tp_connection_is_ready ()">tp_connection_is_ready</a>              (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self);
81
 
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>  <a class="link" href="telepathy-glib-connection.html#tp-connection-get-status" title="tp_connection_get_status ()">tp_connection_get_status</a>            (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
82
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="returnvalue">TpConnectionStatusReason</span></a> *reason);
83
 
<a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-connection-get-self-handle" title="tp_connection_get_self_handle ()">tp_connection_get_self_handle</a>       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self);
84
 
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()">*TpConnectionRequestHandlesCb</a>)     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
85
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
86
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
87
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
88
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *ids,
89
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
90
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
91
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
92
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()">tp_connection_request_handles</a>       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
93
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
94
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
95
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *ids,
96
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()"><span class="returnvalue">TpConnectionRequestHandlesCb</span></a> callback,
97
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
98
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
99
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
100
 
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()">*TpConnectionHoldHandlesCb</a>)        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
101
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
102
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
103
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
104
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
105
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
106
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
107
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-get-contact-attributes" title="tp_connection_get_contact_attributes ()">tp_connection_get_contact_attributes</a>
108
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
109
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
110
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
111
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
112
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *interfaces,
113
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> hold,
114
 
                                                         <a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()"><span class="returnvalue">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</span></a> callback,
115
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
116
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
117
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
118
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()">tp_connection_hold_handles</a>          (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
119
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
120
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
121
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
122
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
123
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()"><span class="returnvalue">TpConnectionHoldHandlesCb</span></a> callback,
124
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
125
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
126
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
127
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-unref-handles" title="tp_connection_unref_handles ()">tp_connection_unref_handles</a>         (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
128
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
129
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
130
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles);
131
 
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-init-known-interfaces" title="tp_connection_init_known_interfaces ()">tp_connection_init_known_interfaces</a> (void);
132
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="telepathy-glib-connection.html#tp-connection-presence-type-cmp-availability" title="tp_connection_presence_type_cmp_availability ()">tp_connection_presence_type_cmp_availability</a>
133
 
                                                        (<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> p1,
134
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> p2);
135
 
<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-connection.html#tp-connection-parse-object-path" title="tp_connection_parse_object_path ()">tp_connection_parse_object_path</a>     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
136
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **protocol,
137
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **cm_name);
 
47
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()">*TpConnectionNameListCb</a>)           (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *names</code></em>,
 
48
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n</code></em>,
 
49
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *cms</code></em>,
 
50
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *protocols</code></em>,
 
51
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
52
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
53
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
54
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()">tp_list_connection_names</a>            (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,
 
55
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()"><span class="type">TpConnectionNameListCb</span></a> callback</code></em>,
 
56
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
57
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
58
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
138
59
                    <a class="link" href="telepathy-glib-connection.html#TpConnection-struct" title="TpConnection">TpConnection</a>;
139
60
                    <a class="link" href="telepathy-glib-connection.html#TpConnectionClass" title="TpConnectionClass">TpConnectionClass</a>;
 
61
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *      <a class="link" href="telepathy-glib-connection.html#tp-connection-new" title="tp_connection_new ()">tp_connection_new</a>                   (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
 
62
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *bus_name</code></em>,
 
63
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
64
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
65
#define             <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CORE:CAPS" title="TP_CONNECTION_FEATURE_CORE">TP_CONNECTION_FEATURE_CORE</a>
 
66
#define             <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CONNECTED:CAPS" title="TP_CONNECTION_FEATURE_CONNECTED">TP_CONNECTION_FEATURE_CONNECTED</a>
 
67
#define             <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CAPABILITIES:CAPS" title="TP_CONNECTION_FEATURE_CAPABILITIES">TP_CONNECTION_FEATURE_CAPABILITIES</a>
 
68
#define             <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-AVATAR-REQUIREMENTS:CAPS" title="TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS">TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS</a>
 
69
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-connection-run-until-ready" title="tp_connection_run_until_ready ()">tp_connection_run_until_ready</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
70
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> connect</code></em>,
 
71
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
72
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
 
73
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()">*TpConnectionWhenReadyCb</a>)          (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
74
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
75
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
76
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()">tp_connection_call_when_ready</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
77
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()"><span class="type">TpConnectionWhenReadyCb</span></a> callback</code></em>,
 
78
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
79
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-connection-is-ready" title="tp_connection_is_ready ()">tp_connection_is_ready</a>              (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);
 
80
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>  <a class="link" href="telepathy-glib-connection.html#tp-connection-get-status" title="tp_connection_get_status ()">tp_connection_get_status</a>            (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
81
                                                         <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>);
 
82
<a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-connection-get-self-handle" title="tp_connection_get_self_handle ()">tp_connection_get_self_handle</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);
 
83
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()">*TpConnectionRequestHandlesCb</a>)     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
84
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
85
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
86
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
87
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *ids</code></em>,
 
88
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
89
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
90
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
91
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()">tp_connection_request_handles</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
92
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
93
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
94
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *ids</code></em>,
 
95
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()"><span class="type">TpConnectionRequestHandlesCb</span></a> callback</code></em>,
 
96
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
97
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
98
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
99
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()">*TpConnectionHoldHandlesCb</a>)        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
100
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
101
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
102
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
103
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
104
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
105
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
106
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-get-contact-attributes" title="tp_connection_get_contact_attributes ()">tp_connection_get_contact_attributes</a>
 
107
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
108
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
109
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
110
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
111
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *interfaces</code></em>,
 
112
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> hold</code></em>,
 
113
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()"><span class="type">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</span></a> callback</code></em>,
 
114
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
115
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
116
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
117
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()">tp_connection_hold_handles</a>          (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
118
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
119
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
120
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
121
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
122
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()"><span class="type">TpConnectionHoldHandlesCb</span></a> callback</code></em>,
 
123
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
124
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
125
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
126
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-unref-handles" title="tp_connection_unref_handles ()">tp_connection_unref_handles</a>         (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
127
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
128
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
129
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>);
 
130
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-connection-init-known-interfaces" title="tp_connection_init_known_interfaces ()">tp_connection_init_known_interfaces</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
 
131
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="telepathy-glib-connection.html#tp-connection-presence-type-cmp-availability" title="tp_connection_presence_type_cmp_availability ()">tp_connection_presence_type_cmp_availability</a>
 
132
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> p1</code></em>,
 
133
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> p2</code></em>);
 
134
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-connection-parse-object-path" title="tp_connection_parse_object_path ()">tp_connection_parse_object_path</a>     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
135
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **protocol</code></em>,
 
136
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **cm_name</code></em>);
 
137
<a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="returnvalue">TpCapabilities</span></a> *    <a class="link" href="telepathy-glib-connection.html#tp-connection-get-capabilities" title="tp_connection_get_capabilities ()">tp_connection_get_capabilities</a>      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);
 
138
<a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-connection-get-avatar-requirements" title="tp_connection_get_avatar_requirements ()">tp_connection_get_avatar_requirements</a>
 
139
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);
140
140
#define             <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS:CAPS" title="TP_UNKNOWN_CONNECTION_STATUS">TP_UNKNOWN_CONNECTION_STATUS</a>
141
141
#define             <a class="link" href="telepathy-glib-connection.html#TP-ERRORS-DISCONNECTED:CAPS" title="TP_ERRORS_DISCONNECTED">TP_ERRORS_DISCONNECTED</a>
142
 
 
 
142
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="telepathy-glib-connection.html#tp-connection-get-detailed-error" title="tp_connection_get_detailed_error ()">tp_connection_get_detailed_error</a>    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
143
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **details</code></em>);
 
144
 
 
145
 
 
146
#define             <a class="link" href="telepathy-glib-connection.html#TP-TYPE-AVATAR-REQUIREMENTS:CAPS" title="TP_TYPE_AVATAR_REQUIREMENTS">TP_TYPE_AVATAR_REQUIREMENTS</a>
 
147
                    <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements">TpAvatarRequirements</a>;
 
148
<a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-avatar-requirements-new" title="tp_avatar_requirements_new ()">tp_avatar_requirements_new</a>       (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> supported_mime_types</code></em>,
 
149
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minimum_width</code></em>,
 
150
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minimum_height</code></em>,
 
151
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> recommended_width</code></em>,
 
152
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> recommended_height</code></em>,
 
153
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_width</code></em>,
 
154
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_height</code></em>,
 
155
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_bytes</code></em>);
 
156
<a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-avatar-requirements-copy" title="tp_avatar_requirements_copy ()">tp_avatar_requirements_copy</a>      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a> *self</code></em>);
 
157
<span class="returnvalue">void</span>                <a class="link" href="telepathy-glib-connection.html#tp-avatar-requirements-destroy" title="tp_avatar_requirements_destroy ()">tp_avatar_requirements_destroy</a>      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a> *self</code></em>);
143
158
 
144
159
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()">*tp_cli_connection_callback_for_connect</a>)
145
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
146
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
147
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
148
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
149
 
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()">tp_cli_connection_call_connect</a>     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
150
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
151
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()"><span class="returnvalue">tp_cli_connection_callback_for_connect</span></a> callback,
152
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
153
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
154
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
155
 
<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-connection.html#tp-cli-connection-run-connect" title="tp_cli_connection_run_connect ()">tp_cli_connection_run_connect</a>       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
156
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
157
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
158
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
160
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
161
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
162
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
163
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
164
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()">tp_cli_connection_call_connect</a>     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
165
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
166
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()"><span class="type">tp_cli_connection_callback_for_connect</span></a> callback</code></em>,
 
167
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
168
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
169
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
170
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-connect" title="tp_cli_connection_run_connect ()">tp_cli_connection_run_connect</a>       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
171
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
172
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
173
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
159
174
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()">*tp_cli_connection_callback_for_disconnect</a>)
160
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
161
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
162
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
163
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
164
 
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-disconnect" title="tp_cli_connection_call_disconnect ()">tp_cli_connection_call_disconnect</a>  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
165
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
166
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()"><span class="returnvalue">tp_cli_connection_callback_for_disconnect</span></a> callback,
167
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
168
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
169
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
170
 
<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-connection.html#tp-cli-connection-run-disconnect" title="tp_cli_connection_run_disconnect ()">tp_cli_connection_run_disconnect</a>    (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
171
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
172
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
173
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
175
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
176
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
177
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
178
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
179
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-disconnect" title="tp_cli_connection_call_disconnect ()">tp_cli_connection_call_disconnect</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
180
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
181
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()"><span class="type">tp_cli_connection_callback_for_disconnect</span></a> callback</code></em>,
 
182
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
183
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
184
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
185
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-disconnect" title="tp_cli_connection_run_disconnect ()">tp_cli_connection_run_disconnect</a>    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
186
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
187
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
188
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
174
189
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()">*tp_cli_connection_callback_for_get_interfaces</a>)
175
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
176
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Interfaces,
177
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
178
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
179
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
190
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
191
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Interfaces</code></em>,
 
192
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
193
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
194
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
180
195
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-interfaces" title="tp_cli_connection_call_get_interfaces ()">tp_cli_connection_call_get_interfaces</a>
181
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
182
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
183
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()"><span class="returnvalue">tp_cli_connection_callback_for_get_interfaces</span></a> callback,
184
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
185
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
186
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
187
 
<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-connection.html#tp-cli-connection-run-get-interfaces" title="tp_cli_connection_run_get_interfaces ()">tp_cli_connection_run_get_interfaces</a>
188
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
189
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
190
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ***out_Interfaces,
191
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
192
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
196
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
197
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
198
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()"><span class="type">tp_cli_connection_callback_for_get_interfaces</span></a> callback</code></em>,
 
199
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
200
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
201
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
202
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-interfaces" title="tp_cli_connection_run_get_interfaces ()">tp_cli_connection_run_get_interfaces</a>
 
203
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
204
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
205
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***out_Interfaces</code></em>,
 
206
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
207
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
193
208
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()">*tp_cli_connection_callback_for_get_protocol</a>)
194
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
195
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *out_Protocol,
196
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
197
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
198
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
209
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
210
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *out_Protocol</code></em>,
 
211
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
212
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
213
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
199
214
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-protocol" title="tp_cli_connection_call_get_protocol ()">tp_cli_connection_call_get_protocol</a>
200
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
201
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
202
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()"><span class="returnvalue">tp_cli_connection_callback_for_get_protocol</span></a> callback,
203
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
204
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
205
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
206
 
<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-connection.html#tp-cli-connection-run-get-protocol" title="tp_cli_connection_run_get_protocol ()">tp_cli_connection_run_get_protocol</a>  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
207
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
208
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Protocol,
209
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
210
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
215
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
216
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
217
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()"><span class="type">tp_cli_connection_callback_for_get_protocol</span></a> callback</code></em>,
 
218
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
219
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
220
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
221
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-protocol" title="tp_cli_connection_run_get_protocol ()">tp_cli_connection_run_get_protocol</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
222
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
223
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Protocol</code></em>,
 
224
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
225
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
211
226
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()">*tp_cli_connection_callback_for_get_self_handle</a>)
212
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
213
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> out_Self_Handle,
214
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
215
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
216
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
227
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
228
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> out_Self_Handle</code></em>,
 
229
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
230
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
231
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
217
232
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-self-handle" title="tp_cli_connection_call_get_self_handle ()">tp_cli_connection_call_get_self_handle</a>
218
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
219
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
220
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()"><span class="returnvalue">tp_cli_connection_callback_for_get_self_handle</span></a> callback,
221
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
222
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
223
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
224
 
<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-connection.html#tp-cli-connection-run-get-self-handle" title="tp_cli_connection_run_get_self_handle ()">tp_cli_connection_run_get_self_handle</a>
225
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
226
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
227
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *out_Self_Handle,
228
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
229
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
233
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
234
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
235
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()"><span class="type">tp_cli_connection_callback_for_get_self_handle</span></a> callback</code></em>,
 
236
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
237
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
238
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
239
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-self-handle" title="tp_cli_connection_run_get_self_handle ()">tp_cli_connection_run_get_self_handle</a>
 
240
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
241
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
242
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *out_Self_Handle</code></em>,
 
243
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
244
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
230
245
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()">*tp_cli_connection_callback_for_get_status</a>)
231
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
232
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> out_Status,
233
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
234
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
235
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
236
 
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-status" title="tp_cli_connection_call_get_status ()">tp_cli_connection_call_get_status</a>  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
237
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
238
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()"><span class="returnvalue">tp_cli_connection_callback_for_get_status</span></a> callback,
239
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
240
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
241
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
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-connection.html#tp-cli-connection-run-get-status" title="tp_cli_connection_run_get_status ()">tp_cli_connection_run_get_status</a>    (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
243
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
244
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *out_Status,
245
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
246
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
246
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
247
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> out_Status</code></em>,
 
248
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
249
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
250
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
251
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-get-status" title="tp_cli_connection_call_get_status ()">tp_cli_connection_call_get_status</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
252
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
253
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()"><span class="type">tp_cli_connection_callback_for_get_status</span></a> callback</code></em>,
 
254
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
255
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
256
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
257
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-get-status" title="tp_cli_connection_run_get_status ()">tp_cli_connection_run_get_status</a>    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
258
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
259
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *out_Status</code></em>,
 
260
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
261
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
247
262
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()">*tp_cli_connection_callback_for_hold_handles</a>)
248
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
249
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
250
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
251
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
263
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
264
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
265
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
266
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
252
267
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-hold-handles" title="tp_cli_connection_call_hold_handles ()">tp_cli_connection_call_hold_handles</a>
253
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
254
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
255
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
256
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
257
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_hold_handles</span></a> callback,
258
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
259
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
260
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
261
 
<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-connection.html#tp-cli-connection-run-hold-handles" title="tp_cli_connection_run_hold_handles ()">tp_cli_connection_run_hold_handles</a>  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
262
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
263
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
264
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
265
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
266
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
268
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
269
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
270
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
271
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
272
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()"><span class="type">tp_cli_connection_callback_for_hold_handles</span></a> callback</code></em>,
 
273
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
274
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
275
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
276
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-hold-handles" title="tp_cli_connection_run_hold_handles ()">tp_cli_connection_run_hold_handles</a>  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
277
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
278
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
279
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
280
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
281
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
267
282
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()">*tp_cli_connection_callback_for_inspect_handles</a>)
268
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
269
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Identifiers,
270
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
271
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
272
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
283
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
284
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Identifiers</code></em>,
 
285
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
286
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
287
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
273
288
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-inspect-handles" title="tp_cli_connection_call_inspect_handles ()">tp_cli_connection_call_inspect_handles</a>
274
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
275
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
276
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
277
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
278
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_inspect_handles</span></a> callback,
279
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
280
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
281
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
282
 
<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-connection.html#tp-cli-connection-run-inspect-handles" title="tp_cli_connection_run_inspect_handles ()">tp_cli_connection_run_inspect_handles</a>
283
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
284
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
285
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
286
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
287
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ***out_Identifiers,
288
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
289
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
289
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
290
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
291
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
292
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
293
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()"><span class="type">tp_cli_connection_callback_for_inspect_handles</span></a> callback</code></em>,
 
294
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
295
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
296
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
297
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-inspect-handles" title="tp_cli_connection_run_inspect_handles ()">tp_cli_connection_run_inspect_handles</a>
 
298
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
299
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
300
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
301
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
302
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***out_Identifiers</code></em>,
 
303
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
304
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
290
305
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()">*tp_cli_connection_callback_for_list_channels</a>)
291
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
292
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *out_Channel_Info,
293
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
294
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
295
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
306
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
307
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Channel_Info</code></em>,
 
308
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
309
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
310
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
296
311
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-list-channels" title="tp_cli_connection_call_list_channels ()">tp_cli_connection_call_list_channels</a>
297
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
298
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
299
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()"><span class="returnvalue">tp_cli_connection_callback_for_list_channels</span></a> callback,
300
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
301
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
302
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
303
 
<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-connection.html#tp-cli-connection-run-list-channels" title="tp_cli_connection_run_list_channels ()">tp_cli_connection_run_list_channels</a> (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
304
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
305
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **out_Channel_Info,
306
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
307
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
312
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
313
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
314
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()"><span class="type">tp_cli_connection_callback_for_list_channels</span></a> callback</code></em>,
 
315
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
316
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
317
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
318
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-list-channels" title="tp_cli_connection_run_list_channels ()">tp_cli_connection_run_list_channels</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
319
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
320
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **out_Channel_Info</code></em>,
 
321
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
322
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
308
323
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()">*tp_cli_connection_callback_for_release_handles</a>)
309
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
310
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
311
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
312
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
324
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
325
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
326
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
327
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
313
328
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-release-handles" title="tp_cli_connection_call_release_handles ()">tp_cli_connection_call_release_handles</a>
314
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
315
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
316
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
317
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
318
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_release_handles</span></a> callback,
319
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
320
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
321
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
322
 
<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-connection.html#tp-cli-connection-run-release-handles" title="tp_cli_connection_run_release_handles ()">tp_cli_connection_run_release_handles</a>
323
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
324
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
325
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
326
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
327
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
328
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
329
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
330
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
331
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
332
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
333
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()"><span class="type">tp_cli_connection_callback_for_release_handles</span></a> callback</code></em>,
 
334
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
335
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
336
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
337
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-release-handles" title="tp_cli_connection_run_release_handles ()">tp_cli_connection_run_release_handles</a>
 
338
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
339
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
340
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
341
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
342
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
343
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
329
344
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()">*tp_cli_connection_callback_for_request_channel</a>)
330
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
331
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *out_Object_Path,
332
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
333
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
334
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
345
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
346
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *out_Object_Path</code></em>,
 
347
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
348
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
349
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
335
350
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-channel" title="tp_cli_connection_call_request_channel ()">tp_cli_connection_call_request_channel</a>
336
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
337
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
338
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *in_Type,
339
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
340
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle,
341
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> in_Suppress_Handler,
342
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()"><span class="returnvalue">tp_cli_connection_callback_for_request_channel</span></a> callback,
343
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
344
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
345
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
346
 
<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-connection.html#tp-cli-connection-run-request-channel" title="tp_cli_connection_run_request_channel ()">tp_cli_connection_run_request_channel</a>
347
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
348
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
349
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *in_Type,
350
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
351
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle,
352
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> in_Suppress_Handler,
353
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Object_Path,
354
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
355
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
351
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
352
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
353
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Type</code></em>,
 
354
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
355
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle</code></em>,
 
356
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Suppress_Handler</code></em>,
 
357
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()"><span class="type">tp_cli_connection_callback_for_request_channel</span></a> callback</code></em>,
 
358
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
359
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
360
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
361
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-request-channel" title="tp_cli_connection_run_request_channel ()">tp_cli_connection_run_request_channel</a>
 
362
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
363
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
364
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Type</code></em>,
 
365
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
366
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle</code></em>,
 
367
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Suppress_Handler</code></em>,
 
368
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Object_Path</code></em>,
 
369
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
370
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
356
371
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()">*tp_cli_connection_callback_for_request_handles</a>)
357
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
358
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *out_Handles,
359
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
360
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
361
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
372
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
373
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *out_Handles</code></em>,
 
374
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
375
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
376
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
362
377
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-request-handles" title="tp_cli_connection_call_request_handles ()">tp_cli_connection_call_request_handles</a>
363
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
364
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
365
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
366
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **in_Identifiers,
367
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_request_handles</span></a> callback,
368
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
369
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
370
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
371
 
<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-connection.html#tp-cli-connection-run-request-handles" title="tp_cli_connection_run_request_handles ()">tp_cli_connection_run_request_handles</a>
372
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
373
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
374
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
375
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **in_Identifiers,
376
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> **out_Handles,
377
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
378
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);
 
378
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
379
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
380
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
381
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Identifiers</code></em>,
 
382
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()"><span class="type">tp_cli_connection_callback_for_request_handles</span></a> callback</code></em>,
 
383
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
384
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
385
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
386
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-run-request-handles" title="tp_cli_connection_run_request_handles ()">tp_cli_connection_run_request_handles</a>
 
387
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
388
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
389
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
390
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Identifiers</code></em>,
 
391
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> **out_Handles</code></em>,
 
392
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
393
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
379
394
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()">*tp_cli_connection_signal_callback_new_channel</a>)
380
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
381
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Object_Path,
382
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Channel_Type,
383
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Handle_Type,
384
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Handle,
385
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> arg_Suppress_Handler,
386
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
387
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
395
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
396
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Object_Path</code></em>,
 
397
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Channel_Type</code></em>,
 
398
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle_Type</code></em>,
 
399
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle</code></em>,
 
400
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_Suppress_Handler</code></em>,
 
401
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
402
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
388
403
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-new-channel" title="tp_cli_connection_connect_to_new_channel ()">tp_cli_connection_connect_to_new_channel</a>
389
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
390
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()"><span class="returnvalue">tp_cli_connection_signal_callback_new_channel</span></a> callback,
391
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
392
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
393
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
394
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 
404
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
405
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()"><span class="type">tp_cli_connection_signal_callback_new_channel</span></a> callback</code></em>,
 
406
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
407
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
408
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
409
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
395
410
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()">*tp_cli_connection_signal_callback_self_handle_changed</a>)
396
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
397
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Self_Handle,
398
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
399
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
411
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
412
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Self_Handle</code></em>,
 
413
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
414
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
400
415
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-self-handle-changed" title="tp_cli_connection_connect_to_self_handle_changed ()">tp_cli_connection_connect_to_self_handle_changed</a>
401
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
402
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()"><span class="returnvalue">tp_cli_connection_signal_callback_self_handle_changed</span></a> callback,
403
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
404
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
405
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
406
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 
416
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
417
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()"><span class="type">tp_cli_connection_signal_callback_self_handle_changed</span></a> callback</code></em>,
 
418
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
419
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
420
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
421
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
407
422
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()">*tp_cli_connection_signal_callback_status_changed</a>)
408
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
409
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Status,
410
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Reason,
411
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
412
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
423
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
424
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Status</code></em>,
 
425
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Reason</code></em>,
 
426
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
427
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
413
428
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-status-changed" title="tp_cli_connection_connect_to_status_changed ()">tp_cli_connection_connect_to_status_changed</a>
414
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
415
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()"><span class="returnvalue">tp_cli_connection_signal_callback_status_changed</span></a> callback,
416
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
417
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
418
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
419
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 
429
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
430
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()"><span class="type">tp_cli_connection_signal_callback_status_changed</span></a> callback</code></em>,
 
431
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
432
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
433
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
434
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
420
435
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()">*tp_cli_connection_signal_callback_connection_error</a>)
421
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
422
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Error,
423
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *arg_Details,
424
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
425
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);
 
436
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
437
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Error</code></em>,
 
438
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Details</code></em>,
 
439
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
440
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
426
441
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-connection-error" title="tp_cli_connection_connect_to_connection_error ()">tp_cli_connection_connect_to_connection_error</a>
427
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
428
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()"><span class="returnvalue">tp_cli_connection_signal_callback_connection_error</span></a> callback,
429
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
430
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
431
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
432
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 
442
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
443
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()"><span class="type">tp_cli_connection_signal_callback_connection_error</span></a> callback</code></em>,
 
444
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
445
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
446
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
447
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
433
448
</pre>
434
449
</div>
435
450
<div class="refsect1" title="Object Hierarchy">
436
451
<a name="telepathy-glib-connection.object-hierarchy"></a><h2>Object Hierarchy</h2>
437
452
<pre class="synopsis">
438
 
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
453
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
439
454
   +----<a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>
440
455
         +----TpConnection
441
456
</pre>
443
458
<div class="refsect1" title="Properties">
444
459
<a name="telepathy-glib-connection.properties"></a><h2>Properties</h2>
445
460
<pre class="synopsis">
446
 
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'>connection-ready</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
447
 
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--self-handle" title='The "self-handle" property'>self-handle</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
448
 
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'>status</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
449
 
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--status-reason" title='The "status-reason" property'>status-reason</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
 
461
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--capabilities" title='The "capabilities" property'>capabilities</a>"             <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a>*       : Read
 
462
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'>connection-ready</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
 
463
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--self-handle" title='The "self-handle" property'>self-handle</a>"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
 
464
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'>status</a>"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
 
465
  "<a class="link" href="telepathy-glib-connection.html#TpConnection--status-reason" title='The "status-reason" property'>status-reason</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
450
466
</pre>
451
467
</div>
452
468
<div class="refsect1" title="Description">
465
481
<li class="listitem">connection status tracking</li>
466
482
<li class="listitem">calling <code class="function">GetInterfaces()</code> automatically</li>
467
483
</ul></div>
 
484
<p>
 
485
</p>
468
486
</div>
469
487
<div class="refsect1" title="Details">
470
488
<a name="telepathy-glib-connection.details"></a><h2>Details</h2>
471
489
<div class="refsect2" title="TpConnectionNameListCb ()">
472
490
<a name="TpConnectionNameListCb"></a><h3>TpConnectionNameListCb ()</h3>
473
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionNameListCb)           (const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *names,
474
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a> n,
475
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *cms,
476
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *protocols,
477
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
478
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
479
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
491
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionNameListCb)           (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *names</code></em>,
 
492
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n</code></em>,
 
493
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *cms</code></em>,
 
494
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *protocols</code></em>,
 
495
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
496
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
497
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
480
498
<p>
481
 
Signature of the callback supplied to <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()"><code class="function">tp_list_connection_names()</code></a>.</p>
 
499
Signature of the callback supplied to <a class="link" href="telepathy-glib-connection.html#tp-list-connection-names" title="tp_list_connection_names ()"><code class="function">tp_list_connection_names()</code></a>.
 
500
</p>
482
501
<div class="variablelist"><table border="0">
483
502
<col align="left" valign="top">
484
503
<tbody>
485
504
<tr>
486
505
<td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
487
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> connection bus names,
488
 
  or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error
489
 
</td>
 
506
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em>
 
507
 connection bus names, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1. </td>
490
508
</tr>
491
509
<tr>
492
510
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
493
 
<td> number of names (not including the final <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or 0 on error
 
511
<td>number of names (not including the final <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), or 0 on error
494
512
</td>
495
513
</tr>
496
514
<tr>
497
515
<td><p><span class="term"><em class="parameter"><code>cms</code></em> :</span></p></td>
498
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> connection manager names
499
 
  (e.g. "gabble") in the same order as <em class="parameter"><code>names</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error
500
 
</td>
 
516
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em>
 
517
 connection manager names (e.g. "gabble") in the same order as <em class="parameter"><code>names</code></em>, or
 
518
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1. </td>
501
519
</tr>
502
520
<tr>
503
521
<td><p><span class="term"><em class="parameter"><code>protocols</code></em> :</span></p></td>
504
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <em class="parameter"><code>n</code></em> protocol names as defined in the
505
 
  Telepathy spec (e.g. "jabber") in the same order as <em class="parameter"><code>names</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on
506
 
  error
507
 
</td>
 
522
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of
 
523
 <em class="parameter"><code>n</code></em> protocol names as defined in the Telepathy spec (e.g. "jabber") in the
 
524
 same order as <em class="parameter"><code>names</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1. </td>
508
525
</tr>
509
526
<tr>
510
527
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
511
 
<td> <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 that occurred
 
528
<td>
 
529
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error that occurred
512
530
</td>
513
531
</tr>
514
532
<tr>
515
533
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
516
 
<td> user-supplied data
 
534
<td>user-supplied data
517
535
</td>
518
536
</tr>
519
537
<tr>
520
538
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
521
 
<td> user-supplied weakly referenced object
 
539
<td>user-supplied weakly referenced object
522
540
</td>
523
541
</tr>
524
542
</tbody>
528
546
<hr>
529
547
<div class="refsect2" title="tp_list_connection_names ()">
530
548
<a name="tp-list-connection-names"></a><h3>tp_list_connection_names ()</h3>
531
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_list_connection_names            (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="returnvalue">TpDBusDaemon</span></a> *bus_daemon,
532
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()"><span class="returnvalue">TpConnectionNameListCb</span></a> callback,
533
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
534
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
535
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
549
<pre class="programlisting"><span class="returnvalue">void</span>                tp_list_connection_names            (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,
 
550
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionNameListCb" title="TpConnectionNameListCb ()"><span class="type">TpConnectionNameListCb</span></a> callback</code></em>,
 
551
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
552
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
553
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
536
554
<p>
537
555
List the bus names of all the connections that currently exist, together
538
556
with the connection manager name and the protocol name for each connection.
540
558
</p>
541
559
<p>
542
560
The bus names passed to the callback can be used to construct <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
543
 
objects for any connections that are of interest.</p>
 
561
objects for any connections that are of interest.
 
562
</p>
544
563
<div class="variablelist"><table border="0">
545
564
<col align="left" valign="top">
546
565
<tbody>
547
566
<tr>
548
567
<td><p><span class="term"><em class="parameter"><code>bus_daemon</code></em> :</span></p></td>
549
 
<td> proxy for the D-Bus daemon
 
568
<td>proxy for the D-Bus daemon
550
569
</td>
551
570
</tr>
552
571
<tr>
553
572
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
554
 
<td> callback to be called when listing the connections succeeds or
 
573
<td>callback to be called when listing the connections succeeds or
555
574
  fails; not called if the D-Bus connection fails completely or if the
556
575
  <em class="parameter"><code>weak_object</code></em> goes away
557
576
</td>
558
577
</tr>
559
578
<tr>
560
579
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
561
 
<td> user-supplied data for the callback
 
580
<td>user-supplied data for the callback
562
581
</td>
563
582
</tr>
564
583
<tr>
565
584
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
566
 
<td> callback to destroy the user-supplied data, called after
 
585
<td>callback to destroy the user-supplied data, called after
567
586
  <em class="parameter"><code>callback</code></em>, but also if the D-Bus connection fails or if the <em class="parameter"><code>weak_object</code></em>
568
587
  goes away
569
588
</td>
570
589
</tr>
571
590
<tr>
572
591
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
573
 
<td> if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, will be weakly referenced; the callback will
574
 
  not be called if the object has vanished
575
 
</td>
 
592
<td> if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, will be weakly referenced; the callback will
 
593
  not be called if the object has vanished. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
576
594
</tr>
577
595
</tbody>
578
596
</table></div>
579
597
<p class="since">Since 0.7.1</p>
580
598
</div>
581
599
<hr>
 
600
<div class="refsect2" title="TpConnection">
 
601
<a name="TpConnection-struct"></a><h3>TpConnection</h3>
 
602
<pre class="programlisting">typedef struct _TpConnection TpConnection;</pre>
 
603
<p>
 
604
A proxy object for a Telepathy connection. There are no interesting
 
605
public struct fields.
 
606
</p>
 
607
<p>
 
608
(Changed in 0.7.12: the layout of the structure is visible, allowing
 
609
subclassing.)
 
610
</p>
 
611
<p class="since">Since 0.7.1</p>
 
612
</div>
 
613
<hr>
 
614
<div class="refsect2" title="TpConnectionClass">
 
615
<a name="TpConnectionClass"></a><h3>TpConnectionClass</h3>
 
616
<pre class="programlisting">typedef struct {
 
617
    TpProxyClass parent_class;
 
618
} TpConnectionClass;
 
619
</pre>
 
620
<p>
 
621
The class of a <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>. In addition to <em class="parameter"><code>parent_class</code></em> there are four
 
622
pointers reserved for possible future use.
 
623
</p>
 
624
<p>
 
625
(Changed in 0.7.12: the layout of the structure is visible, allowing
 
626
subclassing.)
 
627
</p>
 
628
<div class="variablelist"><table border="0">
 
629
<col align="left" valign="top">
 
630
<tbody><tr>
 
631
<td><p><span class="term"><a class="link" href="telepathy-glib-proxy.html#TpProxyClass" title="TpProxyClass"><span class="type">TpProxyClass</span></a> <em class="structfield"><code><a name="TpConnectionClass.parent-class"></a>parent_class</code></em>;</span></p></td>
 
632
<td>the parent class
 
633
</td>
 
634
</tr></tbody>
 
635
</table></div>
 
636
<p class="since">Since 0.7.1</p>
 
637
</div>
 
638
<hr>
582
639
<div class="refsect2" title="tp_connection_new ()">
583
640
<a name="tp-connection-new"></a><h3>tp_connection_new ()</h3>
584
 
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *      tp_connection_new                   (<a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="returnvalue">TpDBusDaemon</span></a> *dbus,
585
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *bus_name,
586
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *object_path,
587
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
641
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *      tp_connection_new                   (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *dbus</code></em>,
 
642
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *bus_name</code></em>,
 
643
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
644
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
588
645
<p>
 
646
 
589
647
</p>
590
648
<div class="variablelist"><table border="0">
591
649
<col align="left" valign="top">
592
650
<tbody>
593
651
<tr>
594
652
<td><p><span class="term"><em class="parameter"><code>dbus</code></em> :</span></p></td>
595
 
<td> a D-Bus daemon; may not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
653
<td>a D-Bus daemon; may not be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
596
654
</td>
597
655
</tr>
598
656
<tr>
599
657
<td><p><span class="term"><em class="parameter"><code>bus_name</code></em> :</span></p></td>
600
 
<td> the well-known or unique name of the connection process;
601
 
 if well-known, this function will make a blocking call to the bus daemon
602
 
 to resolve the unique name. May 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>object_path</code></em> is not, in which
603
 
 case a well-known name will be derived from <em class="parameter"><code>object_path</code></em>.
604
 
</td>
 
658
<td> the well-known or unique name of the connection
 
659
 process; if well-known, this function will make a blocking call to the bus
 
660
 daemon to resolve the unique name. May be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>object_path</code></em> is not, in
 
661
 which case a well-known name will be derived from <em class="parameter"><code>object_path</code></em>.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
605
662
</tr>
606
663
<tr>
607
664
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
608
 
<td> the object path of the connection process. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
609
 
 if <em class="parameter"><code>bus_name</code></em> is a well-known name, in which case the object path will
610
 
 be derived from <em class="parameter"><code>bus_name</code></em>.
611
 
</td>
 
665
<td> the object path of the connection process.
 
666
 May be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>bus_name</code></em> is a well-known name, in which case the object
 
667
 path will be derived from <em class="parameter"><code>bus_name</code></em>.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
612
668
</tr>
613
669
<tr>
614
670
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
615
 
<td> used to indicate the error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned
 
671
<td>used to indicate the error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned
616
672
</td>
617
673
</tr>
618
674
<tr>
619
675
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
620
 
<td> a new connection proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unique-name resolution
 
676
<td> a new connection proxy, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unique-name resolution
621
677
 fails or on invalid arguments
622
678
 
623
679
</td>
627
683
<p class="since">Since 0.7.1</p>
628
684
</div>
629
685
<hr>
 
686
<div class="refsect2" title="TP_CONNECTION_FEATURE_CORE">
 
687
<a name="TP-CONNECTION-FEATURE-CORE:CAPS"></a><h3>TP_CONNECTION_FEATURE_CORE</h3>
 
688
<pre class="programlisting">#define             TP_CONNECTION_FEATURE_CORE</pre>
 
689
<p>
 
690
Expands to a call to a function that returns a quark for the "core" feature
 
691
on a <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>.
 
692
</p>
 
693
<p>
 
694
When this feature is prepared, the basic properties of the Connection have
 
695
been retrieved and are available for use, and change-notification has been
 
696
set up for those that can change.
 
697
</p>
 
698
<p>
 
699
Specifically, this implies that:
 
700
</p>
 
701
<p>
 
702
</p>
 
703
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
 
704
<li class="listitem">
 
705
<a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'><span class="type">"status"</span></a> has a value other than
 
706
   <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS:CAPS" title="TP_UNKNOWN_CONNECTION_STATUS"><code class="literal">TP_UNKNOWN_CONNECTION_STATUS</code></a>, and <a class="link" href="telepathy-glib-connection.html#TpConnection--status-reason" title='The "status-reason" property'><span class="type">"status-reason"</span></a> is
 
707
   the reason for changing to that status</li>
 
708
<li class="listitem">interfaces that are always available have been added to the
 
709
   <a class="link" href="telepathy-glib-proxy.html#TpProxy--interfaces" title='The "interfaces" property'><span class="type">"interfaces"</span></a> (although the set of interfaces is not guaranteed
 
710
   to be complete until <a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'><span class="type">"status"</span></a> becomes
 
711
   <a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-CONNECTED:CAPS"><code class="literal">TP_CONNECTION_STATUS_CONNECTED</code></a>))</li>
 
712
</ul></div>
 
713
<p>
 
714
</p>
 
715
<p>
 
716
</p>
 
717
<div class="note" title="prepared does not imply connected" style="margin-left: 0.5in; margin-right: 0.5in;">
 
718
<h3 class="title">prepared does not imply connected</h3>
 
719
<p>Unlike the older <a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'><span class="type">"connection-ready"</span></a> mechanism, this
 
720
   feature does not imply that the connection has successfully connected.
 
721
   It only implies that an initial status (disconnected, connecting or
 
722
   connected) has been discovered. <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CONNECTED:CAPS" title="TP_CONNECTION_FEATURE_CONNECTED"><code class="literal">TP_CONNECTION_FEATURE_CONNECTED</code></a>
 
723
   is the closest equivalent of <a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'><span class="type">"connection-ready"</span></a>.</p>
 
724
</div>
 
725
<p>
 
726
</p>
 
727
<p>
 
728
One can ask for a feature to be prepared using the
 
729
<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.
 
730
</p>
 
731
<p class="since">Since 0.11.3</p>
 
732
</div>
 
733
<hr>
 
734
<div class="refsect2" title="TP_CONNECTION_FEATURE_CONNECTED">
 
735
<a name="TP-CONNECTION-FEATURE-CONNECTED:CAPS"></a><h3>TP_CONNECTION_FEATURE_CONNECTED</h3>
 
736
<pre class="programlisting">#define             TP_CONNECTION_FEATURE_CONNECTED</pre>
 
737
<p>
 
738
Expands to a call to a function that returns a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> representing the
 
739
"connected" feature.
 
740
</p>
 
741
<p>
 
742
When this feature is prepared, it means that the connection has become
 
743
connected to the appropriate real-time communications service, and all
 
744
information requested via other features has been updated accordingly.
 
745
In particular, the following aspects of <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>
 
746
will be up to date:
 
747
</p>
 
748
<p>
 
749
</p>
 
750
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
 
751
<li class="listitem">
 
752
<a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'><span class="type">"status"</span></a> is
 
753
   <a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-CONNECTED:CAPS"><code class="literal">TP_CONNECTION_STATUS_CONNECTED</code></a>
 
754
</li>
 
755
<li class="listitem">
 
756
<a class="link" href="telepathy-glib-connection.html#TpConnection--self-handle" title='The "self-handle" property'><span class="type">"self-handle"</span></a> is valid and non-zero</li>
 
757
<li class="listitem">all interfaces have been added to the set of
 
758
   <a class="link" href="telepathy-glib-proxy.html#TpProxy--interfaces" title='The "interfaces" property'><span class="type">"interfaces"</span></a>, and that set will not change again</li>
 
759
</ul></div>
 
760
<p>
 
761
</p>
 
762
<p>
 
763
</p>
 
764
<div class="note" title="Someone still has to call Connect()" style="margin-left: 0.5in; margin-right: 0.5in;">
 
765
<h3 class="title">Someone still has to call <code class="function">Connect()</code>
 
766
</h3>
 
767
<p>Requesting this feature via <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> means that
 
768
    you want to wait for the connection to connect, but it doesn't actually
 
769
    start the process of connecting: to do that, call
 
770
    <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()"><code class="function">tp_cli_connection_call_connect()</code></a> separately.</p>
 
771
</div>
 
772
<p>
 
773
</p>
 
774
<p>
 
775
One can ask for a feature to be prepared using the
 
776
<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.
 
777
</p>
 
778
<p class="since">Since 0.11.3</p>
 
779
</div>
 
780
<hr>
 
781
<div class="refsect2" title="TP_CONNECTION_FEATURE_CAPABILITIES">
 
782
<a name="TP-CONNECTION-FEATURE-CAPABILITIES:CAPS"></a><h3>TP_CONNECTION_FEATURE_CAPABILITIES</h3>
 
783
<pre class="programlisting">#define             TP_CONNECTION_FEATURE_CAPABILITIES</pre>
 
784
<p>
 
785
Expands to a call to a function that returns a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> representing the
 
786
"capabilities" feature.
 
787
</p>
 
788
<p>
 
789
When this feature is prepared, the Requests.RequestableChannelClasses
 
790
property of the Connection has been retrieved.
 
791
In particular, the <a class="link" href="telepathy-glib-connection.html#TpConnection"><code class="literal">TpConnection</code></a>:capabilities property has been set.
 
792
</p>
 
793
<p>
 
794
One can ask for a feature to be prepared using the
 
795
<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.
 
796
</p>
 
797
<p class="since">Since 0.11.3</p>
 
798
</div>
 
799
<hr>
 
800
<div class="refsect2" title="TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS">
 
801
<a name="TP-CONNECTION-FEATURE-AVATAR-REQUIREMENTS:CAPS"></a><h3>TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS</h3>
 
802
<pre class="programlisting">#define             TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS</pre>
 
803
<p>
 
804
Expands to a call to a function that returns a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> representing the
 
805
"avatar-requirements" feature.
 
806
</p>
 
807
<p>
 
808
When this feature is prepared, the avatar requirements of the Connection has
 
809
been retrieved. Use <a class="link" href="telepathy-glib-connection.html#tp-connection-get-avatar-requirements" title="tp_connection_get_avatar_requirements ()"><code class="function">tp_connection_get_avatar_requirements()</code></a> to get them once
 
810
prepared.
 
811
</p>
 
812
<p>
 
813
One can ask for a feature to be prepared using the
 
814
<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.
 
815
</p>
 
816
<p class="since">Since 0.11.4</p>
 
817
</div>
 
818
<hr>
630
819
<div class="refsect2" title="tp_connection_run_until_ready ()">
631
820
<a name="tp-connection-run-until-ready"></a><h3>tp_connection_run_until_ready ()</h3>
632
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_run_until_ready       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
633
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> connect,
634
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
635
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
821
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_run_until_ready       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
822
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> connect</code></em>,
 
823
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
824
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
825
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
826
<h3 class="title">Warning</h3>
 
827
<p><code class="literal">tp_connection_run_until_ready</code> has been deprecated since version 0.11.0 and should not be used in newly-written code. Use tp_connection_call_when_ready,
 
828
 or restructure your program in such a way as to avoid re-entering the
 
829
 main loop.</p>
 
830
</div>
636
831
<p>
637
832
If <em class="parameter"><code>self</code></em> is connected and ready for use, return immediately. Otherwise,
638
 
call <code class="function">Connect()</code> (unless <em class="parameter"><code>connect</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>) and re-enter the main loop
 
833
call <code class="function">Connect()</code> (unless <em class="parameter"><code>connect</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>) and re-enter the main loop
639
834
until the connection becomes invalid, the connection connects successfully
640
 
and is introspected, or the main loop stored via <em class="parameter"><code>loop</code></em> is cancelled.</p>
 
835
and is introspected, or the main loop stored via <em class="parameter"><code>loop</code></em> is cancelled.
 
836
</p>
641
837
<div class="variablelist"><table border="0">
642
838
<col align="left" valign="top">
643
839
<tbody>
644
840
<tr>
645
841
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
646
 
<td> a connection
 
842
<td>a connection
647
843
</td>
648
844
</tr>
649
845
<tr>
650
846
<td><p><span class="term"><em class="parameter"><code>connect</code></em> :</span></p></td>
651
 
<td> if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, call <code class="function">Connect()</code> if it appears to be necessary;
652
 
 if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, rely on <code class="function">Connect()</code> to be called by another client
 
847
<td>if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, call <code class="function">Connect()</code> if it appears to be necessary;
 
848
 if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, rely on <code class="function">Connect()</code> to be called by another client
653
849
</td>
654
850
</tr>
655
851
<tr>
656
852
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
657
 
<td> if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, used to raise an error
 
853
<td>if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, used to raise an error
658
854
</td>
659
855
</tr>
660
856
<tr>
661
857
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
662
 
<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/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> is placed here while it is being run
663
 
 (so calling code can call <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a> to abort), and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
 
858
<td>if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> is placed here while it is being run
 
859
 (so calling code can call <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a> to abort), and <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
664
860
 placed here after the loop has been run
665
861
</td>
666
862
</tr>
667
863
<tr>
668
864
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
669
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the connection is now connected and ready for use,
670
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the connection has become invalid.
 
865
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the connection is now connected and ready for use,
 
866
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the connection has become invalid.
671
867
 
672
868
</td>
673
869
</tr>
678
874
<hr>
679
875
<div class="refsect2" title="TpConnectionWhenReadyCb ()">
680
876
<a name="TpConnectionWhenReadyCb"></a><h3>TpConnectionWhenReadyCb ()</h3>
681
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionWhenReadyCb)          (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
682
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
683
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
877
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionWhenReadyCb)          (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
878
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
879
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
684
880
<p>
685
881
Signature of a callback passed to <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()"><code class="function">tp_connection_call_when_ready()</code></a>, which
686
882
will be called exactly once, when the connection becomes ready or
687
 
invalid (whichever happens first)</p>
 
883
invalid (whichever happens first)
 
884
</p>
688
885
<div class="variablelist"><table border="0">
689
886
<col align="left" valign="top">
690
887
<tbody>
691
888
<tr>
692
889
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
693
 
<td> the connection (which may be in the middle of being disposed,
694
 
 if error is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, error-&gt;domain is TP_DBUS_ERRORS and error-&gt;code is
 
890
<td>the connection (which may be in the middle of being disposed,
 
891
 if error is non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, error-&gt;domain is TP_DBUS_ERRORS and error-&gt;code is
695
892
 TP_DBUS_ERROR_PROXY_UNREFERENCED)
696
893
</td>
697
894
</tr>
698
895
<tr>
699
896
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
700
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the connection is ready for use, or the error with which
 
897
<td>
 
898
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the connection is ready for use, or the error with which
701
899
 it was invalidated if it is now invalid
702
900
</td>
703
901
</tr>
704
902
<tr>
705
903
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
706
 
<td> whatever was passed to <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()"><code class="function">tp_connection_call_when_ready()</code></a>
 
904
<td>whatever was passed to <a class="link" href="telepathy-glib-connection.html#tp-connection-call-when-ready" title="tp_connection_call_when_ready ()"><code class="function">tp_connection_call_when_ready()</code></a>
707
905
</td>
708
906
</tr>
709
907
</tbody>
712
910
<hr>
713
911
<div class="refsect2" title="tp_connection_call_when_ready ()">
714
912
<a name="tp-connection-call-when-ready"></a><h3>tp_connection_call_when_ready ()</h3>
715
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_call_when_ready       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
716
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()"><span class="returnvalue">TpConnectionWhenReadyCb</span></a> callback,
717
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
913
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_call_when_ready       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
914
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionWhenReadyCb" title="TpConnectionWhenReadyCb ()"><span class="type">TpConnectionWhenReadyCb</span></a> callback</code></em>,
 
915
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
718
916
<p>
719
917
If <em class="parameter"><code>self</code></em> is ready for use or has been invalidated, call <em class="parameter"><code>callback</code></em>
720
918
immediately, then return. Otherwise, arrange
726
924
not be called until the connection either goes to state CONNECTED
727
925
or is invalidated (e.g. by going to state DISCONNECTED or by becoming
728
926
unreferenced). In particular, this method does not call <code class="function">Connect()</code>.
729
 
Call <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()"><code class="function">tp_cli_connection_call_connect()</code></a> too, if you want to do that.</p>
 
927
Call <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-call-connect" title="tp_cli_connection_call_connect ()"><code class="function">tp_cli_connection_call_connect()</code></a> too, if you want to do that.
 
928
</p>
730
929
<div class="variablelist"><table border="0">
731
930
<col align="left" valign="top">
732
931
<tbody>
733
932
<tr>
734
933
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
735
 
<td> a connection
 
934
<td>a connection
736
935
</td>
737
936
</tr>
738
937
<tr>
739
938
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
740
 
<td> called when the connection becomes ready or invalidated,
 
939
<td>called when the connection becomes ready or invalidated,
741
940
 whichever happens first
742
941
</td>
743
942
</tr>
744
943
<tr>
745
944
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
746
 
<td> arbitrary user-supplied data passed to the callback
 
945
<td>arbitrary user-supplied data passed to the callback
747
946
</td>
748
947
</tr>
749
948
</tbody>
753
952
<hr>
754
953
<div class="refsect2" title="tp_connection_is_ready ()">
755
954
<a name="tp-connection-is-ready"></a><h3>tp_connection_is_ready ()</h3>
756
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_is_ready              (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self);</pre>
 
955
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_is_ready              (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);</pre>
757
956
<p>
758
 
Returns the same thing as the <a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'><span class="type">"connection-ready"</span></a> property.</p>
 
957
Returns the same thing as the <a class="link" href="telepathy-glib-connection.html#TpConnection--connection-ready" title='The "connection-ready" property'><span class="type">"connection-ready"</span></a> property.
 
958
</p>
759
959
<div class="variablelist"><table border="0">
760
960
<col align="left" valign="top">
761
961
<tbody>
762
962
<tr>
763
963
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
764
 
<td> a connection
 
964
<td>a connection
765
965
</td>
766
966
</tr>
767
967
<tr>
768
968
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
769
 
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if introspection has completed
 
969
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if introspection has completed
770
970
</td>
771
971
</tr>
772
972
</tbody>
776
976
<hr>
777
977
<div class="refsect2" title="tp_connection_get_status ()">
778
978
<a name="tp-connection-get-status"></a><h3>tp_connection_get_status ()</h3>
779
 
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>  tp_connection_get_status            (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
780
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="returnvalue">TpConnectionStatusReason</span></a> *reason);</pre>
 
979
<pre class="programlisting"><a class="link" href="telepathy-glib-enums.html#TpConnectionStatus" title="enum TpConnectionStatus"><span class="returnvalue">TpConnectionStatus</span></a>  tp_connection_get_status            (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
980
                                                         <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>
781
981
<p>
782
 
If <em class="parameter"><code>reason</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 is set to the reason why "status" changed to its
783
 
current value, or <a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-REASON-NONE-SPECIFIED:CAPS"><code class="literal">TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED</code></a> if unknown.</p>
 
982
If <em class="parameter"><code>reason</code></em> is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it is set to the reason why "status" changed to its
 
983
current value, or <a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-REASON-NONE-SPECIFIED:CAPS"><code class="literal">TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED</code></a> if unknown.
 
984
</p>
784
985
<div class="variablelist"><table border="0">
785
986
<col align="left" valign="top">
786
987
<tbody>
787
988
<tr>
788
989
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
789
 
<td> a connection
 
990
<td>a connection
790
991
</td>
791
992
</tr>
792
993
<tr>
793
994
<td><p><span class="term"><em class="parameter"><code>reason</code></em> :</span></p></td>
794
 
<td> a TpConnectionStatusReason, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
795
 
</td>
 
995
<td> a TpConnectionStatusReason, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>. </td>
796
996
</tr>
797
997
<tr>
798
998
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
808
1008
<hr>
809
1009
<div class="refsect2" title="tp_connection_get_self_handle ()">
810
1010
<a name="tp-connection-get-self-handle"></a><h3>tp_connection_get_self_handle ()</h3>
811
 
<pre class="programlisting"><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            tp_connection_get_self_handle       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self);</pre>
 
1011
<pre class="programlisting"><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            tp_connection_get_self_handle       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);</pre>
812
1012
<p>
813
1013
Return the <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-CONTACT:CAPS"><code class="literal">TP_HANDLE_TYPE_CONTACT</code></a> handle of the local user on this
814
 
connection, or 0 if the connection is not ready (the
815
 
TpConnection:connection-ready property is false) or has become invalid
816
 
(the TpProxy::invalidated signal).
 
1014
connection, or 0 if the self-handle is not known yet or the connection
 
1015
has become invalid (the TpProxy::invalidated signal).
817
1016
</p>
818
1017
<p>
819
1018
The returned handle is not necessarily valid forever (the
820
1019
notify::self-handle signal will be emitted if it changes, which can happen
821
1020
on protocols such as IRC). Construct a <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a> object if you want to
822
1021
track the local user's identifier in the protocol, or other information
823
 
like their presence status, over time.</p>
 
1022
like their presence status, over time.
 
1023
</p>
824
1024
<div class="variablelist"><table border="0">
825
1025
<col align="left" valign="top">
826
1026
<tbody>
827
1027
<tr>
828
1028
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
829
 
<td> a connection
 
1029
<td>a connection
830
1030
</td>
831
1031
</tr>
832
1032
<tr>
842
1042
<hr>
843
1043
<div class="refsect2" title="TpConnectionRequestHandlesCb ()">
844
1044
<a name="TpConnectionRequestHandlesCb"></a><h3>TpConnectionRequestHandlesCb ()</h3>
845
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionRequestHandlesCb)     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
846
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
847
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
848
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
849
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *ids,
850
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
851
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
852
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1045
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionRequestHandlesCb)     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
1046
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
1047
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
1048
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
1049
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *ids</code></em>,
 
1050
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
1051
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1052
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
853
1053
<p>
854
1054
Signature of the callback called when <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
855
1055
succeeds or fails.
863
1063
<p>
864
1064
For convenience, the handle type and IDs requested by the caller are
865
1065
passed through to this callback, so the caller does not have to include
866
 
them in <em class="parameter"><code>user_data</code></em>.</p>
 
1066
them in <em class="parameter"><code>user_data</code></em>.
 
1067
</p>
867
1068
<div class="variablelist"><table border="0">
868
1069
<col align="left" valign="top">
869
1070
<tbody>
870
1071
<tr>
871
1072
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
872
 
<td> the connection
 
1073
<td>the connection
873
1074
</td>
874
1075
</tr>
875
1076
<tr>
876
1077
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
877
 
<td> the handle type that was passed to
 
1078
<td>the handle type that was passed to
878
1079
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
879
1080
</td>
880
1081
</tr>
881
1082
<tr>
882
1083
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
883
 
<td> the number of IDs that were passed to
 
1084
<td>the number of IDs that were passed to
884
1085
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> on success, or 0 on failure
885
1086
</td>
886
1087
</tr>
887
1088
<tr>
888
1089
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
889
 
<td> the <em class="parameter"><code>n_handles</code></em> handles corresponding to <em class="parameter"><code>ids</code></em>, in the same order,
890
 
 or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure
891
 
</td>
 
1090
<td> the <em class="parameter"><code>n_handles</code></em> handles corresponding to
 
1091
 <em class="parameter"><code>ids</code></em>, in the same order, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_handles. </td>
892
1092
</tr>
893
1093
<tr>
894
1094
<td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
895
 
<td> a copy of the array of <em class="parameter"><code>n_handles</code></em> IDs that was passed to
896
 
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> on success, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure
 
1095
<td>a copy of the array of <em class="parameter"><code>n_handles</code></em> IDs that was passed to
 
1096
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a> on success, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure
897
1097
</td>
898
1098
</tr>
899
1099
<tr>
900
1100
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
901
 
<td> <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
 
1101
<td>
 
1102
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
902
1103
</td>
903
1104
</tr>
904
1105
<tr>
905
1106
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
906
 
<td> the same arbitrary pointer that was passed to
 
1107
<td>the same arbitrary pointer that was passed to
907
1108
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
908
1109
</td>
909
1110
</tr>
910
1111
<tr>
911
1112
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
912
 
<td> the same object that was passed to
 
1113
<td>the same object that was passed to
913
1114
 <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>
914
1115
</td>
915
1116
</tr>
919
1120
<hr>
920
1121
<div class="refsect2" title="tp_connection_request_handles ()">
921
1122
<a name="tp-connection-request-handles"></a><h3>tp_connection_request_handles ()</h3>
922
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_request_handles       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
923
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
924
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
925
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *ids,
926
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()"><span class="returnvalue">TpConnectionRequestHandlesCb</span></a> callback,
927
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
928
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
929
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1123
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_request_handles       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1124
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
1125
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
1126
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *ids</code></em>,
 
1127
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionRequestHandlesCb" title="TpConnectionRequestHandlesCb ()"><span class="type">TpConnectionRequestHandlesCb</span></a> callback</code></em>,
 
1128
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1129
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
1130
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
930
1131
<p>
931
1132
Request the handles corresponding to the given identifiers, and if they
932
1133
are valid, hold (ensure a reference to) the corresponding handles.
934
1135
<p>
935
1136
If they are valid, the callback will later be called with the given
936
1137
handles; if not all of them are valid, the callback will be called with
937
 
an error.</p>
 
1138
an error.
 
1139
</p>
938
1140
<div class="variablelist"><table border="0">
939
1141
<col align="left" valign="top">
940
1142
<tbody>
941
1143
<tr>
942
1144
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
943
 
<td> a connection
 
1145
<td>a connection
944
1146
</td>
945
1147
</tr>
946
1148
<tr>
947
1149
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
948
 
<td> the timeout in milliseconds, or -1 to use the default
 
1150
<td>the timeout in milliseconds, or -1 to use the default
949
1151
</td>
950
1152
</tr>
951
1153
<tr>
952
1154
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
953
 
<td> the handle type
 
1155
<td>the handle type
954
1156
</td>
955
1157
</tr>
956
1158
<tr>
957
1159
<td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
958
 
<td> an array of string identifiers for which handles are required,
959
 
 terminated by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (must not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or empty)
960
 
</td>
 
1160
<td> an array of string identifiers for which
 
1161
 handles are required, terminated by <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (must not be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or empty). <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1. </td>
961
1162
</tr>
962
1163
<tr>
963
1164
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
964
 
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
 
1165
<td>called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
965
1166
 unreferenced)
966
1167
</td>
967
1168
</tr>
968
1169
<tr>
969
1170
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
970
 
<td> arbitrary user-supplied data
 
1171
<td>arbitrary user-supplied data
971
1172
</td>
972
1173
</tr>
973
1174
<tr>
974
1175
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
975
 
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
 
1176
<td>called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
976
1177
 <em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
977
1178
</td>
978
1179
</tr>
979
1180
<tr>
980
1181
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
981
 
<td> if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
 
1182
<td>if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
982
1183
 destroyed, <em class="parameter"><code>callback</code></em> will not be called
983
1184
</td>
984
1185
</tr>
988
1189
<hr>
989
1190
<div class="refsect2" title="TpConnectionHoldHandlesCb ()">
990
1191
<a name="TpConnectionHoldHandlesCb"></a><h3>TpConnectionHoldHandlesCb ()</h3>
991
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionHoldHandlesCb)        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *connection,
992
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
993
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
994
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
995
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
996
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
997
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1192
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpConnectionHoldHandlesCb)        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *connection</code></em>,
 
1193
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
1194
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
1195
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
1196
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
1197
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1198
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
998
1199
<p>
999
1200
Signature of the callback called when <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> succeeds
1000
1201
or fails.
1008
1209
<p>
1009
1210
For convenience, the handle type and handles requested by the caller are
1010
1211
passed through to this callback on success, so the caller does not have to
1011
 
include them in <em class="parameter"><code>user_data</code></em>.</p>
 
1212
include them in <em class="parameter"><code>user_data</code></em>.
 
1213
</p>
1012
1214
<div class="variablelist"><table border="0">
1013
1215
<col align="left" valign="top">
1014
1216
<tbody>
1015
1217
<tr>
1016
1218
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
1017
 
<td> the connection
 
1219
<td>the connection
1018
1220
</td>
1019
1221
</tr>
1020
1222
<tr>
1021
1223
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1022
 
<td> the handle type that was passed to
 
1224
<td>the handle type that was passed to
1023
1225
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1024
1226
</td>
1025
1227
</tr>
1026
1228
<tr>
1027
1229
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1028
 
<td> the number of handles that were passed to
 
1230
<td>the number of handles that were passed to
1029
1231
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> on success, or 0 on failure
1030
1232
</td>
1031
1233
</tr>
1032
1234
<tr>
1033
1235
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1034
 
<td> a copy of the array of <em class="parameter"><code>n_handles</code></em> handles that was passed to
1035
 
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> on success, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure
 
1236
<td>a copy of the array of <em class="parameter"><code>n_handles</code></em> handles that was passed to
 
1237
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> on success, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure
1036
1238
</td>
1037
1239
</tr>
1038
1240
<tr>
1039
1241
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1040
 
<td> <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
 
1242
<td>
 
1243
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
1041
1244
</td>
1042
1245
</tr>
1043
1246
<tr>
1044
1247
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1045
 
<td> the same arbitrary pointer that was passed to
 
1248
<td>the same arbitrary pointer that was passed to
1046
1249
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1047
1250
</td>
1048
1251
</tr>
1049
1252
<tr>
1050
1253
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1051
 
<td> the same object that was passed to
 
1254
<td>the same object that was passed to
1052
1255
 <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a>
1053
1256
</td>
1054
1257
</tr>
1059
1262
<div class="refsect2" title="tp_connection_get_contact_attributes ()">
1060
1263
<a name="tp-connection-get-contact-attributes"></a><h3>tp_connection_get_contact_attributes ()</h3>
1061
1264
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_get_contact_attributes
1062
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
1063
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1064
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
1065
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
1066
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *interfaces,
1067
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> hold,
1068
 
                                                         <a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()"><span class="returnvalue">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</span></a> callback,
1069
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1070
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1071
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1265
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1266
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
1267
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
1268
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
1269
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *interfaces</code></em>,
 
1270
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> hold</code></em>,
 
1271
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-contacts.html#tp-cli-connection-interface-contacts-callback-for-get-contact-attributes" title="tp_cli_connection_interface_contacts_callback_for_get_contact_attributes ()"><span class="type">tp_cli_connection_interface_contacts_callback_for_get_contact_attributes</span></a> callback</code></em>,
 
1272
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1273
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
1274
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1072
1275
<p>
1073
1276
Return (via a callback) any number of attributes of the given handles, and
1074
1277
if they are valid and <em class="parameter"><code>hold</code></em> is TRUE, hold a reference to them.
1090
1293
parameter to the callback.
1091
1294
</p>
1092
1295
<p>
1093
 
If <em class="parameter"><code>hold</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the <em class="parameter"><code>callback</code></em> is given one reference to each handle
1094
 
that appears as a key in the callback's <em class="parameter"><code>attributes</code></em> parameter.</p>
 
1296
If <em class="parameter"><code>hold</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the <em class="parameter"><code>callback</code></em> is given one reference to each handle
 
1297
that appears as a key in the callback's <em class="parameter"><code>attributes</code></em> parameter.
 
1298
</p>
1095
1299
<div class="variablelist"><table border="0">
1096
1300
<col align="left" valign="top">
1097
1301
<tbody>
1098
1302
<tr>
1099
1303
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1100
 
<td> a connection
 
1304
<td>a connection
1101
1305
</td>
1102
1306
</tr>
1103
1307
<tr>
1104
1308
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1105
 
<td> the timeout in milliseconds, or -1 to use the default
 
1309
<td>the timeout in milliseconds, or -1 to use the default
1106
1310
</td>
1107
1311
</tr>
1108
1312
<tr>
1109
1313
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1110
 
<td> the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
 
1314
<td>the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
1111
1315
</td>
1112
1316
</tr>
1113
1317
<tr>
1114
1318
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1115
 
<td> an array of handles
1116
 
</td>
 
1319
<td> an array of handles. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_handles. </td>
1117
1320
</tr>
1118
1321
<tr>
1119
1322
<td><p><span class="term"><em class="parameter"><code>interfaces</code></em> :</span></p></td>
1120
 
<td> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> of interfaces
 
1323
<td>a <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> of interfaces
1121
1324
</td>
1122
1325
</tr>
1123
1326
<tr>
1124
1327
<td><p><span class="term"><em class="parameter"><code>hold</code></em> :</span></p></td>
1125
 
<td> if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the callback will hold one reference to each valid handle
 
1328
<td>if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the callback will hold one reference to each valid handle
1126
1329
</td>
1127
1330
</tr>
1128
1331
<tr>
1129
1332
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1130
 
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
1131
 
 unreferenced)
1132
 
</td>
 
1333
<td> called on success or
 
1334
 failure (unless <em class="parameter"><code>weak_object</code></em> has become unreferenced). type GObject.Callback</td>
1133
1335
</tr>
1134
1336
<tr>
1135
1337
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1136
 
<td> arbitrary user-supplied data
 
1338
<td>arbitrary user-supplied data
1137
1339
</td>
1138
1340
</tr>
1139
1341
<tr>
1140
1342
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1141
 
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
 
1343
<td>called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
1142
1344
 <em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
1143
1345
</td>
1144
1346
</tr>
1145
1347
<tr>
1146
1348
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1147
 
<td> if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
 
1349
<td>if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
1148
1350
 destroyed, <em class="parameter"><code>callback</code></em> will not be called
1149
1351
</td>
1150
1352
</tr>
1154
1356
<hr>
1155
1357
<div class="refsect2" title="tp_connection_hold_handles ()">
1156
1358
<a name="tp-connection-hold-handles"></a><h3>tp_connection_hold_handles ()</h3>
1157
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_hold_handles          (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
1158
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1159
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
1160
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
1161
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles,
1162
 
                                                         <a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()"><span class="returnvalue">TpConnectionHoldHandlesCb</span></a> callback,
1163
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1164
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1165
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1359
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_hold_handles          (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1360
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
1361
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
1362
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
1363
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>,
 
1364
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnectionHoldHandlesCb" title="TpConnectionHoldHandlesCb ()"><span class="type">TpConnectionHoldHandlesCb</span></a> callback</code></em>,
 
1365
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1366
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
1367
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1166
1368
<p>
1167
1369
Hold (ensure a reference to) the given handles, if they are valid.
1168
1370
</p>
1176
1378
<a class="link" href="telepathy-glib-connection.html#tp-connection-get-contact-attributes" title="tp_connection_get_contact_attributes ()"><code class="function">tp_connection_get_contact_attributes()</code></a> and <a class="link" href="telepathy-glib-contact.html#TpContact"><span class="type">TpContact</span></a>, keeps a client-side
1177
1379
reference count of handles; you should not use the RequestHandles,
1178
1380
HoldHandles and GetContactAttributes D-Bus methods directly as well as these
1179
 
functions.</p>
 
1381
functions.
 
1382
</p>
1180
1383
<div class="variablelist"><table border="0">
1181
1384
<col align="left" valign="top">
1182
1385
<tbody>
1183
1386
<tr>
1184
1387
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1185
 
<td> a connection
 
1388
<td>a connection
1186
1389
</td>
1187
1390
</tr>
1188
1391
<tr>
1189
1392
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1190
 
<td> the timeout in milliseconds, or -1 to use the default
 
1393
<td>the timeout in milliseconds, or -1 to use the default
1191
1394
</td>
1192
1395
</tr>
1193
1396
<tr>
1194
1397
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1195
 
<td> the handle type
 
1398
<td>the handle type
1196
1399
</td>
1197
1400
</tr>
1198
1401
<tr>
1199
1402
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1200
 
<td> the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
 
1403
<td>the number of handles in <em class="parameter"><code>handles</code></em> (must be at least 1)
1201
1404
</td>
1202
1405
</tr>
1203
1406
<tr>
1204
1407
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1205
 
<td> an array of handles
1206
 
</td>
 
1408
<td> an array of handles. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_handles. </td>
1207
1409
</tr>
1208
1410
<tr>
1209
1411
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1210
 
<td> called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
 
1412
<td>called on success or failure (unless <em class="parameter"><code>weak_object</code></em> has become
1211
1413
 unreferenced)
1212
1414
</td>
1213
1415
</tr>
1214
1416
<tr>
1215
1417
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1216
 
<td> arbitrary user-supplied data
 
1418
<td>arbitrary user-supplied data
1217
1419
</td>
1218
1420
</tr>
1219
1421
<tr>
1220
1422
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1221
 
<td> called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
 
1423
<td>called to destroy <em class="parameter"><code>user_data</code></em> after calling <em class="parameter"><code>callback</code></em>, or when
1222
1424
 <em class="parameter"><code>weak_object</code></em> becomes unreferenced (whichever occurs sooner)
1223
1425
</td>
1224
1426
</tr>
1225
1427
<tr>
1226
1428
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1227
 
<td> if not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
 
1429
<td>if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an object to be weakly referenced: if it is
1228
1430
 destroyed, <em class="parameter"><code>callback</code></em> will not be called
1229
1431
</td>
1230
1432
</tr>
1234
1436
<hr>
1235
1437
<div class="refsect2" title="tp_connection_unref_handles ()">
1236
1438
<a name="tp-connection-unref-handles"></a><h3>tp_connection_unref_handles ()</h3>
1237
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_unref_handles         (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
1238
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="returnvalue">TpHandleType</span></a> handle_type,
1239
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_handles,
1240
 
                                                         const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a> *handles);</pre>
 
1439
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_unref_handles         (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1440
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
1441
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_handles</code></em>,
 
1442
                                                         <em class="parameter"><code>const <a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="type">TpHandle</span></a> *handles</code></em>);</pre>
1241
1443
<p>
1242
1444
Release the reference to the handles in <em class="parameter"><code>handles</code></em> that was obtained by
1243
1445
calling <a class="link" href="telepathy-glib-connection.html#tp-connection-hold-handles" title="tp_connection_hold_handles ()"><code class="function">tp_connection_hold_handles()</code></a> or <a class="link" href="telepathy-glib-connection.html#tp-connection-request-handles" title="tp_connection_request_handles ()"><code class="function">tp_connection_request_handles()</code></a>.
1256
1458
perform client-side reference counting of handles.
1257
1459
</p>
1258
1460
<p>
1259
 
If <em class="parameter"><code>self</code></em> has already become invalid, this function does nothing.</p>
 
1461
If <em class="parameter"><code>self</code></em> has already become invalid, this function does nothing.
 
1462
</p>
1260
1463
<div class="variablelist"><table border="0">
1261
1464
<col align="left" valign="top">
1262
1465
<tbody>
1263
1466
<tr>
1264
1467
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1265
 
<td> a connection
 
1468
<td>a connection
1266
1469
</td>
1267
1470
</tr>
1268
1471
<tr>
1269
1472
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
1270
 
<td> a handle type
 
1473
<td>a handle type
1271
1474
</td>
1272
1475
</tr>
1273
1476
<tr>
1274
1477
<td><p><span class="term"><em class="parameter"><code>n_handles</code></em> :</span></p></td>
1275
 
<td> the number of handles in <em class="parameter"><code>handles</code></em>
 
1478
<td>the number of handles in <em class="parameter"><code>handles</code></em>
1276
1479
</td>
1277
1480
</tr>
1278
1481
<tr>
1279
1482
<td><p><span class="term"><em class="parameter"><code>handles</code></em> :</span></p></td>
1280
 
<td> an array of <em class="parameter"><code>n_handles</code></em> handles
1281
 
</td>
 
1483
<td> an array of <em class="parameter"><code>n_handles</code></em> handles. <acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_handles. </td>
1282
1484
</tr>
1283
1485
</tbody>
1284
1486
</table></div>
1286
1488
<hr>
1287
1489
<div class="refsect2" title="tp_connection_init_known_interfaces ()">
1288
1490
<a name="tp-connection-init-known-interfaces"></a><h3>tp_connection_init_known_interfaces ()</h3>
1289
 
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_init_known_interfaces (void);</pre>
 
1491
<pre class="programlisting"><span class="returnvalue">void</span>                tp_connection_init_known_interfaces (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1290
1492
<p>
1291
1493
Ensure that the known interfaces for TpConnection have been set up.
1292
1494
This is done automatically when necessary, but for correct
1293
1495
overriding of library interfaces by local extensions, you should
1294
1496
call this function before calling
1295
1497
<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
1296
 
<code class="literal">TP_TYPE_CONNECTION</code>.</p>
 
1498
<code class="literal">TP_TYPE_CONNECTION</code>.
 
1499
</p>
1297
1500
<p class="since">Since 0.7.6</p>
1298
1501
</div>
1299
1502
<hr>
1300
1503
<div class="refsect2" title="tp_connection_presence_type_cmp_availability ()">
1301
1504
<a name="tp-connection-presence-type-cmp-availability"></a><h3>tp_connection_presence_type_cmp_availability ()</h3>
1302
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                tp_connection_presence_type_cmp_availability
1303
 
                                                        (<a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> p1,
1304
 
                                                         <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="returnvalue">TpConnectionPresenceType</span></a> p2);</pre>
 
1505
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                tp_connection_presence_type_cmp_availability
 
1506
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> p1</code></em>,
 
1507
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a> p2</code></em>);</pre>
1305
1508
<p>
1306
1509
Compares <em class="parameter"><code>p1</code></em> and <em class="parameter"><code>p2</code></em> like <code class="function">strcmp()</code>. <em class="parameter"><code>p1</code></em> &gt; <em class="parameter"><code>p2</code></em> means <em class="parameter"><code>p1</code></em> is more available
1307
1510
than <em class="parameter"><code>p2</code></em>.
1308
1511
</p>
1309
1512
<p>
1310
1513
The order used is: available &gt; busy &gt; away &gt; xa &gt; hidden &gt; offline &gt; error &gt;
1311
 
unknown &gt; unset</p>
 
1514
unknown &gt; unset
 
1515
</p>
1312
1516
<div class="variablelist"><table border="0">
1313
1517
<col align="left" valign="top">
1314
1518
<tbody>
1315
1519
<tr>
1316
1520
<td><p><span class="term"><em class="parameter"><code>p1</code></em> :</span></p></td>
1317
 
<td> a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
 
1521
<td>a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
1318
1522
</td>
1319
1523
</tr>
1320
1524
<tr>
1321
1525
<td><p><span class="term"><em class="parameter"><code>p2</code></em> :</span></p></td>
1322
 
<td> a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
 
1526
<td>a <a class="link" href="telepathy-glib-enums.html#TpConnectionPresenceType" title="enum TpConnectionPresenceType"><span class="type">TpConnectionPresenceType</span></a>
1323
1527
</td>
1324
1528
</tr>
1325
1529
<tr>
1335
1539
<hr>
1336
1540
<div class="refsect2" title="tp_connection_parse_object_path ()">
1337
1541
<a name="tp-connection-parse-object-path"></a><h3>tp_connection_parse_object_path ()</h3>
1338
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_parse_object_path     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *self,
1339
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **protocol,
1340
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **cm_name);</pre>
 
1542
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_connection_parse_object_path     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1543
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **protocol</code></em>,
 
1544
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **cm_name</code></em>);</pre>
1341
1545
<p>
1342
1546
If the object path of <em class="parameter"><code>connection</code></em> is in the correct form, set
1343
1547
<em class="parameter"><code>protocol</code></em> and <em class="parameter"><code>cm_name</code></em>, return TRUE. Otherwise leave them unchanged and
1344
 
return FALSE.</p>
 
1548
return FALSE.
 
1549
</p>
1345
1550
<div class="variablelist"><table border="0">
1346
1551
<col align="left" valign="top">
1347
1552
<tbody>
1348
1553
<tr>
1349
1554
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1350
 
<td> a connection
 
1555
<td>a connection
1351
1556
</td>
1352
1557
</tr>
1353
1558
<tr>
1354
1559
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
1355
 
<td> If not NULL, used to return the protocol of the connection
1356
 
</td>
 
1560
<td> If not NULL, used to return the protocol
 
1561
 of the connection. <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>. </td>
1357
1562
</tr>
1358
1563
<tr>
1359
1564
<td><p><span class="term"><em class="parameter"><code>cm_name</code></em> :</span></p></td>
1360
 
<td> If not NULL, used to return the connection manager name of the
1361
 
connection
1362
 
</td>
 
1565
<td> If not NULL, used to return the connection
 
1566
 manager name of the connection. <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>. </td>
1363
1567
</tr>
1364
1568
<tr>
1365
1569
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1372
1576
<p class="since">Since 0.7.27</p>
1373
1577
</div>
1374
1578
<hr>
1375
 
<div class="refsect2" title="TpConnection">
1376
 
<a name="TpConnection-struct"></a><h3>TpConnection</h3>
1377
 
<pre class="programlisting">typedef struct _TpConnection TpConnection;</pre>
 
1579
<div class="refsect2" title="tp_connection_get_capabilities ()">
 
1580
<a name="tp-connection-get-capabilities"></a><h3>tp_connection_get_capabilities ()</h3>
 
1581
<pre class="programlisting"><a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="returnvalue">TpCapabilities</span></a> *    tp_connection_get_capabilities      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);</pre>
1378
1582
<p>
1379
 
A proxy object for a Telepathy connection.
 
1583
 
1380
1584
</p>
1381
 
<p>
1382
 
(Changed in 0.7.12: the layout of the structure is visible, allowing
1383
 
subclassing.)</p>
1384
1585
<div class="variablelist"><table border="0">
1385
1586
<col align="left" valign="top">
1386
 
<tbody></tbody>
 
1587
<tbody>
 
1588
<tr>
 
1589
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
1590
<td>a connection
 
1591
</td>
 
1592
</tr>
 
1593
<tr>
 
1594
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1595
<td> the same <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a> as the <a class="link" href="telepathy-glib-connection.html#TpConnection--capabilities" title='The "capabilities" property'><span class="type">"capabilities"</span></a>
 
1596
property
 
1597
</td>
 
1598
</tr>
 
1599
</tbody>
1387
1600
</table></div>
1388
 
<p class="since">Since 0.7.1</p>
 
1601
<p class="since">Since 0.11.3</p>
1389
1602
</div>
1390
1603
<hr>
1391
 
<div class="refsect2" title="TpConnectionClass">
1392
 
<a name="TpConnectionClass"></a><h3>TpConnectionClass</h3>
1393
 
<pre class="programlisting">typedef struct {
1394
 
    TpProxyClass parent_class;
1395
 
} TpConnectionClass;
1396
 
</pre>
1397
 
<p>
1398
 
The class of a <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>. In addition to <em class="parameter"><code>parent_class</code></em> there are four
1399
 
pointers reserved for possible future use.
1400
 
</p>
1401
 
<p>
1402
 
(Changed in 0.7.12: the layout of the structure is visible, allowing
1403
 
subclassing.)</p>
 
1604
<div class="refsect2" title="tp_connection_get_avatar_requirements ()">
 
1605
<a name="tp-connection-get-avatar-requirements"></a><h3>tp_connection_get_avatar_requirements ()</h3>
 
1606
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * tp_connection_get_avatar_requirements
 
1607
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>);</pre>
 
1608
<p>
 
1609
To wait for valid avatar requirements, call <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>
 
1610
with the feature <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-AVATAR-REQUIREMENTS:CAPS" title="TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS"><code class="literal">TP_CONNECTION_FEATURE_AVATAR_REQUIREMENTS</code></a>.
 
1611
</p>
 
1612
<p>
 
1613
This property cannot change after <em class="parameter"><code>self</code></em> goes to the Connected state.
 
1614
</p>
1404
1615
<div class="variablelist"><table border="0">
1405
1616
<col align="left" valign="top">
1406
 
<tbody><tr>
1407
 
<td><p><span class="term"><a class="link" href="telepathy-glib-proxy.html#TpProxyClass" title="TpProxyClass"><span class="type">TpProxyClass</span></a> <em class="structfield"><code><a name="TpConnectionClass.parent-class"></a>parent_class</code></em>;</span></p></td>
1408
 
<td> the parent class
 
1617
<tbody>
 
1618
<tr>
 
1619
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
1620
<td>a connection
1409
1621
</td>
1410
 
</tr></tbody>
 
1622
</tr>
 
1623
<tr>
 
1624
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1625
<td> a <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a> struct, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
 
1626
 feature is not yet prepared or the connection doesn't have the necessary
 
1627
 properties.. <acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>. </td>
 
1628
</tr>
 
1629
</tbody>
1411
1630
</table></div>
1412
 
<p class="since">Since 0.7.1</p>
 
1631
<p class="since">Since 0.11.4</p>
1413
1632
</div>
1414
1633
<hr>
1415
1634
<div class="refsect2" title="TP_UNKNOWN_CONNECTION_STATUS">
1418
1637
</pre>
1419
1638
<p>
1420
1639
An invalid connection status used in <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> to indicate that the
1421
 
status has not yet been discovered.</p>
 
1640
status has not yet been discovered.
 
1641
</p>
1422
1642
<p class="since">Since 0.7.1</p>
1423
1643
</div>
1424
1644
<hr>
1427
1647
<pre class="programlisting">#define TP_ERRORS_DISCONNECTED (tp_errors_disconnected_quark ())
1428
1648
</pre>
1429
1649
<p>
1430
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain representing a Telepathy connection becoming disconnected.
1431
 
The <em class="parameter"><code>code</code></em> in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> with this domain must be a member of
 
1650
<a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain representing a Telepathy connection becoming disconnected.
 
1651
The <em class="parameter"><code>code</code></em> in a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> with this domain must be a member of
1432
1652
<a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a>.
1433
1653
</p>
1434
1654
<p>
1435
 
This macro expands to a function call returning a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.</p>
 
1655
This macro expands to a function call returning a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.
 
1656
</p>
 
1657
<p>
 
1658
Since 0.7.24, this error domain is only used if a connection manager emits
 
1659
a <a class="link" href="telepathy-glib-enums.html#TpConnectionStatusReason" title="enum TpConnectionStatusReason"><span class="type">TpConnectionStatusReason</span></a> not known to telepathy-glib.
 
1660
</p>
1436
1661
<p class="since">Since 0.7.1</p>
1437
1662
</div>
1438
1663
<hr>
 
1664
<div class="refsect2" title="tp_connection_get_detailed_error ()">
 
1665
<a name="tp-connection-get-detailed-error"></a><h3>tp_connection_get_detailed_error ()</h3>
 
1666
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       tp_connection_get_detailed_error    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *self</code></em>,
 
1667
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> **details</code></em>);</pre>
 
1668
<p>
 
1669
If the connection has disconnected, return the D-Bus error name with which
 
1670
it disconnected (in particular, this 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
 
1671
disconnected by a user request).
 
1672
</p>
 
1673
<p>
 
1674
Otherwise, return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, without altering <em class="parameter"><code>details</code></em>.
 
1675
</p>
 
1676
<div class="variablelist"><table border="0">
 
1677
<col align="left" valign="top">
 
1678
<tbody>
 
1679
<tr>
 
1680
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
1681
<td>a connection
 
1682
</td>
 
1683
</tr>
 
1684
<tr>
 
1685
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
 
1686
<td>
 
1687
 optionally used to return a map from string to <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a>, which must not be
 
1688
 modified or destroyed by the caller. <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> utf8 GObject.Value. </td>
 
1689
</tr>
 
1690
<tr>
 
1691
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1692
<td> a D-Bus error name, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
1693
. <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>. </td>
 
1694
</tr>
 
1695
</tbody>
 
1696
</table></div>
 
1697
<p class="since">Since 0.11.4</p>
 
1698
</div>
 
1699
<hr>
 
1700
<div class="refsect2" title="TP_TYPE_AVATAR_REQUIREMENTS">
 
1701
<a name="TP-TYPE-AVATAR-REQUIREMENTS:CAPS"></a><h3>TP_TYPE_AVATAR_REQUIREMENTS</h3>
 
1702
<pre class="programlisting">#define TP_TYPE_AVATAR_REQUIREMENTS (tp_avatar_requirements_get_type ())
 
1703
</pre>
 
1704
<p>
 
1705
The boxed type of a <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>.
 
1706
</p>
 
1707
<p class="since">Since 0.11.4</p>
 
1708
</div>
 
1709
<hr>
 
1710
<div class="refsect2" title="TpAvatarRequirements">
 
1711
<a name="TpAvatarRequirements"></a><h3>TpAvatarRequirements</h3>
 
1712
<pre class="programlisting">typedef struct {
 
1713
  gchar **supported_mime_types;
 
1714
  guint minimum_width;
 
1715
  guint minimum_height;
 
1716
  guint recommended_width;
 
1717
  guint recommended_height;
 
1718
  guint maximum_width;
 
1719
  guint maximum_height;
 
1720
  guint maximum_bytes;
 
1721
} TpAvatarRequirements;
 
1722
</pre>
 
1723
<p>
 
1724
The requirements for setting an avatar on a particular protocol.
 
1725
</p>
 
1726
<div class="variablelist"><table border="0">
 
1727
<col align="left" valign="top">
 
1728
<tbody>
 
1729
<tr>
 
1730
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **<em class="structfield"><code><a name="TpAvatarRequirements.supported-mime-types"></a>supported_mime_types</code></em>;</span></p></td>
 
1731
<td>An array of supported MIME types (e.g. "image/jpeg")
 
1732
 Clients MAY assume that the first type in this array is preferred
 
1733
</td>
 
1734
</tr>
 
1735
<tr>
 
1736
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.minimum-width"></a>minimum_width</code></em>;</span></p></td>
 
1737
<td>The minimum width in pixels of an avatar, which MAY be 0
 
1738
</td>
 
1739
</tr>
 
1740
<tr>
 
1741
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.minimum-height"></a>minimum_height</code></em>;</span></p></td>
 
1742
<td>The minimum height in pixels of an avatar, which MAY be 0
 
1743
</td>
 
1744
</tr>
 
1745
<tr>
 
1746
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.recommended-width"></a>recommended_width</code></em>;</span></p></td>
 
1747
<td>The recommended width in pixels of an avatar, or 0 if
 
1748
 there is no preferred width.
 
1749
</td>
 
1750
</tr>
 
1751
<tr>
 
1752
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.recommended-height"></a>recommended_height</code></em>;</span></p></td>
 
1753
<td>The recommended height in pixels of an avatar, or 0 if
 
1754
 there is no preferred height
 
1755
</td>
 
1756
</tr>
 
1757
<tr>
 
1758
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.maximum-width"></a>maximum_width</code></em>;</span></p></td>
 
1759
<td>The maximum width in pixels of an avatar on this protocol,
 
1760
 or 0 if there is no limit.
 
1761
</td>
 
1762
</tr>
 
1763
<tr>
 
1764
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.maximum-height"></a>maximum_height</code></em>;</span></p></td>
 
1765
<td>The maximum height in pixels of an avatar, or 0 if there is
 
1766
 no limit.
 
1767
</td>
 
1768
</tr>
 
1769
<tr>
 
1770
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="TpAvatarRequirements.maximum-bytes"></a>maximum_bytes</code></em>;</span></p></td>
 
1771
<td>he maximum size in bytes of an avatar, or 0 if there is no
 
1772
 limit.
 
1773
</td>
 
1774
</tr>
 
1775
</tbody>
 
1776
</table></div>
 
1777
<p class="since">Since 0.11.4</p>
 
1778
</div>
 
1779
<hr>
 
1780
<div class="refsect2" title="tp_avatar_requirements_new ()">
 
1781
<a name="tp-avatar-requirements-new"></a><h3>tp_avatar_requirements_new ()</h3>
 
1782
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * tp_avatar_requirements_new       (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a> supported_mime_types</code></em>,
 
1783
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minimum_width</code></em>,
 
1784
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minimum_height</code></em>,
 
1785
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> recommended_width</code></em>,
 
1786
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> recommended_height</code></em>,
 
1787
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_width</code></em>,
 
1788
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_height</code></em>,
 
1789
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> maximum_bytes</code></em>);</pre>
 
1790
<p>
 
1791
 
 
1792
</p>
 
1793
<div class="variablelist"><table border="0">
 
1794
<col align="left" valign="top">
 
1795
<tbody>
 
1796
<tr>
 
1797
<td><p><span class="term"><em class="parameter"><code>supported_mime_types</code></em> :</span></p></td>
 
1798
<td>An array of supported MIME types (e.g. "image/jpeg")
 
1799
 Clients MAY assume that the first type in this array is preferred
 
1800
</td>
 
1801
</tr>
 
1802
<tr>
 
1803
<td><p><span class="term"><em class="parameter"><code>minimum_width</code></em> :</span></p></td>
 
1804
<td>The minimum width in pixels of an avatar, which MAY be 0
 
1805
</td>
 
1806
</tr>
 
1807
<tr>
 
1808
<td><p><span class="term"><em class="parameter"><code>minimum_height</code></em> :</span></p></td>
 
1809
<td>The minimum height in pixels of an avatar, which MAY be 0
 
1810
</td>
 
1811
</tr>
 
1812
<tr>
 
1813
<td><p><span class="term"><em class="parameter"><code>recommended_width</code></em> :</span></p></td>
 
1814
<td>The recommended width in pixels of an avatar, or 0 if
 
1815
 there is no preferred width.
 
1816
</td>
 
1817
</tr>
 
1818
<tr>
 
1819
<td><p><span class="term"><em class="parameter"><code>recommended_height</code></em> :</span></p></td>
 
1820
<td>The recommended height in pixels of an avatar, or 0 if
 
1821
 there is no preferred height
 
1822
</td>
 
1823
</tr>
 
1824
<tr>
 
1825
<td><p><span class="term"><em class="parameter"><code>maximum_width</code></em> :</span></p></td>
 
1826
<td>The maximum width in pixels of an avatar on this protocol,
 
1827
 or 0 if there is no limit.
 
1828
</td>
 
1829
</tr>
 
1830
<tr>
 
1831
<td><p><span class="term"><em class="parameter"><code>maximum_height</code></em> :</span></p></td>
 
1832
<td>The maximum height in pixels of an avatar, or 0 if there is
 
1833
 no limit.
 
1834
</td>
 
1835
</tr>
 
1836
<tr>
 
1837
<td><p><span class="term"><em class="parameter"><code>maximum_bytes</code></em> :</span></p></td>
 
1838
<td>he maximum size in bytes of an avatar, or 0 if there is no
 
1839
 limit.
 
1840
</td>
 
1841
</tr>
 
1842
<tr>
 
1843
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1844
<td> a newly allocated <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>, free it with
 
1845
<a class="link" href="telepathy-glib-connection.html#tp-avatar-requirements-destroy" title="tp_avatar_requirements_destroy ()"><code class="function">tp_avatar_requirements_destroy()</code></a>
 
1846
</td>
 
1847
</tr>
 
1848
</tbody>
 
1849
</table></div>
 
1850
<p class="since">Since 0.11.4</p>
 
1851
</div>
 
1852
<hr>
 
1853
<div class="refsect2" title="tp_avatar_requirements_copy ()">
 
1854
<a name="tp-avatar-requirements-copy"></a><h3>tp_avatar_requirements_copy ()</h3>
 
1855
<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="returnvalue">TpAvatarRequirements</span></a> * tp_avatar_requirements_copy      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a> *self</code></em>);</pre>
 
1856
<p>
 
1857
 
 
1858
</p>
 
1859
<div class="variablelist"><table border="0">
 
1860
<col align="left" valign="top">
 
1861
<tbody>
 
1862
<tr>
 
1863
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
1864
<td>a <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>
 
1865
</td>
 
1866
</tr>
 
1867
<tr>
 
1868
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1869
<td> a newly allocated <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>, free it with
 
1870
<a class="link" href="telepathy-glib-connection.html#tp-avatar-requirements-destroy" title="tp_avatar_requirements_destroy ()"><code class="function">tp_avatar_requirements_destroy()</code></a>
 
1871
</td>
 
1872
</tr>
 
1873
</tbody>
 
1874
</table></div>
 
1875
<p class="since">Since 0.11.4</p>
 
1876
</div>
 
1877
<hr>
 
1878
<div class="refsect2" title="tp_avatar_requirements_destroy ()">
 
1879
<a name="tp-avatar-requirements-destroy"></a><h3>tp_avatar_requirements_destroy ()</h3>
 
1880
<pre class="programlisting"><span class="returnvalue">void</span>                tp_avatar_requirements_destroy      (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a> *self</code></em>);</pre>
 
1881
<p>
 
1882
Free all memory used by the <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>.
 
1883
</p>
 
1884
<div class="variablelist"><table border="0">
 
1885
<col align="left" valign="top">
 
1886
<tbody><tr>
 
1887
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
1888
<td>a <a class="link" href="telepathy-glib-connection.html#TpAvatarRequirements" title="TpAvatarRequirements"><span class="type">TpAvatarRequirements</span></a>
 
1889
</td>
 
1890
</tr></tbody>
 
1891
</table></div>
 
1892
<p class="since">Since 0.11.4</p>
 
1893
</div>
 
1894
<hr>
1439
1895
<div class="refsect2" title="tp_cli_connection_callback_for_connect ()">
1440
1896
<a name="tp-cli-connection-callback-for-connect"></a><h3>tp_cli_connection_callback_for_connect ()</h3>
1441
1897
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_connect)
1442
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1443
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
1444
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1445
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1898
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
1899
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
1900
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1901
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1446
1902
<p>
1447
1903
Signature of the callback called when a Connect method call
1448
 
succeeds or fails.</p>
 
1904
succeeds or fails.
 
1905
</p>
1449
1906
<div class="variablelist"><table border="0">
1450
1907
<col align="left" valign="top">
1451
1908
<tbody>
1452
1909
<tr>
1453
1910
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1454
 
<td> the proxy on which the call was made
 
1911
<td>the proxy on which the call was made
1455
1912
</td>
1456
1913
</tr>
1457
1914
<tr>
1458
1915
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1459
 
<td> <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
 
1916
<td>
 
1917
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
1460
1918
</td>
1461
1919
</tr>
1462
1920
<tr>
1463
1921
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1464
 
<td> user-supplied data
 
1922
<td>user-supplied data
1465
1923
</td>
1466
1924
</tr>
1467
1925
<tr>
1468
1926
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1469
 
<td> user-supplied object
 
1927
<td>user-supplied object
1470
1928
</td>
1471
1929
</tr>
1472
1930
</tbody>
1475
1933
<hr>
1476
1934
<div class="refsect2" title="tp_cli_connection_call_connect ()">
1477
1935
<a name="tp-cli-connection-call-connect"></a><h3>tp_cli_connection_call_connect ()</h3>
1478
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_connect     (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1479
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1480
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()"><span class="returnvalue">tp_cli_connection_callback_for_connect</span></a> callback,
1481
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1482
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1483
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
1936
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_connect     (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
1937
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
1938
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-connect" title="tp_cli_connection_callback_for_connect ()"><span class="type">tp_cli_connection_callback_for_connect</span></a> callback</code></em>,
 
1939
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
1940
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
1941
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1484
1942
<p>
1485
1943
Start a Connect method call.
1486
1944
</p>
1487
1945
<p>
1488
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request that the connection be established. This will be done           asynchronously and errors will be returned by emitting           &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signals.&lt;/p&gt;          &lt;p&gt;Calling this method on a Connection that is already connecting           or connected is allowed, and has no effect.&lt;/p&gt;</p>
 
1946
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request that the connection be established. This will be done           asynchronously and errors will be returned by emitting           &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signals.&lt;/p&gt;          &lt;p&gt;Calling this method on a Connection that is already connecting           or connected is allowed, and has no effect.&lt;/p&gt;
 
1947
</p>
1489
1948
<div class="variablelist"><table border="0">
1490
1949
<col align="left" valign="top">
1491
1950
<tbody>
1492
1951
<tr>
1493
1952
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1494
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
1953
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1495
1954
</td>
1496
1955
</tr>
1497
1956
<tr>
1498
1957
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1499
 
<td> the timeout in milliseconds, or -1 to use the
 
1958
<td>the timeout in milliseconds, or -1 to use the
1500
1959
  default
1501
1960
</td>
1502
1961
</tr>
1503
1962
<tr>
1504
1963
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1505
 
<td> called when the method call succeeds or fails;
1506
 
  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 
 
1964
<td>called when the method call succeeds or fails;
 
1965
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
1507
1966
  reply tracking
1508
1967
</td>
1509
1968
</tr>
1510
1969
<tr>
1511
1970
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1512
 
<td> user-supplied data passed to the callback;
1513
 
  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>
 
1971
<td>user-supplied data passed to the callback;
 
1972
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1514
1973
</td>
1515
1974
</tr>
1516
1975
<tr>
1517
1976
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1518
 
<td> called with the user_data as argument, after the
 
1977
<td>called with the user_data as argument, after the
1519
1978
  call has succeeded, failed or been cancelled;
1520
 
  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>
 
1979
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1521
1980
</td>
1522
1981
</tr>
1523
1982
<tr>
1524
1983
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1525
 
<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 
 
1984
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
1526
1985
  weakly referenced; if it is destroyed, this call 
1527
 
  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 
1528
 
  <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>
 
1986
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
1987
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1529
1988
</td>
1530
1989
</tr>
1531
1990
<tr>
1542
2001
<hr>
1543
2002
<div class="refsect2" title="tp_cli_connection_run_connect ()">
1544
2003
<a name="tp-cli-connection-run-connect"></a><h3>tp_cli_connection_run_connect ()</h3>
1545
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_connect       (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1546
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1547
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
1548
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2004
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_connect       (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2005
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2006
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2007
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
2008
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
2009
<h3 class="title">Warning</h3>
 
2010
<p><code class="literal">tp_cli_connection_run_connect</code> is deprecated and should not be used in newly-written code.</p>
 
2011
</div>
1549
2012
<p>
1550
2013
Call the method Connect and run the main loop
1551
2014
until it returns. Before calling this method, you must
1554
2017
state.
1555
2018
</p>
1556
2019
<p>
1557
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request that the connection be established. This will be done           asynchronously and errors will be returned by emitting           &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signals.&lt;/p&gt;          &lt;p&gt;Calling this method on a Connection that is already connecting           or connected is allowed, and has no effect.&lt;/p&gt;</p>
 
2020
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request that the connection be established. This will be done           asynchronously and errors will be returned by emitting           &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signals.&lt;/p&gt;          &lt;p&gt;Calling this method on a Connection that is already connecting           or connected is allowed, and has no effect.&lt;/p&gt;
 
2021
</p>
1558
2022
<div class="variablelist"><table border="0">
1559
2023
<col align="left" valign="top">
1560
2024
<tbody>
1561
2025
<tr>
1562
2026
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1563
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2027
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
1564
2028
</td>
1565
2029
</tr>
1566
2030
<tr>
1567
2031
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1568
 
<td> Timeout in milliseconds, or -1 for default
 
2032
<td>Timeout in milliseconds, or -1 for default
1569
2033
</td>
1570
2034
</tr>
1571
2035
<tr>
1572
2036
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1573
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2037
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
1574
2038
 is returned
1575
2039
</td>
1576
2040
</tr>
1577
2041
<tr>
1578
2042
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1579
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
1580
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2043
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2044
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
1581
2045
 which can be used to cancel this call with 
1582
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
1583
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2046
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2047
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1584
2048
</td>
1585
2049
</tr>
1586
2050
<tr>
1595
2059
<div class="refsect2" title="tp_cli_connection_callback_for_disconnect ()">
1596
2060
<a name="tp-cli-connection-callback-for-disconnect"></a><h3>tp_cli_connection_callback_for_disconnect ()</h3>
1597
2061
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_disconnect)
1598
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1599
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
1600
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1601
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2062
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2063
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2064
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2065
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1602
2066
<p>
1603
2067
Signature of the callback called when a Disconnect method call
1604
 
succeeds or fails.</p>
 
2068
succeeds or fails.
 
2069
</p>
1605
2070
<div class="variablelist"><table border="0">
1606
2071
<col align="left" valign="top">
1607
2072
<tbody>
1608
2073
<tr>
1609
2074
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1610
 
<td> the proxy on which the call was made
 
2075
<td>the proxy on which the call was made
1611
2076
</td>
1612
2077
</tr>
1613
2078
<tr>
1614
2079
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1615
 
<td> <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
 
2080
<td>
 
2081
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
1616
2082
</td>
1617
2083
</tr>
1618
2084
<tr>
1619
2085
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1620
 
<td> user-supplied data
 
2086
<td>user-supplied data
1621
2087
</td>
1622
2088
</tr>
1623
2089
<tr>
1624
2090
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1625
 
<td> user-supplied object
 
2091
<td>user-supplied object
1626
2092
</td>
1627
2093
</tr>
1628
2094
</tbody>
1631
2097
<hr>
1632
2098
<div class="refsect2" title="tp_cli_connection_call_disconnect ()">
1633
2099
<a name="tp-cli-connection-call-disconnect"></a><h3>tp_cli_connection_call_disconnect ()</h3>
1634
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_disconnect  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1635
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1636
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()"><span class="returnvalue">tp_cli_connection_callback_for_disconnect</span></a> callback,
1637
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1638
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1639
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2100
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_disconnect  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2101
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2102
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-disconnect" title="tp_cli_connection_callback_for_disconnect ()"><span class="type">tp_cli_connection_callback_for_disconnect</span></a> callback</code></em>,
 
2103
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2104
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2105
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1640
2106
<p>
1641
2107
Start a Disconnect method call.
1642
2108
</p>
1643
2109
<p>
1644
 
Request that the connection be closed. This closes the connection if         it's not already in DISCONNECTED state, and destroys the connection         object.</p>
 
2110
Request that the connection be closed. This closes the connection if         it's not already in DISCONNECTED state, and destroys the connection         object.
 
2111
</p>
1645
2112
<div class="variablelist"><table border="0">
1646
2113
<col align="left" valign="top">
1647
2114
<tbody>
1648
2115
<tr>
1649
2116
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1650
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2117
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1651
2118
</td>
1652
2119
</tr>
1653
2120
<tr>
1654
2121
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1655
 
<td> the timeout in milliseconds, or -1 to use the
 
2122
<td>the timeout in milliseconds, or -1 to use the
1656
2123
  default
1657
2124
</td>
1658
2125
</tr>
1659
2126
<tr>
1660
2127
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1661
 
<td> called when the method call succeeds or fails;
1662
 
  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 
 
2128
<td>called when the method call succeeds or fails;
 
2129
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
1663
2130
  reply tracking
1664
2131
</td>
1665
2132
</tr>
1666
2133
<tr>
1667
2134
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1668
 
<td> user-supplied data passed to the callback;
1669
 
  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>
 
2135
<td>user-supplied data passed to the callback;
 
2136
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1670
2137
</td>
1671
2138
</tr>
1672
2139
<tr>
1673
2140
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1674
 
<td> called with the user_data as argument, after the
 
2141
<td>called with the user_data as argument, after the
1675
2142
  call has succeeded, failed or been cancelled;
1676
 
  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>
 
2143
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1677
2144
</td>
1678
2145
</tr>
1679
2146
<tr>
1680
2147
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1681
 
<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 
 
2148
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
1682
2149
  weakly referenced; if it is destroyed, this call 
1683
 
  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 
1684
 
  <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>
 
2150
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2151
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1685
2152
</td>
1686
2153
</tr>
1687
2154
<tr>
1698
2165
<hr>
1699
2166
<div class="refsect2" title="tp_cli_connection_run_disconnect ()">
1700
2167
<a name="tp-cli-connection-run-disconnect"></a><h3>tp_cli_connection_run_disconnect ()</h3>
1701
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_disconnect    (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1702
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1703
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
1704
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2168
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_disconnect    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2169
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2170
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2171
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
2172
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
2173
<h3 class="title">Warning</h3>
 
2174
<p><code class="literal">tp_cli_connection_run_disconnect</code> is deprecated and should not be used in newly-written code.</p>
 
2175
</div>
1705
2176
<p>
1706
2177
Call the method Disconnect and run the main loop
1707
2178
until it returns. Before calling this method, you must
1710
2181
state.
1711
2182
</p>
1712
2183
<p>
1713
 
Request that the connection be closed. This closes the connection if         it's not already in DISCONNECTED state, and destroys the connection         object.</p>
 
2184
Request that the connection be closed. This closes the connection if         it's not already in DISCONNECTED state, and destroys the connection         object.
 
2185
</p>
1714
2186
<div class="variablelist"><table border="0">
1715
2187
<col align="left" valign="top">
1716
2188
<tbody>
1717
2189
<tr>
1718
2190
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1719
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2191
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
1720
2192
</td>
1721
2193
</tr>
1722
2194
<tr>
1723
2195
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1724
 
<td> Timeout in milliseconds, or -1 for default
 
2196
<td>Timeout in milliseconds, or -1 for default
1725
2197
</td>
1726
2198
</tr>
1727
2199
<tr>
1728
2200
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1729
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2201
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
1730
2202
 is returned
1731
2203
</td>
1732
2204
</tr>
1733
2205
<tr>
1734
2206
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1735
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
1736
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2207
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2208
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
1737
2209
 which can be used to cancel this call with 
1738
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
1739
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2210
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2211
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1740
2212
</td>
1741
2213
</tr>
1742
2214
<tr>
1751
2223
<div class="refsect2" title="tp_cli_connection_callback_for_get_interfaces ()">
1752
2224
<a name="tp-cli-connection-callback-for-get-interfaces"></a><h3>tp_cli_connection_callback_for_get_interfaces ()</h3>
1753
2225
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_get_interfaces)
1754
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1755
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Interfaces,
1756
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
1757
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1758
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2226
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2227
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Interfaces</code></em>,
 
2228
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2229
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2230
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1759
2231
<p>
1760
2232
Signature of the callback called when a GetInterfaces method call
1761
 
succeeds or fails.</p>
 
2233
succeeds or fails.
 
2234
</p>
1762
2235
<div class="variablelist"><table border="0">
1763
2236
<col align="left" valign="top">
1764
2237
<tbody>
1765
2238
<tr>
1766
2239
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1767
 
<td> the proxy on which the call was made
 
2240
<td>the proxy on which the call was made
1768
2241
</td>
1769
2242
</tr>
1770
2243
<tr>
1771
2244
<td><p><span class="term"><em class="parameter"><code>out_Interfaces</code></em> :</span></p></td>
1772
 
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of D-Bus interface names
 
2245
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The value of the &lt;tp:member-ref&gt;Interfaces&lt;/tp:member-ref&gt; property
1773
2246
</td>
1774
2247
</tr>
1775
2248
<tr>
1776
2249
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1777
 
<td> <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
 
2250
<td>
 
2251
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
1778
2252
</td>
1779
2253
</tr>
1780
2254
<tr>
1781
2255
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1782
 
<td> user-supplied data
 
2256
<td>user-supplied data
1783
2257
</td>
1784
2258
</tr>
1785
2259
<tr>
1786
2260
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1787
 
<td> user-supplied object
 
2261
<td>user-supplied object
1788
2262
</td>
1789
2263
</tr>
1790
2264
</tbody>
1794
2268
<div class="refsect2" title="tp_cli_connection_call_get_interfaces ()">
1795
2269
<a name="tp-cli-connection-call-get-interfaces"></a><h3>tp_cli_connection_call_get_interfaces ()</h3>
1796
2270
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_get_interfaces
1797
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1798
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1799
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()"><span class="returnvalue">tp_cli_connection_callback_for_get_interfaces</span></a> callback,
1800
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1801
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1802
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2271
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2272
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2273
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-interfaces" title="tp_cli_connection_callback_for_get_interfaces ()"><span class="type">tp_cli_connection_callback_for_get_interfaces</span></a> callback</code></em>,
 
2274
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2275
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2276
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1803
2277
<p>
1804
2278
Start a GetInterfaces method call.
1805
2279
</p>
1806
2280
<p>
1807
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Get the optional interfaces supported by this connection.           Before the connection status changes to CONNECTED, the return           from this method may change at any time, but it is guaranteed that           interfaces will only be added, not removed. After the connection           status changes to CONNECTED, the return from this method cannot           change further.&lt;/p&gt;          &lt;p&gt;There is no explicit change notification; reasonable behaviour           for a client would be to retrieve the interfaces list once           initially, and once more when it becomes CONNECTED.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;In some connection managers, certain capabilities of a connection             are known to be implemented for all connections (e.g. support             for SimplePresence), and some interfaces (like SimplePresence) can             even be used before connecting. Other capabilities may             or may not exist, depending on server functionality; by the time             the connection goes CONNECTED, the connection manager is expected             to have evaluated the server's functionality and enabled any extra             interfaces for the remainder of the Connection's lifetime.&lt;/p&gt;         &lt;/tp:rationale&gt;</p>
 
2281
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Returns the set of optional interfaces supported by this           connection. See &lt;tp:member-ref&gt;Interfaces&lt;/tp:member-ref&gt; for more           details.&lt;/p&gt;
 
2282
</p>
1808
2283
<div class="variablelist"><table border="0">
1809
2284
<col align="left" valign="top">
1810
2285
<tbody>
1811
2286
<tr>
1812
2287
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1813
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2288
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1814
2289
</td>
1815
2290
</tr>
1816
2291
<tr>
1817
2292
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1818
 
<td> the timeout in milliseconds, or -1 to use the
 
2293
<td>the timeout in milliseconds, or -1 to use the
1819
2294
  default
1820
2295
</td>
1821
2296
</tr>
1822
2297
<tr>
1823
2298
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1824
 
<td> called when the method call succeeds or fails;
1825
 
  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 
 
2299
<td>called when the method call succeeds or fails;
 
2300
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
1826
2301
  reply tracking
1827
2302
</td>
1828
2303
</tr>
1829
2304
<tr>
1830
2305
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1831
 
<td> user-supplied data passed to the callback;
1832
 
  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>
 
2306
<td>user-supplied data passed to the callback;
 
2307
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1833
2308
</td>
1834
2309
</tr>
1835
2310
<tr>
1836
2311
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1837
 
<td> called with the user_data as argument, after the
 
2312
<td>called with the user_data as argument, after the
1838
2313
  call has succeeded, failed or been cancelled;
1839
 
  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>
 
2314
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1840
2315
</td>
1841
2316
</tr>
1842
2317
<tr>
1843
2318
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1844
 
<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 
 
2319
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
1845
2320
  weakly referenced; if it is destroyed, this call 
1846
 
  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 
1847
 
  <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>
 
2321
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2322
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1848
2323
</td>
1849
2324
</tr>
1850
2325
<tr>
1861
2336
<hr>
1862
2337
<div class="refsect2" title="tp_cli_connection_run_get_interfaces ()">
1863
2338
<a name="tp-cli-connection-run-get-interfaces"></a><h3>tp_cli_connection_run_get_interfaces ()</h3>
1864
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_interfaces
1865
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1866
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1867
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ***out_Interfaces,
1868
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
1869
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2339
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_interfaces
 
2340
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2341
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2342
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***out_Interfaces</code></em>,
 
2343
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2344
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
2345
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
2346
<h3 class="title">Warning</h3>
 
2347
<p><code class="literal">tp_cli_connection_run_get_interfaces</code> is deprecated and should not be used in newly-written code.</p>
 
2348
</div>
1870
2349
<p>
1871
2350
Call the method GetInterfaces and run the main loop
1872
2351
until it returns. Before calling this method, you must
1875
2354
state.
1876
2355
</p>
1877
2356
<p>
1878
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Get the optional interfaces supported by this connection.           Before the connection status changes to CONNECTED, the return           from this method may change at any time, but it is guaranteed that           interfaces will only be added, not removed. After the connection           status changes to CONNECTED, the return from this method cannot           change further.&lt;/p&gt;          &lt;p&gt;There is no explicit change notification; reasonable behaviour           for a client would be to retrieve the interfaces list once           initially, and once more when it becomes CONNECTED.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;In some connection managers, certain capabilities of a connection             are known to be implemented for all connections (e.g. support             for SimplePresence), and some interfaces (like SimplePresence) can             even be used before connecting. Other capabilities may             or may not exist, depending on server functionality; by the time             the connection goes CONNECTED, the connection manager is expected             to have evaluated the server's functionality and enabled any extra             interfaces for the remainder of the Connection's lifetime.&lt;/p&gt;         &lt;/tp:rationale&gt;</p>
 
2357
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Returns the set of optional interfaces supported by this           connection. See &lt;tp:member-ref&gt;Interfaces&lt;/tp:member-ref&gt; for more           details.&lt;/p&gt;
 
2358
</p>
1879
2359
<div class="variablelist"><table border="0">
1880
2360
<col align="left" valign="top">
1881
2361
<tbody>
1882
2362
<tr>
1883
2363
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1884
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2364
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
1885
2365
</td>
1886
2366
</tr>
1887
2367
<tr>
1888
2368
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1889
 
<td> Timeout in milliseconds, or -1 for default
 
2369
<td>Timeout in milliseconds, or -1 for default
1890
2370
</td>
1891
2371
</tr>
1892
2372
<tr>
1893
2373
<td><p><span class="term"><em class="parameter"><code>out_Interfaces</code></em> :</span></p></td>
1894
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of D-Bus interface names
 
2374
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The value of the &lt;tp:member-ref&gt;Interfaces&lt;/tp:member-ref&gt; property
1895
2375
</td>
1896
2376
</tr>
1897
2377
<tr>
1898
2378
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1899
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2379
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
1900
2380
 is returned
1901
2381
</td>
1902
2382
</tr>
1903
2383
<tr>
1904
2384
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1905
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
1906
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2385
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2386
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
1907
2387
 which can be used to cancel this call with 
1908
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
1909
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2388
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2389
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1910
2390
</td>
1911
2391
</tr>
1912
2392
<tr>
1921
2401
<div class="refsect2" title="tp_cli_connection_callback_for_get_protocol ()">
1922
2402
<a name="tp-cli-connection-callback-for-get-protocol"></a><h3>tp_cli_connection_callback_for_get_protocol ()</h3>
1923
2403
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_get_protocol)
1924
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1925
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *out_Protocol,
1926
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
1927
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1928
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2404
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2405
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *out_Protocol</code></em>,
 
2406
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2407
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2408
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1929
2409
<p>
1930
2410
Signature of the callback called when a GetProtocol method call
1931
 
succeeds or fails.</p>
 
2411
succeeds or fails.
 
2412
</p>
1932
2413
<div class="variablelist"><table border="0">
1933
2414
<col align="left" valign="top">
1934
2415
<tbody>
1935
2416
<tr>
1936
2417
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1937
 
<td> the proxy on which the call was made
 
2418
<td>the proxy on which the call was made
1938
2419
</td>
1939
2420
</tr>
1940
2421
<tr>
1941
2422
<td><p><span class="term"><em class="parameter"><code>out_Protocol</code></em> :</span></p></td>
1942
 
<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>: A string identifier for the protocol
 
2423
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: A string identifier for the protocol
1943
2424
</td>
1944
2425
</tr>
1945
2426
<tr>
1946
2427
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1947
 
<td> <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
 
2428
<td>
 
2429
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
1948
2430
</td>
1949
2431
</tr>
1950
2432
<tr>
1951
2433
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1952
 
<td> user-supplied data
 
2434
<td>user-supplied data
1953
2435
</td>
1954
2436
</tr>
1955
2437
<tr>
1956
2438
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1957
 
<td> user-supplied object
 
2439
<td>user-supplied object
1958
2440
</td>
1959
2441
</tr>
1960
2442
</tbody>
1964
2446
<div class="refsect2" title="tp_cli_connection_call_get_protocol ()">
1965
2447
<a name="tp-cli-connection-call-get-protocol"></a><h3>tp_cli_connection_call_get_protocol ()</h3>
1966
2448
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_get_protocol
1967
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
1968
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
1969
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()"><span class="returnvalue">tp_cli_connection_callback_for_get_protocol</span></a> callback,
1970
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
1971
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
1972
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2449
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2450
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2451
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-protocol" title="tp_cli_connection_callback_for_get_protocol ()"><span class="type">tp_cli_connection_callback_for_get_protocol</span></a> callback</code></em>,
 
2452
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2453
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2454
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
1973
2455
<p>
1974
2456
Start a GetProtocol method call.
1975
2457
</p>
1976
2458
<p>
1977
 
Get the protocol this connection is using.</p>
 
2459
Get the protocol this connection is using.
 
2460
</p>
1978
2461
<div class="variablelist"><table border="0">
1979
2462
<col align="left" valign="top">
1980
2463
<tbody>
1981
2464
<tr>
1982
2465
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1983
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2466
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1984
2467
</td>
1985
2468
</tr>
1986
2469
<tr>
1987
2470
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1988
 
<td> the timeout in milliseconds, or -1 to use the
 
2471
<td>the timeout in milliseconds, or -1 to use the
1989
2472
  default
1990
2473
</td>
1991
2474
</tr>
1992
2475
<tr>
1993
2476
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1994
 
<td> called when the method call succeeds or fails;
1995
 
  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 
 
2477
<td>called when the method call succeeds or fails;
 
2478
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
1996
2479
  reply tracking
1997
2480
</td>
1998
2481
</tr>
1999
2482
<tr>
2000
2483
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2001
 
<td> user-supplied data passed to the callback;
2002
 
  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>
 
2484
<td>user-supplied data passed to the callback;
 
2485
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2003
2486
</td>
2004
2487
</tr>
2005
2488
<tr>
2006
2489
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2007
 
<td> called with the user_data as argument, after the
 
2490
<td>called with the user_data as argument, after the
2008
2491
  call has succeeded, failed or been cancelled;
2009
 
  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>
 
2492
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2010
2493
</td>
2011
2494
</tr>
2012
2495
<tr>
2013
2496
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2014
 
<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 
 
2497
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2015
2498
  weakly referenced; if it is destroyed, this call 
2016
 
  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 
2017
 
  <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>
 
2499
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2500
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2018
2501
</td>
2019
2502
</tr>
2020
2503
<tr>
2031
2514
<hr>
2032
2515
<div class="refsect2" title="tp_cli_connection_run_get_protocol ()">
2033
2516
<a name="tp-cli-connection-run-get-protocol"></a><h3>tp_cli_connection_run_get_protocol ()</h3>
2034
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_protocol  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2035
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2036
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Protocol,
2037
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2038
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2517
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_protocol  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2518
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2519
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Protocol</code></em>,
 
2520
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2521
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
2522
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
2523
<h3 class="title">Warning</h3>
 
2524
<p><code class="literal">tp_cli_connection_run_get_protocol</code> is deprecated and should not be used in newly-written code.</p>
 
2525
</div>
2039
2526
<p>
2040
2527
Call the method GetProtocol and run the main loop
2041
2528
until it returns. Before calling this method, you must
2044
2531
state.
2045
2532
</p>
2046
2533
<p>
2047
 
Get the protocol this connection is using.</p>
 
2534
Get the protocol this connection is using.
 
2535
</p>
2048
2536
<div class="variablelist"><table border="0">
2049
2537
<col align="left" valign="top">
2050
2538
<tbody>
2051
2539
<tr>
2052
2540
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2053
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2541
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2054
2542
</td>
2055
2543
</tr>
2056
2544
<tr>
2057
2545
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2058
 
<td> Timeout in milliseconds, or -1 for default
 
2546
<td>Timeout in milliseconds, or -1 for default
2059
2547
</td>
2060
2548
</tr>
2061
2549
<tr>
2062
2550
<td><p><span class="term"><em class="parameter"><code>out_Protocol</code></em> :</span></p></td>
2063
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: A string identifier for the protocol
 
2551
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: A string identifier for the protocol
2064
2552
</td>
2065
2553
</tr>
2066
2554
<tr>
2067
2555
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2068
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2556
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2069
2557
 is returned
2070
2558
</td>
2071
2559
</tr>
2072
2560
<tr>
2073
2561
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2074
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2075
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2562
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2563
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2076
2564
 which can be used to cancel this call with 
2077
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2078
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2565
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2566
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2079
2567
</td>
2080
2568
</tr>
2081
2569
<tr>
2090
2578
<div class="refsect2" title="tp_cli_connection_callback_for_get_self_handle ()">
2091
2579
<a name="tp-cli-connection-callback-for-get-self-handle"></a><h3>tp_cli_connection_callback_for_get_self_handle ()</h3>
2092
2580
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_get_self_handle)
2093
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2094
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> out_Self_Handle,
2095
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
2096
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2097
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2581
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2582
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> out_Self_Handle</code></em>,
 
2583
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2584
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2585
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2098
2586
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2099
2587
<h3 class="title">Warning</h3>
2100
2588
<p><code class="literal">tp_cli_connection_callback_for_get_self_handle</code> is deprecated and should not be used in newly-written code. Use GetAll to get the         SelfHandle property (and all other Connection properties)         instead.</p>
2101
2589
</div>
2102
2590
<p>
2103
2591
Signature of the callback called when a GetSelfHandle method call
2104
 
succeeds or fails.</p>
 
2592
succeeds or fails.
 
2593
</p>
2105
2594
<div class="variablelist"><table border="0">
2106
2595
<col align="left" valign="top">
2107
2596
<tbody>
2108
2597
<tr>
2109
2598
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2110
 
<td> the proxy on which the call was made
 
2599
<td>the proxy on which the call was made
2111
2600
</td>
2112
2601
</tr>
2113
2602
<tr>
2114
2603
<td><p><span class="term"><em class="parameter"><code>out_Self_Handle</code></em> :</span></p></td>
2115
 
<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>: The value of the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property
 
2604
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The value of the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property
2116
2605
</td>
2117
2606
</tr>
2118
2607
<tr>
2119
2608
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2120
 
<td> <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
 
2609
<td>
 
2610
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
2121
2611
</td>
2122
2612
</tr>
2123
2613
<tr>
2124
2614
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2125
 
<td> user-supplied data
 
2615
<td>user-supplied data
2126
2616
</td>
2127
2617
</tr>
2128
2618
<tr>
2129
2619
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2130
 
<td> user-supplied object
 
2620
<td>user-supplied object
2131
2621
</td>
2132
2622
</tr>
2133
2623
</tbody>
2137
2627
<div class="refsect2" title="tp_cli_connection_call_get_self_handle ()">
2138
2628
<a name="tp-cli-connection-call-get-self-handle"></a><h3>tp_cli_connection_call_get_self_handle ()</h3>
2139
2629
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_get_self_handle
2140
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2141
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2142
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()"><span class="returnvalue">tp_cli_connection_callback_for_get_self_handle</span></a> callback,
2143
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2144
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
2145
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2630
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2631
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2632
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-self-handle" title="tp_cli_connection_callback_for_get_self_handle ()"><span class="type">tp_cli_connection_callback_for_get_self_handle</span></a> callback</code></em>,
 
2633
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2634
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2635
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2146
2636
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2147
2637
<h3 class="title">Warning</h3>
2148
2638
<p><code class="literal">tp_cli_connection_call_get_self_handle</code> is deprecated and should not be used in newly-written code. Use GetAll to get the         SelfHandle property (and all other Connection properties)         instead.</p>
2151
2641
Start a GetSelfHandle method call.
2152
2642
</p>
2153
2643
<p>
2154
 
Returns the value of the SelfHandle property. Change notification         is via the SelfHandleChanged signal.</p>
 
2644
Returns the value of the SelfHandle property. Change notification         is via the SelfHandleChanged signal.
 
2645
</p>
2155
2646
<div class="variablelist"><table border="0">
2156
2647
<col align="left" valign="top">
2157
2648
<tbody>
2158
2649
<tr>
2159
2650
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2160
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2651
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
2161
2652
</td>
2162
2653
</tr>
2163
2654
<tr>
2164
2655
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2165
 
<td> the timeout in milliseconds, or -1 to use the
 
2656
<td>the timeout in milliseconds, or -1 to use the
2166
2657
  default
2167
2658
</td>
2168
2659
</tr>
2169
2660
<tr>
2170
2661
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2171
 
<td> called when the method call succeeds or fails;
2172
 
  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 
 
2662
<td>called when the method call succeeds or fails;
 
2663
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
2173
2664
  reply tracking
2174
2665
</td>
2175
2666
</tr>
2176
2667
<tr>
2177
2668
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2178
 
<td> user-supplied data passed to the callback;
2179
 
  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>
 
2669
<td>user-supplied data passed to the callback;
 
2670
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2180
2671
</td>
2181
2672
</tr>
2182
2673
<tr>
2183
2674
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2184
 
<td> called with the user_data as argument, after the
 
2675
<td>called with the user_data as argument, after the
2185
2676
  call has succeeded, failed or been cancelled;
2186
 
  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>
 
2677
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2187
2678
</td>
2188
2679
</tr>
2189
2680
<tr>
2190
2681
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2191
 
<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 
 
2682
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2192
2683
  weakly referenced; if it is destroyed, this call 
2193
 
  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 
2194
 
  <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>
 
2684
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2685
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2195
2686
</td>
2196
2687
</tr>
2197
2688
<tr>
2209
2700
<hr>
2210
2701
<div class="refsect2" title="tp_cli_connection_run_get_self_handle ()">
2211
2702
<a name="tp-cli-connection-run-get-self-handle"></a><h3>tp_cli_connection_run_get_self_handle ()</h3>
2212
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_self_handle
2213
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2214
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2215
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *out_Self_Handle,
2216
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2217
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2703
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_self_handle
 
2704
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2705
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2706
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *out_Self_Handle</code></em>,
 
2707
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2708
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
2218
2709
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2219
2710
<h3 class="title">Warning</h3>
2220
2711
<p><code class="literal">tp_cli_connection_run_get_self_handle</code> is deprecated and should not be used in newly-written code. Use GetAll to get the         SelfHandle property (and all other Connection properties)         instead.</p>
2227
2718
state.
2228
2719
</p>
2229
2720
<p>
2230
 
Returns the value of the SelfHandle property. Change notification         is via the SelfHandleChanged signal.</p>
 
2721
Returns the value of the SelfHandle property. Change notification         is via the SelfHandleChanged signal.
 
2722
</p>
2231
2723
<div class="variablelist"><table border="0">
2232
2724
<col align="left" valign="top">
2233
2725
<tbody>
2234
2726
<tr>
2235
2727
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2236
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2728
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2237
2729
</td>
2238
2730
</tr>
2239
2731
<tr>
2240
2732
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2241
 
<td> Timeout in milliseconds, or -1 for default
 
2733
<td>Timeout in milliseconds, or -1 for default
2242
2734
</td>
2243
2735
</tr>
2244
2736
<tr>
2245
2737
<td><p><span class="term"><em class="parameter"><code>out_Self_Handle</code></em> :</span></p></td>
2246
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The value of the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property
 
2738
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The value of the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property
2247
2739
</td>
2248
2740
</tr>
2249
2741
<tr>
2250
2742
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2251
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2743
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2252
2744
 is returned
2253
2745
</td>
2254
2746
</tr>
2255
2747
<tr>
2256
2748
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2257
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2258
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2749
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2750
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2259
2751
 which can be used to cancel this call with 
2260
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2261
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2752
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2753
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2262
2754
</td>
2263
2755
</tr>
2264
2756
<tr>
2274
2766
<div class="refsect2" title="tp_cli_connection_callback_for_get_status ()">
2275
2767
<a name="tp-cli-connection-callback-for-get-status"></a><h3>tp_cli_connection_callback_for_get_status ()</h3>
2276
2768
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_get_status)
2277
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2278
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> out_Status,
2279
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
2280
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2281
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2769
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2770
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> out_Status</code></em>,
 
2771
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2772
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2773
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2282
2774
<p>
2283
2775
Signature of the callback called when a GetStatus method call
2284
 
succeeds or fails.</p>
 
2776
succeeds or fails.
 
2777
</p>
2285
2778
<div class="variablelist"><table border="0">
2286
2779
<col align="left" valign="top">
2287
2780
<tbody>
2288
2781
<tr>
2289
2782
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2290
 
<td> the proxy on which the call was made
 
2783
<td>the proxy on which the call was made
2291
2784
</td>
2292
2785
</tr>
2293
2786
<tr>
2294
2787
<td><p><span class="term"><em class="parameter"><code>out_Status</code></em> :</span></p></td>
2295
 
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An integer representing the current status
 
2788
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The value of the &lt;tp:member-ref&gt;Status&lt;/tp:member-ref&gt; property
2296
2789
</td>
2297
2790
</tr>
2298
2791
<tr>
2299
2792
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2300
 
<td> <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
 
2793
<td>
 
2794
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
2301
2795
</td>
2302
2796
</tr>
2303
2797
<tr>
2304
2798
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2305
 
<td> user-supplied data
 
2799
<td>user-supplied data
2306
2800
</td>
2307
2801
</tr>
2308
2802
<tr>
2309
2803
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2310
 
<td> user-supplied object
 
2804
<td>user-supplied object
2311
2805
</td>
2312
2806
</tr>
2313
2807
</tbody>
2316
2810
<hr>
2317
2811
<div class="refsect2" title="tp_cli_connection_call_get_status ()">
2318
2812
<a name="tp-cli-connection-call-get-status"></a><h3>tp_cli_connection_call_get_status ()</h3>
2319
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_get_status  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2320
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2321
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()"><span class="returnvalue">tp_cli_connection_callback_for_get_status</span></a> callback,
2322
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2323
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
2324
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2813
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_get_status  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2814
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2815
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-get-status" title="tp_cli_connection_callback_for_get_status ()"><span class="type">tp_cli_connection_callback_for_get_status</span></a> callback</code></em>,
 
2816
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2817
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2818
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2325
2819
<p>
2326
2820
Start a GetStatus method call.
2327
2821
</p>
2328
2822
<p>
2329
 
Get the current status as defined in the         &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal.</p>
 
2823
Get the current status as defined in the         &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal.
 
2824
</p>
2330
2825
<div class="variablelist"><table border="0">
2331
2826
<col align="left" valign="top">
2332
2827
<tbody>
2333
2828
<tr>
2334
2829
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2335
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2830
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
2336
2831
</td>
2337
2832
</tr>
2338
2833
<tr>
2339
2834
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2340
 
<td> the timeout in milliseconds, or -1 to use the
 
2835
<td>the timeout in milliseconds, or -1 to use the
2341
2836
  default
2342
2837
</td>
2343
2838
</tr>
2344
2839
<tr>
2345
2840
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2346
 
<td> called when the method call succeeds or fails;
2347
 
  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 
 
2841
<td>called when the method call succeeds or fails;
 
2842
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
2348
2843
  reply tracking
2349
2844
</td>
2350
2845
</tr>
2351
2846
<tr>
2352
2847
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2353
 
<td> user-supplied data passed to the callback;
2354
 
  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>
 
2848
<td>user-supplied data passed to the callback;
 
2849
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2355
2850
</td>
2356
2851
</tr>
2357
2852
<tr>
2358
2853
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2359
 
<td> called with the user_data as argument, after the
 
2854
<td>called with the user_data as argument, after the
2360
2855
  call has succeeded, failed or been cancelled;
2361
 
  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>
 
2856
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2362
2857
</td>
2363
2858
</tr>
2364
2859
<tr>
2365
2860
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2366
 
<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 
 
2861
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2367
2862
  weakly referenced; if it is destroyed, this call 
2368
 
  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 
2369
 
  <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>
 
2863
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2864
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2370
2865
</td>
2371
2866
</tr>
2372
2867
<tr>
2383
2878
<hr>
2384
2879
<div class="refsect2" title="tp_cli_connection_run_get_status ()">
2385
2880
<a name="tp-cli-connection-run-get-status"></a><h3>tp_cli_connection_run_get_status ()</h3>
2386
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_status    (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2387
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2388
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *out_Status,
2389
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2390
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
2881
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_get_status    (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2882
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2883
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *out_Status</code></em>,
 
2884
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
2885
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
2886
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
2887
<h3 class="title">Warning</h3>
 
2888
<p><code class="literal">tp_cli_connection_run_get_status</code> is deprecated and should not be used in newly-written code.</p>
 
2889
</div>
2391
2890
<p>
2392
2891
Call the method GetStatus and run the main loop
2393
2892
until it returns. Before calling this method, you must
2396
2895
state.
2397
2896
</p>
2398
2897
<p>
2399
 
Get the current status as defined in the         &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal.</p>
 
2898
Get the current status as defined in the         &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal.
 
2899
</p>
2400
2900
<div class="variablelist"><table border="0">
2401
2901
<col align="left" valign="top">
2402
2902
<tbody>
2403
2903
<tr>
2404
2904
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2405
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
2905
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2406
2906
</td>
2407
2907
</tr>
2408
2908
<tr>
2409
2909
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2410
 
<td> Timeout in milliseconds, or -1 for default
 
2910
<td>Timeout in milliseconds, or -1 for default
2411
2911
</td>
2412
2912
</tr>
2413
2913
<tr>
2414
2914
<td><p><span class="term"><em class="parameter"><code>out_Status</code></em> :</span></p></td>
2415
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An integer representing the current status
 
2915
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The value of the &lt;tp:member-ref&gt;Status&lt;/tp:member-ref&gt; property
2416
2916
</td>
2417
2917
</tr>
2418
2918
<tr>
2419
2919
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2420
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2920
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2421
2921
 is returned
2422
2922
</td>
2423
2923
</tr>
2424
2924
<tr>
2425
2925
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2426
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2427
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
2926
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
2927
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2428
2928
 which can be used to cancel this call with 
2429
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2430
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
2929
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
2930
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2431
2931
</td>
2432
2932
</tr>
2433
2933
<tr>
2442
2942
<div class="refsect2" title="tp_cli_connection_callback_for_hold_handles ()">
2443
2943
<a name="tp-cli-connection-callback-for-hold-handles"></a><h3>tp_cli_connection_callback_for_hold_handles ()</h3>
2444
2944
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_hold_handles)
2445
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2446
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
2447
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2448
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2945
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2946
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2947
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2948
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2449
2949
<p>
2450
2950
Signature of the callback called when a HoldHandles method call
2451
 
succeeds or fails.</p>
 
2951
succeeds or fails.
 
2952
</p>
2452
2953
<div class="variablelist"><table border="0">
2453
2954
<col align="left" valign="top">
2454
2955
<tbody>
2455
2956
<tr>
2456
2957
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2457
 
<td> the proxy on which the call was made
 
2958
<td>the proxy on which the call was made
2458
2959
</td>
2459
2960
</tr>
2460
2961
<tr>
2461
2962
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2462
 
<td> <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
 
2963
<td>
 
2964
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
2463
2965
</td>
2464
2966
</tr>
2465
2967
<tr>
2466
2968
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2467
 
<td> user-supplied data
 
2969
<td>user-supplied data
2468
2970
</td>
2469
2971
</tr>
2470
2972
<tr>
2471
2973
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2472
 
<td> user-supplied object
 
2974
<td>user-supplied object
2473
2975
</td>
2474
2976
</tr>
2475
2977
</tbody>
2479
2981
<div class="refsect2" title="tp_cli_connection_call_hold_handles ()">
2480
2982
<a name="tp-cli-connection-call-hold-handles"></a><h3>tp_cli_connection_call_hold_handles ()</h3>
2481
2983
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_hold_handles
2482
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2483
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2484
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
2485
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
2486
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_hold_handles</span></a> callback,
2487
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2488
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
2489
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
2984
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
2985
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2986
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
2987
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
2988
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-hold-handles" title="tp_cli_connection_callback_for_hold_handles ()"><span class="type">tp_cli_connection_callback_for_hold_handles</span></a> callback</code></em>,
 
2989
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2990
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2991
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2490
2992
<p>
2491
2993
Start a HoldHandles method call.
2492
2994
</p>
2493
2995
<p>
2494
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Notify the connection manger that your client is holding a copy         of handles which may not be in use in any existing channel or         list, and were not obtained by using the         &lt;tp:member-ref&gt;RequestHandles&lt;/tp:member-ref&gt; method. For         example, a handle observed in an emitted signal, or displayed         somewhere in the UI that is not associated with a channel. The         connection manager must not deallocate a handle where any clients         have used this method to indicate it is in use until the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method is called, or the clients disappear from the bus.&lt;/p&gt;          &lt;p&gt;Note that HoldHandles is idempotent - calling it multiple times           is equivalent to calling it once. If a handle is &amp;quot;referenced&amp;quot; by           several components which share a D-Bus unique name, the client           should perform reference counting internally, and only call           ReleaseHandles when none of the cooperating components need the           handle any longer.&lt;/p&gt;</p>
 
2996
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Notify the connection manger that your client is holding a copy         of handles which may not be in use in any existing channel or         list, and were not obtained by using the         &lt;tp:member-ref&gt;RequestHandles&lt;/tp:member-ref&gt; method. For         example, a handle observed in an emitted signal, or displayed         somewhere in the UI that is not associated with a channel. The         connection manager must not deallocate a handle where any clients         have used this method to indicate it is in use until the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method is called, or the clients disappear from the bus.&lt;/p&gt;          &lt;p&gt;Note that HoldHandles is idempotent - calling it multiple times           is equivalent to calling it once. If a handle is &amp;quot;referenced&amp;quot; by           several components which share a D-Bus unique name, the client           should perform reference counting internally, and only call           ReleaseHandles when none of the cooperating components need the           handle any longer.&lt;/p&gt;
 
2997
</p>
2495
2998
<div class="variablelist"><table border="0">
2496
2999
<col align="left" valign="top">
2497
3000
<tbody>
2498
3001
<tr>
2499
3002
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2500
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
3003
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
2501
3004
</td>
2502
3005
</tr>
2503
3006
<tr>
2504
3007
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2505
 
<td> the timeout in milliseconds, or -1 to use the
 
3008
<td>the timeout in milliseconds, or -1 to use the
2506
3009
  default
2507
3010
</td>
2508
3011
</tr>
2509
3012
<tr>
2510
3013
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2511
 
<td> Used to pass an 'in' argument: The type of handle to be held
 
3014
<td>Used to pass an 'in' argument: The type of handle to be held
2512
3015
</td>
2513
3016
</tr>
2514
3017
<tr>
2515
3018
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2516
 
<td> Used to pass an 'in' argument: A array of integer handles to hold
 
3019
<td>Used to pass an 'in' argument: A array of integer handles to hold
2517
3020
</td>
2518
3021
</tr>
2519
3022
<tr>
2520
3023
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2521
 
<td> called when the method call succeeds or fails;
2522
 
  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 
 
3024
<td>called when the method call succeeds or fails;
 
3025
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
2523
3026
  reply tracking
2524
3027
</td>
2525
3028
</tr>
2526
3029
<tr>
2527
3030
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2528
 
<td> user-supplied data passed to the callback;
2529
 
  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>
 
3031
<td>user-supplied data passed to the callback;
 
3032
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2530
3033
</td>
2531
3034
</tr>
2532
3035
<tr>
2533
3036
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2534
 
<td> called with the user_data as argument, after the
 
3037
<td>called with the user_data as argument, after the
2535
3038
  call has succeeded, failed or been cancelled;
2536
 
  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>
 
3039
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2537
3040
</td>
2538
3041
</tr>
2539
3042
<tr>
2540
3043
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2541
 
<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 
 
3044
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2542
3045
  weakly referenced; if it is destroyed, this call 
2543
 
  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 
2544
 
  <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>
 
3046
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
3047
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2545
3048
</td>
2546
3049
</tr>
2547
3050
<tr>
2558
3061
<hr>
2559
3062
<div class="refsect2" title="tp_cli_connection_run_hold_handles ()">
2560
3063
<a name="tp-cli-connection-run-hold-handles"></a><h3>tp_cli_connection_run_hold_handles ()</h3>
2561
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_hold_handles  (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2562
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2563
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
2564
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
2565
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2566
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
3064
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_hold_handles  (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3065
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3066
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3067
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
3068
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
3069
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
3070
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
3071
<h3 class="title">Warning</h3>
 
3072
<p><code class="literal">tp_cli_connection_run_hold_handles</code> is deprecated and should not be used in newly-written code.</p>
 
3073
</div>
2567
3074
<p>
2568
3075
Call the method HoldHandles and run the main loop
2569
3076
until it returns. Before calling this method, you must
2572
3079
state.
2573
3080
</p>
2574
3081
<p>
2575
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Notify the connection manger that your client is holding a copy         of handles which may not be in use in any existing channel or         list, and were not obtained by using the         &lt;tp:member-ref&gt;RequestHandles&lt;/tp:member-ref&gt; method. For         example, a handle observed in an emitted signal, or displayed         somewhere in the UI that is not associated with a channel. The         connection manager must not deallocate a handle where any clients         have used this method to indicate it is in use until the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method is called, or the clients disappear from the bus.&lt;/p&gt;          &lt;p&gt;Note that HoldHandles is idempotent - calling it multiple times           is equivalent to calling it once. If a handle is &amp;quot;referenced&amp;quot; by           several components which share a D-Bus unique name, the client           should perform reference counting internally, and only call           ReleaseHandles when none of the cooperating components need the           handle any longer.&lt;/p&gt;</p>
 
3082
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Notify the connection manger that your client is holding a copy         of handles which may not be in use in any existing channel or         list, and were not obtained by using the         &lt;tp:member-ref&gt;RequestHandles&lt;/tp:member-ref&gt; method. For         example, a handle observed in an emitted signal, or displayed         somewhere in the UI that is not associated with a channel. The         connection manager must not deallocate a handle where any clients         have used this method to indicate it is in use until the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method is called, or the clients disappear from the bus.&lt;/p&gt;          &lt;p&gt;Note that HoldHandles is idempotent - calling it multiple times           is equivalent to calling it once. If a handle is &amp;quot;referenced&amp;quot; by           several components which share a D-Bus unique name, the client           should perform reference counting internally, and only call           ReleaseHandles when none of the cooperating components need the           handle any longer.&lt;/p&gt;
 
3083
</p>
2576
3084
<div class="variablelist"><table border="0">
2577
3085
<col align="left" valign="top">
2578
3086
<tbody>
2579
3087
<tr>
2580
3088
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2581
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
3089
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2582
3090
</td>
2583
3091
</tr>
2584
3092
<tr>
2585
3093
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2586
 
<td> Timeout in milliseconds, or -1 for default
 
3094
<td>Timeout in milliseconds, or -1 for default
2587
3095
</td>
2588
3096
</tr>
2589
3097
<tr>
2590
3098
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2591
 
<td> Used to pass an 'in' argument: The type of handle to be held
 
3099
<td>Used to pass an 'in' argument: The type of handle to be held
2592
3100
</td>
2593
3101
</tr>
2594
3102
<tr>
2595
3103
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2596
 
<td> Used to pass an 'in' argument: A array of integer handles to hold
 
3104
<td>Used to pass an 'in' argument: A array of integer handles to hold
2597
3105
</td>
2598
3106
</tr>
2599
3107
<tr>
2600
3108
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2601
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
3109
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2602
3110
 is returned
2603
3111
</td>
2604
3112
</tr>
2605
3113
<tr>
2606
3114
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2607
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2608
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
3115
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
3116
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2609
3117
 which can be used to cancel this call with 
2610
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2611
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
3118
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
3119
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2612
3120
</td>
2613
3121
</tr>
2614
3122
<tr>
2623
3131
<div class="refsect2" title="tp_cli_connection_callback_for_inspect_handles ()">
2624
3132
<a name="tp-cli-connection-callback-for-inspect-handles"></a><h3>tp_cli_connection_callback_for_inspect_handles ()</h3>
2625
3133
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_inspect_handles)
2626
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2627
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Identifiers,
2628
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
2629
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2630
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3134
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3135
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Identifiers</code></em>,
 
3136
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
3137
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3138
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2631
3139
<p>
2632
3140
Signature of the callback called when a InspectHandles method call
2633
 
succeeds or fails.</p>
 
3141
succeeds or fails.
 
3142
</p>
2634
3143
<div class="variablelist"><table border="0">
2635
3144
<col align="left" valign="top">
2636
3145
<tbody>
2637
3146
<tr>
2638
3147
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2639
 
<td> the proxy on which the call was made
 
3148
<td>the proxy on which the call was made
2640
3149
</td>
2641
3150
</tr>
2642
3151
<tr>
2643
3152
<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
2644
 
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of identifiers corresponding to the given handles, in the same order.
 
3153
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of identifiers corresponding to the given handles, in the same order.
2645
3154
</td>
2646
3155
</tr>
2647
3156
<tr>
2648
3157
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2649
 
<td> <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
 
3158
<td>
 
3159
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
2650
3160
</td>
2651
3161
</tr>
2652
3162
<tr>
2653
3163
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2654
 
<td> user-supplied data
 
3164
<td>user-supplied data
2655
3165
</td>
2656
3166
</tr>
2657
3167
<tr>
2658
3168
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2659
 
<td> user-supplied object
 
3169
<td>user-supplied object
2660
3170
</td>
2661
3171
</tr>
2662
3172
</tbody>
2666
3176
<div class="refsect2" title="tp_cli_connection_call_inspect_handles ()">
2667
3177
<a name="tp-cli-connection-call-inspect-handles"></a><h3>tp_cli_connection_call_inspect_handles ()</h3>
2668
3178
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_inspect_handles
2669
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2670
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2671
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
2672
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
2673
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_inspect_handles</span></a> callback,
2674
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2675
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
2676
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3179
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3180
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3181
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3182
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
3183
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-inspect-handles" title="tp_cli_connection_callback_for_inspect_handles ()"><span class="type">tp_cli_connection_callback_for_inspect_handles</span></a> callback</code></em>,
 
3184
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3185
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
3186
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2677
3187
<p>
2678
3188
Start a InspectHandles method call.
2679
3189
</p>
2680
3190
<p>
2681
 
Return a string representation for a number of handles of a given         type.</p>
 
3191
Return a string representation for a number of handles of a given         type.
 
3192
</p>
2682
3193
<div class="variablelist"><table border="0">
2683
3194
<col align="left" valign="top">
2684
3195
<tbody>
2685
3196
<tr>
2686
3197
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2687
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
3198
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
2688
3199
</td>
2689
3200
</tr>
2690
3201
<tr>
2691
3202
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2692
 
<td> the timeout in milliseconds, or -1 to use the
 
3203
<td>the timeout in milliseconds, or -1 to use the
2693
3204
  default
2694
3205
</td>
2695
3206
</tr>
2696
3207
<tr>
2697
3208
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2698
 
<td> Used to pass an 'in' argument: The type of handle to be inspected
 
3209
<td>Used to pass an 'in' argument: The type of handle to be inspected
2699
3210
</td>
2700
3211
</tr>
2701
3212
<tr>
2702
3213
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2703
 
<td> Used to pass an 'in' argument: An array of integer handles of this type
 
3214
<td>Used to pass an 'in' argument: An array of integer handles of this type
2704
3215
</td>
2705
3216
</tr>
2706
3217
<tr>
2707
3218
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2708
 
<td> called when the method call succeeds or fails;
2709
 
  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 
 
3219
<td>called when the method call succeeds or fails;
 
3220
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
2710
3221
  reply tracking
2711
3222
</td>
2712
3223
</tr>
2713
3224
<tr>
2714
3225
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2715
 
<td> user-supplied data passed to the callback;
2716
 
  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>
 
3226
<td>user-supplied data passed to the callback;
 
3227
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2717
3228
</td>
2718
3229
</tr>
2719
3230
<tr>
2720
3231
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2721
 
<td> called with the user_data as argument, after the
 
3232
<td>called with the user_data as argument, after the
2722
3233
  call has succeeded, failed or been cancelled;
2723
 
  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>
 
3234
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2724
3235
</td>
2725
3236
</tr>
2726
3237
<tr>
2727
3238
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2728
 
<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 
 
3239
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2729
3240
  weakly referenced; if it is destroyed, this call 
2730
 
  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 
2731
 
  <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>
 
3241
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
3242
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2732
3243
</td>
2733
3244
</tr>
2734
3245
<tr>
2745
3256
<hr>
2746
3257
<div class="refsect2" title="tp_cli_connection_run_inspect_handles ()">
2747
3258
<a name="tp-cli-connection-run-inspect-handles"></a><h3>tp_cli_connection_run_inspect_handles ()</h3>
2748
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_inspect_handles
2749
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2750
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2751
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
2752
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
2753
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ***out_Identifiers,
2754
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2755
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
3259
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_inspect_handles
 
3260
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3261
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3262
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3263
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
3264
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***out_Identifiers</code></em>,
 
3265
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
3266
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
3267
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
3268
<h3 class="title">Warning</h3>
 
3269
<p><code class="literal">tp_cli_connection_run_inspect_handles</code> is deprecated and should not be used in newly-written code.</p>
 
3270
</div>
2756
3271
<p>
2757
3272
Call the method InspectHandles and run the main loop
2758
3273
until it returns. Before calling this method, you must
2761
3276
state.
2762
3277
</p>
2763
3278
<p>
2764
 
Return a string representation for a number of handles of a given         type.</p>
 
3279
Return a string representation for a number of handles of a given         type.
 
3280
</p>
2765
3281
<div class="variablelist"><table border="0">
2766
3282
<col align="left" valign="top">
2767
3283
<tbody>
2768
3284
<tr>
2769
3285
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2770
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
3286
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2771
3287
</td>
2772
3288
</tr>
2773
3289
<tr>
2774
3290
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2775
 
<td> Timeout in milliseconds, or -1 for default
 
3291
<td>Timeout in milliseconds, or -1 for default
2776
3292
</td>
2777
3293
</tr>
2778
3294
<tr>
2779
3295
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
2780
 
<td> Used to pass an 'in' argument: The type of handle to be inspected
 
3296
<td>Used to pass an 'in' argument: The type of handle to be inspected
2781
3297
</td>
2782
3298
</tr>
2783
3299
<tr>
2784
3300
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
2785
 
<td> Used to pass an 'in' argument: An array of integer handles of this type
 
3301
<td>Used to pass an 'in' argument: An array of integer handles of this type
2786
3302
</td>
2787
3303
</tr>
2788
3304
<tr>
2789
3305
<td><p><span class="term"><em class="parameter"><code>out_Identifiers</code></em> :</span></p></td>
2790
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of identifiers corresponding to the given handles, in the same order.
 
3306
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of identifiers corresponding to the given handles, in the same order.
2791
3307
</td>
2792
3308
</tr>
2793
3309
<tr>
2794
3310
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2795
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
3311
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2796
3312
 is returned
2797
3313
</td>
2798
3314
</tr>
2799
3315
<tr>
2800
3316
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2801
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2802
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
3317
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
3318
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2803
3319
 which can be used to cancel this call with 
2804
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2805
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
3320
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
3321
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2806
3322
</td>
2807
3323
</tr>
2808
3324
<tr>
2817
3333
<div class="refsect2" title="tp_cli_connection_callback_for_list_channels ()">
2818
3334
<a name="tp-cli-connection-callback-for-list-channels"></a><h3>tp_cli_connection_callback_for_list_channels ()</h3>
2819
3335
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_list_channels)
2820
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2821
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *out_Channel_Info,
2822
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
2823
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2824
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3336
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3337
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *out_Channel_Info</code></em>,
 
3338
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
3339
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3340
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2825
3341
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2826
3342
<h3 class="title">Warning</h3>
2827
3343
<p><code class="literal">tp_cli_connection_callback_for_list_channels</code> is deprecated and should not be used in newly-written code. Use the Requests.Channels property instead.</p>
2828
3344
</div>
2829
3345
<p>
2830
3346
Signature of the callback called when a ListChannels method call
2831
 
succeeds or fails.</p>
 
3347
succeeds or fails.
 
3348
</p>
2832
3349
<div class="variablelist"><table border="0">
2833
3350
<col align="left" valign="top">
2834
3351
<tbody>
2835
3352
<tr>
2836
3353
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2837
 
<td> the proxy on which the call was made
 
3354
<td>the proxy on which the call was made
2838
3355
</td>
2839
3356
</tr>
2840
3357
<tr>
2841
3358
<td><p><span class="term"><em class="parameter"><code>out_Channel_Info</code></em> :</span></p></td>
2842
 
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of structs representing channels.
 
3359
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of structs representing channels.
2843
3360
</td>
2844
3361
</tr>
2845
3362
<tr>
2846
3363
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2847
 
<td> <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
 
3364
<td>
 
3365
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
2848
3366
</td>
2849
3367
</tr>
2850
3368
<tr>
2851
3369
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2852
 
<td> user-supplied data
 
3370
<td>user-supplied data
2853
3371
</td>
2854
3372
</tr>
2855
3373
<tr>
2856
3374
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2857
 
<td> user-supplied object
 
3375
<td>user-supplied object
2858
3376
</td>
2859
3377
</tr>
2860
3378
</tbody>
2864
3382
<div class="refsect2" title="tp_cli_connection_call_list_channels ()">
2865
3383
<a name="tp-cli-connection-call-list-channels"></a><h3>tp_cli_connection_call_list_channels ()</h3>
2866
3384
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_list_channels
2867
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2868
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2869
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()"><span class="returnvalue">tp_cli_connection_callback_for_list_channels</span></a> callback,
2870
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
2871
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
2872
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3385
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3386
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3387
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-list-channels" title="tp_cli_connection_callback_for_list_channels ()"><span class="type">tp_cli_connection_callback_for_list_channels</span></a> callback</code></em>,
 
3388
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3389
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
3390
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
2873
3391
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2874
3392
<h3 class="title">Warning</h3>
2875
3393
<p><code class="literal">tp_cli_connection_call_list_channels</code> is deprecated and should not be used in newly-written code. Use the Requests.Channels property instead.</p>
2878
3396
Start a ListChannels method call.
2879
3397
</p>
2880
3398
<p>
2881
 
List all the channels which currently exist on this connection.</p>
 
3399
List all the channels which currently exist on this connection.
 
3400
</p>
2882
3401
<div class="variablelist"><table border="0">
2883
3402
<col align="left" valign="top">
2884
3403
<tbody>
2885
3404
<tr>
2886
3405
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2887
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
3406
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
2888
3407
</td>
2889
3408
</tr>
2890
3409
<tr>
2891
3410
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2892
 
<td> the timeout in milliseconds, or -1 to use the
 
3411
<td>the timeout in milliseconds, or -1 to use the
2893
3412
  default
2894
3413
</td>
2895
3414
</tr>
2896
3415
<tr>
2897
3416
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
2898
 
<td> called when the method call succeeds or fails;
2899
 
  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 
 
3417
<td>called when the method call succeeds or fails;
 
3418
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
2900
3419
  reply tracking
2901
3420
</td>
2902
3421
</tr>
2903
3422
<tr>
2904
3423
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2905
 
<td> user-supplied data passed to the callback;
2906
 
  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>
 
3424
<td>user-supplied data passed to the callback;
 
3425
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2907
3426
</td>
2908
3427
</tr>
2909
3428
<tr>
2910
3429
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2911
 
<td> called with the user_data as argument, after the
 
3430
<td>called with the user_data as argument, after the
2912
3431
  call has succeeded, failed or been cancelled;
2913
 
  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>
 
3432
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2914
3433
</td>
2915
3434
</tr>
2916
3435
<tr>
2917
3436
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
2918
 
<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 
 
3437
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
2919
3438
  weakly referenced; if it is destroyed, this call 
2920
 
  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 
2921
 
  <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>
 
3439
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
3440
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2922
3441
</td>
2923
3442
</tr>
2924
3443
<tr>
2936
3455
<hr>
2937
3456
<div class="refsect2" title="tp_cli_connection_run_list_channels ()">
2938
3457
<a name="tp-cli-connection-run-list-channels"></a><h3>tp_cli_connection_run_list_channels ()</h3>
2939
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_list_channels (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
2940
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
2941
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> **out_Channel_Info,
2942
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
2943
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
3458
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_list_channels (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3459
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3460
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> **out_Channel_Info</code></em>,
 
3461
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
3462
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
2944
3463
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2945
3464
<h3 class="title">Warning</h3>
2946
3465
<p><code class="literal">tp_cli_connection_run_list_channels</code> is deprecated and should not be used in newly-written code. Use the Requests.Channels property instead.</p>
2953
3472
state.
2954
3473
</p>
2955
3474
<p>
2956
 
List all the channels which currently exist on this connection.</p>
 
3475
List all the channels which currently exist on this connection.
 
3476
</p>
2957
3477
<div class="variablelist"><table border="0">
2958
3478
<col align="left" valign="top">
2959
3479
<tbody>
2960
3480
<tr>
2961
3481
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
2962
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
3482
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
2963
3483
</td>
2964
3484
</tr>
2965
3485
<tr>
2966
3486
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
2967
 
<td> Timeout in milliseconds, or -1 for default
 
3487
<td>Timeout in milliseconds, or -1 for default
2968
3488
</td>
2969
3489
</tr>
2970
3490
<tr>
2971
3491
<td><p><span class="term"><em class="parameter"><code>out_Channel_Info</code></em> :</span></p></td>
2972
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of structs representing channels.
 
3492
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of structs representing channels.
2973
3493
</td>
2974
3494
</tr>
2975
3495
<tr>
2976
3496
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2977
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
3497
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2978
3498
 is returned
2979
3499
</td>
2980
3500
</tr>
2981
3501
<tr>
2982
3502
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
2983
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
2984
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
3503
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
3504
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
2985
3505
 which can be used to cancel this call with 
2986
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
2987
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
3506
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
3507
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
2988
3508
</td>
2989
3509
</tr>
2990
3510
<tr>
3000
3520
<div class="refsect2" title="tp_cli_connection_callback_for_release_handles ()">
3001
3521
<a name="tp-cli-connection-callback-for-release-handles"></a><h3>tp_cli_connection_callback_for_release_handles ()</h3>
3002
3522
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_release_handles)
3003
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3004
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
3005
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3006
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3523
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3524
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
3525
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3526
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3007
3527
<p>
3008
3528
Signature of the callback called when a ReleaseHandles method call
3009
 
succeeds or fails.</p>
 
3529
succeeds or fails.
 
3530
</p>
3010
3531
<div class="variablelist"><table border="0">
3011
3532
<col align="left" valign="top">
3012
3533
<tbody>
3013
3534
<tr>
3014
3535
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3015
 
<td> the proxy on which the call was made
 
3536
<td>the proxy on which the call was made
3016
3537
</td>
3017
3538
</tr>
3018
3539
<tr>
3019
3540
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3020
 
<td> <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
 
3541
<td>
 
3542
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
3021
3543
</td>
3022
3544
</tr>
3023
3545
<tr>
3024
3546
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3025
 
<td> user-supplied data
 
3547
<td>user-supplied data
3026
3548
</td>
3027
3549
</tr>
3028
3550
<tr>
3029
3551
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3030
 
<td> user-supplied object
 
3552
<td>user-supplied object
3031
3553
</td>
3032
3554
</tr>
3033
3555
</tbody>
3037
3559
<div class="refsect2" title="tp_cli_connection_call_release_handles ()">
3038
3560
<a name="tp-cli-connection-call-release-handles"></a><h3>tp_cli_connection_call_release_handles ()</h3>
3039
3561
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_release_handles
3040
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3041
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3042
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3043
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
3044
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_release_handles</span></a> callback,
3045
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3046
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3047
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3562
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3563
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3564
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3565
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
3566
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-release-handles" title="tp_cli_connection_callback_for_release_handles ()"><span class="type">tp_cli_connection_callback_for_release_handles</span></a> callback</code></em>,
 
3567
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3568
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
3569
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3048
3570
<p>
3049
3571
Start a ReleaseHandles method call.
3050
3572
</p>
3051
3573
<p>
3052
 
Explicitly notify the connection manager that your client is no         longer holding any references to the given handles, and that they         may be deallocated if they are not held by any other clients or         referenced by any existing channels. See HoldHandles for notes.</p>
 
3574
Explicitly notify the connection manager that your client is no         longer holding any references to the given handles, and that they         may be deallocated if they are not held by any other clients or         referenced by any existing channels. See HoldHandles for notes.
 
3575
</p>
3053
3576
<div class="variablelist"><table border="0">
3054
3577
<col align="left" valign="top">
3055
3578
<tbody>
3056
3579
<tr>
3057
3580
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3058
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
3581
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3059
3582
</td>
3060
3583
</tr>
3061
3584
<tr>
3062
3585
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3063
 
<td> the timeout in milliseconds, or -1 to use the
 
3586
<td>the timeout in milliseconds, or -1 to use the
3064
3587
  default
3065
3588
</td>
3066
3589
</tr>
3067
3590
<tr>
3068
3591
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3069
 
<td> Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
 
3592
<td>Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
3070
3593
</td>
3071
3594
</tr>
3072
3595
<tr>
3073
3596
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3074
 
<td> Used to pass an 'in' argument: An array of integer handles being held by the client
 
3597
<td>Used to pass an 'in' argument: An array of integer handles being held by the client
3075
3598
</td>
3076
3599
</tr>
3077
3600
<tr>
3078
3601
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3079
 
<td> called when the method call succeeds or fails;
3080
 
  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 
 
3602
<td>called when the method call succeeds or fails;
 
3603
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
3081
3604
  reply tracking
3082
3605
</td>
3083
3606
</tr>
3084
3607
<tr>
3085
3608
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3086
 
<td> user-supplied data passed to the callback;
3087
 
  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>
 
3609
<td>user-supplied data passed to the callback;
 
3610
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3088
3611
</td>
3089
3612
</tr>
3090
3613
<tr>
3091
3614
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3092
 
<td> called with the user_data as argument, after the
 
3615
<td>called with the user_data as argument, after the
3093
3616
  call has succeeded, failed or been cancelled;
3094
 
  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>
 
3617
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3095
3618
</td>
3096
3619
</tr>
3097
3620
<tr>
3098
3621
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3099
 
<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 
 
3622
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
3100
3623
  weakly referenced; if it is destroyed, this call 
3101
 
  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 
3102
 
  <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>
 
3624
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
3625
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3103
3626
</td>
3104
3627
</tr>
3105
3628
<tr>
3116
3639
<hr>
3117
3640
<div class="refsect2" title="tp_cli_connection_run_release_handles ()">
3118
3641
<a name="tp-cli-connection-run-release-handles"></a><h3>tp_cli_connection_run_release_handles ()</h3>
3119
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_release_handles
3120
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3121
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3122
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3123
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *in_Handles,
3124
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
3125
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
3642
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_release_handles
 
3643
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3644
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3645
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3646
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Handles</code></em>,
 
3647
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
3648
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
3649
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
3650
<h3 class="title">Warning</h3>
 
3651
<p><code class="literal">tp_cli_connection_run_release_handles</code> is deprecated and should not be used in newly-written code.</p>
 
3652
</div>
3126
3653
<p>
3127
3654
Call the method ReleaseHandles and run the main loop
3128
3655
until it returns. Before calling this method, you must
3131
3658
state.
3132
3659
</p>
3133
3660
<p>
3134
 
Explicitly notify the connection manager that your client is no         longer holding any references to the given handles, and that they         may be deallocated if they are not held by any other clients or         referenced by any existing channels. See HoldHandles for notes.</p>
 
3661
Explicitly notify the connection manager that your client is no         longer holding any references to the given handles, and that they         may be deallocated if they are not held by any other clients or         referenced by any existing channels. See HoldHandles for notes.
 
3662
</p>
3135
3663
<div class="variablelist"><table border="0">
3136
3664
<col align="left" valign="top">
3137
3665
<tbody>
3138
3666
<tr>
3139
3667
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3140
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
3668
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3141
3669
</td>
3142
3670
</tr>
3143
3671
<tr>
3144
3672
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3145
 
<td> Timeout in milliseconds, or -1 for default
 
3673
<td>Timeout in milliseconds, or -1 for default
3146
3674
</td>
3147
3675
</tr>
3148
3676
<tr>
3149
3677
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3150
 
<td> Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
 
3678
<td>Used to pass an 'in' argument: An integer handle type (as defined in RequestHandle)
3151
3679
</td>
3152
3680
</tr>
3153
3681
<tr>
3154
3682
<td><p><span class="term"><em class="parameter"><code>in_Handles</code></em> :</span></p></td>
3155
 
<td> Used to pass an 'in' argument: An array of integer handles being held by the client
 
3683
<td>Used to pass an 'in' argument: An array of integer handles being held by the client
3156
3684
</td>
3157
3685
</tr>
3158
3686
<tr>
3159
3687
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3160
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
3688
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
3161
3689
 is returned
3162
3690
</td>
3163
3691
</tr>
3164
3692
<tr>
3165
3693
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3166
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
3167
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
3694
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
3695
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
3168
3696
 which can be used to cancel this call with 
3169
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
3170
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
3697
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
3698
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3171
3699
</td>
3172
3700
</tr>
3173
3701
<tr>
3182
3710
<div class="refsect2" title="tp_cli_connection_callback_for_request_channel ()">
3183
3711
<a name="tp-cli-connection-callback-for-request-channel"></a><h3>tp_cli_connection_callback_for_request_channel ()</h3>
3184
3712
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_request_channel)
3185
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3186
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *out_Object_Path,
3187
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
3188
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3189
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3713
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3714
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *out_Object_Path</code></em>,
 
3715
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
3716
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3717
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3190
3718
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
3191
3719
<h3 class="title">Warning</h3>
3192
3720
<p><code class="literal">tp_cli_connection_callback_for_request_channel</code> is deprecated and should not be used in newly-written code. Use Requests.CreateChannel or Requests.EnsureChannel instead. Connection managers MAY implement RequestChannel by         raising NotImplemented, or implement fewer types of channel via         this API.</p>
3193
3721
</div>
3194
3722
<p>
3195
3723
Signature of the callback called when a RequestChannel method call
3196
 
succeeds or fails.</p>
 
3724
succeeds or fails.
 
3725
</p>
3197
3726
<div class="variablelist"><table border="0">
3198
3727
<col align="left" valign="top">
3199
3728
<tbody>
3200
3729
<tr>
3201
3730
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3202
 
<td> the proxy on which the call was made
 
3731
<td>the proxy on which the call was made
3203
3732
</td>
3204
3733
</tr>
3205
3734
<tr>
3206
3735
<td><p><span class="term"><em class="parameter"><code>out_Object_Path</code></em> :</span></p></td>
3207
 
<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>: The D-Bus object path for the channel created or retrieved
 
3736
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The D-Bus object path for the channel created or retrieved
3208
3737
</td>
3209
3738
</tr>
3210
3739
<tr>
3211
3740
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3212
 
<td> <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
 
3741
<td>
 
3742
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
3213
3743
</td>
3214
3744
</tr>
3215
3745
<tr>
3216
3746
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3217
 
<td> user-supplied data
 
3747
<td>user-supplied data
3218
3748
</td>
3219
3749
</tr>
3220
3750
<tr>
3221
3751
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3222
 
<td> user-supplied object
 
3752
<td>user-supplied object
3223
3753
</td>
3224
3754
</tr>
3225
3755
</tbody>
3229
3759
<div class="refsect2" title="tp_cli_connection_call_request_channel ()">
3230
3760
<a name="tp-cli-connection-call-request-channel"></a><h3>tp_cli_connection_call_request_channel ()</h3>
3231
3761
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_request_channel
3232
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3233
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3234
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *in_Type,
3235
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3236
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle,
3237
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> in_Suppress_Handler,
3238
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()"><span class="returnvalue">tp_cli_connection_callback_for_request_channel</span></a> callback,
3239
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3240
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3241
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3762
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3763
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3764
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Type</code></em>,
 
3765
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3766
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle</code></em>,
 
3767
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Suppress_Handler</code></em>,
 
3768
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-channel" title="tp_cli_connection_callback_for_request_channel ()"><span class="type">tp_cli_connection_callback_for_request_channel</span></a> callback</code></em>,
 
3769
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3770
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
3771
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3242
3772
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
3243
3773
<h3 class="title">Warning</h3>
3244
3774
<p><code class="literal">tp_cli_connection_call_request_channel</code> is deprecated and should not be used in newly-written code. Use Requests.CreateChannel or Requests.EnsureChannel instead. Connection managers MAY implement RequestChannel by         raising NotImplemented, or implement fewer types of channel via         this API.</p>
3247
3777
Start a RequestChannel method call.
3248
3778
</p>
3249
3779
<p>
3250
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request a channel satisfying the specified type and communicating           with the contact, room, list etc. indicated by the given           handle_type and handle. The handle_type and handle may both be           zero to request the creation of a new, empty channel, which may           or may not be possible, depending on the protocol and channel           type.&lt;/p&gt;          &lt;p&gt;On success, the returned channel will always be of the requested           type (i.e. implement the requested channel-type interface).&lt;/p&gt;          &lt;p&gt;If a new, empty channel is requested, on success the returned           channel will always be an &amp;quot;anonymous&amp;quot; channel for which the type           and handle are both zero.&lt;/p&gt;          &lt;p&gt;If a channel to a contact, room etc. is requested, on success, the           returned channel may either be a new or existing channel to           the requested entity (i.e. its           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandleType&lt;/tp:dbus-ref&gt;           and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt;           properties are the           requested handle type and handle), or a newly created &amp;quot;anonymous&amp;quot;           channel associated with the requested handle in some           implementation-specific way.&lt;/p&gt;          &lt;p&gt;For example, for a contact handle, the returned channel           might be &amp;quot;anonymous&amp;quot;, but implement the groups interface and have           the requested contact already present among the members.&lt;/p&gt;          &lt;p&gt;If the request cannot be satisfied, an error is raised and no           channel is created.&lt;/p&gt;</p>
 
3780
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request a channel satisfying the specified type and communicating           with the contact, room, list etc. indicated by the given           handle_type and handle. The handle_type and handle may both be           zero to request the creation of a new, empty channel, which may           or may not be possible, depending on the protocol and channel           type.&lt;/p&gt;          &lt;p&gt;On success, the returned channel will always be of the requested           type (i.e. implement the requested channel-type interface).&lt;/p&gt;          &lt;p&gt;If a new, empty channel is requested, on success the returned           channel will always be an &amp;quot;anonymous&amp;quot; channel for which the type           and handle are both zero.&lt;/p&gt;          &lt;p&gt;If a channel to a contact, room etc. is requested, on success, the           returned channel may either be a new or existing channel to           the requested entity (i.e. its           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandleType&lt;/tp:dbus-ref&gt;           and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt;           properties are the           requested handle type and handle), or a newly created &amp;quot;anonymous&amp;quot;           channel associated with the requested handle in some           implementation-specific way.&lt;/p&gt;          &lt;p&gt;For example, for a contact handle, the returned channel           might be &amp;quot;anonymous&amp;quot;, but implement the groups interface and have           the requested contact already present among the members.&lt;/p&gt;          &lt;p&gt;If the request cannot be satisfied, an error is raised and no           channel is created.&lt;/p&gt;
 
3781
</p>
3251
3782
<div class="variablelist"><table border="0">
3252
3783
<col align="left" valign="top">
3253
3784
<tbody>
3254
3785
<tr>
3255
3786
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3256
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
3787
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3257
3788
</td>
3258
3789
</tr>
3259
3790
<tr>
3260
3791
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3261
 
<td> the timeout in milliseconds, or -1 to use the
 
3792
<td>the timeout in milliseconds, or -1 to use the
3262
3793
  default
3263
3794
</td>
3264
3795
</tr>
3265
3796
<tr>
3266
3797
<td><p><span class="term"><em class="parameter"><code>in_Type</code></em> :</span></p></td>
3267
 
<td> Used to pass an 'in' argument: A D-Bus interface name representing base channel type
 
3798
<td>Used to pass an 'in' argument: A D-Bus interface name representing base channel type
3268
3799
</td>
3269
3800
</tr>
3270
3801
<tr>
3271
3802
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3272
 
<td> Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if           no handle is specified
 
3803
<td>Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if           no handle is specified
3273
3804
</td>
3274
3805
</tr>
3275
3806
<tr>
3276
3807
<td><p><span class="term"><em class="parameter"><code>in_Handle</code></em> :</span></p></td>
3277
 
<td> Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc.           according to handle_type, or zero if the handle_type is           Handle_Type_None
 
3808
<td>Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc.           according to handle_type, or zero if the handle_type is           Handle_Type_None
3278
3809
</td>
3279
3810
</tr>
3280
3811
<tr>
3281
3812
<td><p><span class="term"><em class="parameter"><code>in_Suppress_Handler</code></em> :</span></p></td>
3282
 
<td> Used to pass an 'in' argument: &lt;p&gt;Clients SHOULD always set this to true.&lt;/p&gt;            &lt;tp:rationale&gt;             &lt;p&gt;The historical meaning was that clients that did not               intend to take responsibility for displaying the channel to               the user could set this to FALSE, in which case the channel               dispatcher would launch an appropriate channel handler.&lt;/p&gt;              &lt;p&gt;However, clients whose functionality relies on having a               working channel dispatcher should obtain that functionality by               calling methods on the channel dispatcher, so that they will               get an appropriate error if the channel dispatcher is missing               or not working.&lt;/p&gt;              &lt;p&gt;The channel dispatcher itself should set this to true too,               so that it will ignore the               &lt;tp:member-ref&gt;NewChannel&lt;/tp:member-ref&gt; signal that results               from the creation of the channel. It can then dispatch the               channel returned from this method to an               appropriate handler.&lt;/p&gt;              &lt;p&gt;So, there is no sensible use-case for setting this to false,               and setting it to false can result in unhandled channels (in               the case where clients assume that a channel dispatcher is               present, but it isn't).&lt;/p&gt;           &lt;/tp:rationale&gt;
 
3813
<td>Used to pass an 'in' argument: &lt;p&gt;Clients SHOULD always set this to true.&lt;/p&gt;            &lt;tp:rationale&gt;             &lt;p&gt;The historical meaning was that clients that did not               intend to take responsibility for displaying the channel to               the user could set this to FALSE, in which case the channel               dispatcher would launch an appropriate channel handler.&lt;/p&gt;              &lt;p&gt;However, clients whose functionality relies on having a               working channel dispatcher should obtain that functionality by               calling methods on the channel dispatcher, so that they will               get an appropriate error if the channel dispatcher is missing               or not working.&lt;/p&gt;              &lt;p&gt;The channel dispatcher itself should set this to true too,               so that it will ignore the               &lt;tp:member-ref&gt;NewChannel&lt;/tp:member-ref&gt; signal that results               from the creation of the channel. It can then dispatch the               channel returned from this method to an               appropriate handler.&lt;/p&gt;              &lt;p&gt;So, there is no sensible use-case for setting this to false,               and setting it to false can result in unhandled channels (in               the case where clients assume that a channel dispatcher is               present, but it isn't).&lt;/p&gt;           &lt;/tp:rationale&gt;
3283
3814
</td>
3284
3815
</tr>
3285
3816
<tr>
3286
3817
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3287
 
<td> called when the method call succeeds or fails;
3288
 
  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 
 
3818
<td>called when the method call succeeds or fails;
 
3819
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
3289
3820
  reply tracking
3290
3821
</td>
3291
3822
</tr>
3292
3823
<tr>
3293
3824
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3294
 
<td> user-supplied data passed to the callback;
3295
 
  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>
 
3825
<td>user-supplied data passed to the callback;
 
3826
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3296
3827
</td>
3297
3828
</tr>
3298
3829
<tr>
3299
3830
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3300
 
<td> called with the user_data as argument, after the
 
3831
<td>called with the user_data as argument, after the
3301
3832
  call has succeeded, failed or been cancelled;
3302
 
  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>
 
3833
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3303
3834
</td>
3304
3835
</tr>
3305
3836
<tr>
3306
3837
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3307
 
<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 
 
3838
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
3308
3839
  weakly referenced; if it is destroyed, this call 
3309
 
  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 
3310
 
  <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>
 
3840
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
3841
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3311
3842
</td>
3312
3843
</tr>
3313
3844
<tr>
3325
3856
<hr>
3326
3857
<div class="refsect2" title="tp_cli_connection_run_request_channel ()">
3327
3858
<a name="tp-cli-connection-run-request-channel"></a><h3>tp_cli_connection_run_request_channel ()</h3>
3328
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_request_channel
3329
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3330
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3331
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *in_Type,
3332
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3333
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle,
3334
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> in_Suppress_Handler,
3335
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **out_Object_Path,
3336
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
3337
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
3859
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_request_channel
 
3860
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3861
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3862
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Type</code></em>,
 
3863
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3864
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle</code></em>,
 
3865
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> in_Suppress_Handler</code></em>,
 
3866
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Object_Path</code></em>,
 
3867
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
3868
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
3338
3869
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
3339
3870
<h3 class="title">Warning</h3>
3340
3871
<p><code class="literal">tp_cli_connection_run_request_channel</code> is deprecated and should not be used in newly-written code. Use Requests.CreateChannel or Requests.EnsureChannel instead. Connection managers MAY implement RequestChannel by         raising NotImplemented, or implement fewer types of channel via         this API.</p>
3347
3878
state.
3348
3879
</p>
3349
3880
<p>
3350
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request a channel satisfying the specified type and communicating           with the contact, room, list etc. indicated by the given           handle_type and handle. The handle_type and handle may both be           zero to request the creation of a new, empty channel, which may           or may not be possible, depending on the protocol and channel           type.&lt;/p&gt;          &lt;p&gt;On success, the returned channel will always be of the requested           type (i.e. implement the requested channel-type interface).&lt;/p&gt;          &lt;p&gt;If a new, empty channel is requested, on success the returned           channel will always be an &amp;quot;anonymous&amp;quot; channel for which the type           and handle are both zero.&lt;/p&gt;          &lt;p&gt;If a channel to a contact, room etc. is requested, on success, the           returned channel may either be a new or existing channel to           the requested entity (i.e. its           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandleType&lt;/tp:dbus-ref&gt;           and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt;           properties are the           requested handle type and handle), or a newly created &amp;quot;anonymous&amp;quot;           channel associated with the requested handle in some           implementation-specific way.&lt;/p&gt;          &lt;p&gt;For example, for a contact handle, the returned channel           might be &amp;quot;anonymous&amp;quot;, but implement the groups interface and have           the requested contact already present among the members.&lt;/p&gt;          &lt;p&gt;If the request cannot be satisfied, an error is raised and no           channel is created.&lt;/p&gt;</p>
 
3881
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Request a channel satisfying the specified type and communicating           with the contact, room, list etc. indicated by the given           handle_type and handle. The handle_type and handle may both be           zero to request the creation of a new, empty channel, which may           or may not be possible, depending on the protocol and channel           type.&lt;/p&gt;          &lt;p&gt;On success, the returned channel will always be of the requested           type (i.e. implement the requested channel-type interface).&lt;/p&gt;          &lt;p&gt;If a new, empty channel is requested, on success the returned           channel will always be an &amp;quot;anonymous&amp;quot; channel for which the type           and handle are both zero.&lt;/p&gt;          &lt;p&gt;If a channel to a contact, room etc. is requested, on success, the           returned channel may either be a new or existing channel to           the requested entity (i.e. its           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandleType&lt;/tp:dbus-ref&gt;           and &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;TargetHandle&lt;/tp:dbus-ref&gt;           properties are the           requested handle type and handle), or a newly created &amp;quot;anonymous&amp;quot;           channel associated with the requested handle in some           implementation-specific way.&lt;/p&gt;          &lt;p&gt;For example, for a contact handle, the returned channel           might be &amp;quot;anonymous&amp;quot;, but implement the groups interface and have           the requested contact already present among the members.&lt;/p&gt;          &lt;p&gt;If the request cannot be satisfied, an error is raised and no           channel is created.&lt;/p&gt;
 
3882
</p>
3351
3883
<div class="variablelist"><table border="0">
3352
3884
<col align="left" valign="top">
3353
3885
<tbody>
3354
3886
<tr>
3355
3887
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3356
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
3888
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3357
3889
</td>
3358
3890
</tr>
3359
3891
<tr>
3360
3892
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3361
 
<td> Timeout in milliseconds, or -1 for default
 
3893
<td>Timeout in milliseconds, or -1 for default
3362
3894
</td>
3363
3895
</tr>
3364
3896
<tr>
3365
3897
<td><p><span class="term"><em class="parameter"><code>in_Type</code></em> :</span></p></td>
3366
 
<td> Used to pass an 'in' argument: A D-Bus interface name representing base channel type
 
3898
<td>Used to pass an 'in' argument: A D-Bus interface name representing base channel type
3367
3899
</td>
3368
3900
</tr>
3369
3901
<tr>
3370
3902
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3371
 
<td> Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if           no handle is specified
 
3903
<td>Used to pass an 'in' argument: An integer representing the handle type, or Handle_Type_None if           no handle is specified
3372
3904
</td>
3373
3905
</tr>
3374
3906
<tr>
3375
3907
<td><p><span class="term"><em class="parameter"><code>in_Handle</code></em> :</span></p></td>
3376
 
<td> Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc.           according to handle_type, or zero if the handle_type is           Handle_Type_None
 
3908
<td>Used to pass an 'in' argument: A nonzero integer handle representing a contact, room, list etc.           according to handle_type, or zero if the handle_type is           Handle_Type_None
3377
3909
</td>
3378
3910
</tr>
3379
3911
<tr>
3380
3912
<td><p><span class="term"><em class="parameter"><code>in_Suppress_Handler</code></em> :</span></p></td>
3381
 
<td> Used to pass an 'in' argument: &lt;p&gt;Clients SHOULD always set this to true.&lt;/p&gt;            &lt;tp:rationale&gt;             &lt;p&gt;The historical meaning was that clients that did not               intend to take responsibility for displaying the channel to               the user could set this to FALSE, in which case the channel               dispatcher would launch an appropriate channel handler.&lt;/p&gt;              &lt;p&gt;However, clients whose functionality relies on having a               working channel dispatcher should obtain that functionality by               calling methods on the channel dispatcher, so that they will               get an appropriate error if the channel dispatcher is missing               or not working.&lt;/p&gt;              &lt;p&gt;The channel dispatcher itself should set this to true too,               so that it will ignore the               &lt;tp:member-ref&gt;NewChannel&lt;/tp:member-ref&gt; signal that results               from the creation of the channel. It can then dispatch the               channel returned from this method to an               appropriate handler.&lt;/p&gt;              &lt;p&gt;So, there is no sensible use-case for setting this to false,               and setting it to false can result in unhandled channels (in               the case where clients assume that a channel dispatcher is               present, but it isn't).&lt;/p&gt;           &lt;/tp:rationale&gt;
 
3913
<td>Used to pass an 'in' argument: &lt;p&gt;Clients SHOULD always set this to true.&lt;/p&gt;            &lt;tp:rationale&gt;             &lt;p&gt;The historical meaning was that clients that did not               intend to take responsibility for displaying the channel to               the user could set this to FALSE, in which case the channel               dispatcher would launch an appropriate channel handler.&lt;/p&gt;              &lt;p&gt;However, clients whose functionality relies on having a               working channel dispatcher should obtain that functionality by               calling methods on the channel dispatcher, so that they will               get an appropriate error if the channel dispatcher is missing               or not working.&lt;/p&gt;              &lt;p&gt;The channel dispatcher itself should set this to true too,               so that it will ignore the               &lt;tp:member-ref&gt;NewChannel&lt;/tp:member-ref&gt; signal that results               from the creation of the channel. It can then dispatch the               channel returned from this method to an               appropriate handler.&lt;/p&gt;              &lt;p&gt;So, there is no sensible use-case for setting this to false,               and setting it to false can result in unhandled channels (in               the case where clients assume that a channel dispatcher is               present, but it isn't).&lt;/p&gt;           &lt;/tp:rationale&gt;
3382
3914
</td>
3383
3915
</tr>
3384
3916
<tr>
3385
3917
<td><p><span class="term"><em class="parameter"><code>out_Object_Path</code></em> :</span></p></td>
3386
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The D-Bus object path for the channel created or retrieved
 
3918
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The D-Bus object path for the channel created or retrieved
3387
3919
</td>
3388
3920
</tr>
3389
3921
<tr>
3390
3922
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3391
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
3923
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
3392
3924
 is returned
3393
3925
</td>
3394
3926
</tr>
3395
3927
<tr>
3396
3928
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3397
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
3398
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
3929
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
3930
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
3399
3931
 which can be used to cancel this call with 
3400
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
3401
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
3932
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
3933
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3402
3934
</td>
3403
3935
</tr>
3404
3936
<tr>
3414
3946
<div class="refsect2" title="tp_cli_connection_callback_for_request_handles ()">
3415
3947
<a name="tp-cli-connection-callback-for-request-handles"></a><h3>tp_cli_connection_callback_for_request_handles ()</h3>
3416
3948
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_callback_for_request_handles)
3417
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3418
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> *out_Handles,
3419
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> *error,
3420
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3421
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3949
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3950
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *out_Handles</code></em>,
 
3951
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
3952
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
3953
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3422
3954
<p>
3423
3955
Signature of the callback called when a RequestHandles method call
3424
 
succeeds or fails.</p>
 
3956
succeeds or fails.
 
3957
</p>
3425
3958
<div class="variablelist"><table border="0">
3426
3959
<col align="left" valign="top">
3427
3960
<tbody>
3428
3961
<tr>
3429
3962
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3430
 
<td> the proxy on which the call was made
 
3963
<td>the proxy on which the call was made
3431
3964
</td>
3432
3965
</tr>
3433
3966
<tr>
3434
3967
<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
3435
 
<td> Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of integer handle numbers in the same order as the given identifiers.
 
3968
<td>Used to return an 'out' argument if <em class="parameter"><code>error</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: An array of integer handle numbers in the same order as the given identifiers.
3436
3969
</td>
3437
3970
</tr>
3438
3971
<tr>
3439
3972
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3440
 
<td> <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
 
3973
<td>
 
3974
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
3441
3975
</td>
3442
3976
</tr>
3443
3977
<tr>
3444
3978
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3445
 
<td> user-supplied data
 
3979
<td>user-supplied data
3446
3980
</td>
3447
3981
</tr>
3448
3982
<tr>
3449
3983
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3450
 
<td> user-supplied object
 
3984
<td>user-supplied object
3451
3985
</td>
3452
3986
</tr>
3453
3987
</tbody>
3457
3991
<div class="refsect2" title="tp_cli_connection_call_request_handles ()">
3458
3992
<a name="tp-cli-connection-call-request-handles"></a><h3>tp_cli_connection_call_request_handles ()</h3>
3459
3993
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_call_request_handles
3460
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3461
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3462
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3463
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **in_Identifiers,
3464
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()"><span class="returnvalue">tp_cli_connection_callback_for_request_handles</span></a> callback,
3465
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3466
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3467
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
3994
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
3995
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
3996
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
3997
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Identifiers</code></em>,
 
3998
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-callback-for-request-handles" title="tp_cli_connection_callback_for_request_handles ()"><span class="type">tp_cli_connection_callback_for_request_handles</span></a> callback</code></em>,
 
3999
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4000
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
4001
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3468
4002
<p>
3469
4003
Start a RequestHandles method call.
3470
4004
</p>
3471
4005
<p>
3472
 
Request several handles from the connection manager which represent a         number of contacts, rooms or server-stored lists on the service. The         connection manager should record that these handles are in use by the         client who invokes this method, and must not deallocate the handles         until the client disconnects from the bus or calls the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method. Where the identifier refers to an entity that already has a         handle in this connection manager, this handle should be returned         instead. The handle number 0 must not be returned by the connection         manager.</p>
 
4006
Request several handles from the connection manager which represent a         number of contacts, rooms or server-stored lists on the service. The         connection manager should record that these handles are in use by the         client who invokes this method, and must not deallocate the handles         until the client disconnects from the bus or calls the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method. Where the identifier refers to an entity that already has a         handle in this connection manager, this handle should be returned         instead. The handle number 0 must not be returned by the connection         manager.
 
4007
</p>
3473
4008
<div class="variablelist"><table border="0">
3474
4009
<col align="left" valign="top">
3475
4010
<tbody>
3476
4011
<tr>
3477
4012
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3478
 
<td> the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
4013
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
3479
4014
</td>
3480
4015
</tr>
3481
4016
<tr>
3482
4017
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3483
 
<td> the timeout in milliseconds, or -1 to use the
 
4018
<td>the timeout in milliseconds, or -1 to use the
3484
4019
  default
3485
4020
</td>
3486
4021
</tr>
3487
4022
<tr>
3488
4023
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3489
 
<td> Used to pass an 'in' argument: The type of handle required
 
4024
<td>Used to pass an 'in' argument: The type of handle required
3490
4025
</td>
3491
4026
</tr>
3492
4027
<tr>
3493
4028
<td><p><span class="term"><em class="parameter"><code>in_Identifiers</code></em> :</span></p></td>
3494
 
<td> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
 
4029
<td>Used to pass an 'in' argument: An array of identifiers of entities to request handles for
3495
4030
</td>
3496
4031
</tr>
3497
4032
<tr>
3498
4033
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3499
 
<td> called when the method call succeeds or fails;
3500
 
  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 
 
4034
<td>called when the method call succeeds or fails;
 
4035
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
3501
4036
  reply tracking
3502
4037
</td>
3503
4038
</tr>
3504
4039
<tr>
3505
4040
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3506
 
<td> user-supplied data passed to the callback;
3507
 
  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>
 
4041
<td>user-supplied data passed to the callback;
 
4042
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3508
4043
</td>
3509
4044
</tr>
3510
4045
<tr>
3511
4046
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3512
 
<td> called with the user_data as argument, after the
 
4047
<td>called with the user_data as argument, after the
3513
4048
  call has succeeded, failed or been cancelled;
3514
 
  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>
 
4049
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3515
4050
</td>
3516
4051
</tr>
3517
4052
<tr>
3518
4053
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3519
 
<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 
 
4054
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
3520
4055
  weakly referenced; if it is destroyed, this call 
3521
 
  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 
3522
 
  <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>
 
4056
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
4057
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3523
4058
</td>
3524
4059
</tr>
3525
4060
<tr>
3536
4071
<hr>
3537
4072
<div class="refsect2" title="tp_cli_connection_run_request_handles ()">
3538
4073
<a name="tp-cli-connection-run-request-handles"></a><h3>tp_cli_connection_run_request_handles ()</h3>
3539
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_request_handles
3540
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3541
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> timeout_ms,
3542
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> in_Handle_Type,
3543
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **in_Identifiers,
3544
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="returnvalue">GArray</span></a> **out_Handles,
3545
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error,
3546
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="returnvalue">GMainLoop</span></a> **loop);</pre>
 
4074
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            tp_cli_connection_run_request_handles
 
4075
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4076
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
4077
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Handle_Type</code></em>,
 
4078
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **in_Identifiers</code></em>,
 
4079
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> **out_Handles</code></em>,
 
4080
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>,
 
4081
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
 
4082
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
4083
<h3 class="title">Warning</h3>
 
4084
<p><code class="literal">tp_cli_connection_run_request_handles</code> is deprecated and should not be used in newly-written code.</p>
 
4085
</div>
3547
4086
<p>
3548
4087
Call the method RequestHandles and run the main loop
3549
4088
until it returns. Before calling this method, you must
3552
4091
state.
3553
4092
</p>
3554
4093
<p>
3555
 
Request several handles from the connection manager which represent a         number of contacts, rooms or server-stored lists on the service. The         connection manager should record that these handles are in use by the         client who invokes this method, and must not deallocate the handles         until the client disconnects from the bus or calls the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method. Where the identifier refers to an entity that already has a         handle in this connection manager, this handle should be returned         instead. The handle number 0 must not be returned by the connection         manager.</p>
 
4094
Request several handles from the connection manager which represent a         number of contacts, rooms or server-stored lists on the service. The         connection manager should record that these handles are in use by the         client who invokes this method, and must not deallocate the handles         until the client disconnects from the bus or calls the         &lt;tp:member-ref&gt;ReleaseHandles&lt;/tp:member-ref&gt;         method. Where the identifier refers to an entity that already has a         handle in this connection manager, this handle should be returned         instead. The handle number 0 must not be returned by the connection         manager.
 
4095
</p>
3556
4096
<div class="variablelist"><table border="0">
3557
4097
<col align="left" valign="top">
3558
4098
<tbody>
3559
4099
<tr>
3560
4100
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3561
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
4101
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3562
4102
</td>
3563
4103
</tr>
3564
4104
<tr>
3565
4105
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
3566
 
<td> Timeout in milliseconds, or -1 for default
 
4106
<td>Timeout in milliseconds, or -1 for default
3567
4107
</td>
3568
4108
</tr>
3569
4109
<tr>
3570
4110
<td><p><span class="term"><em class="parameter"><code>in_Handle_Type</code></em> :</span></p></td>
3571
 
<td> Used to pass an 'in' argument: The type of handle required
 
4111
<td>Used to pass an 'in' argument: The type of handle required
3572
4112
</td>
3573
4113
</tr>
3574
4114
<tr>
3575
4115
<td><p><span class="term"><em class="parameter"><code>in_Identifiers</code></em> :</span></p></td>
3576
 
<td> Used to pass an 'in' argument: An array of identifiers of entities to request handles for
 
4116
<td>Used to pass an 'in' argument: An array of identifiers of entities to request handles for
3577
4117
</td>
3578
4118
</tr>
3579
4119
<tr>
3580
4120
<td><p><span class="term"><em class="parameter"><code>out_Handles</code></em> :</span></p></td>
3581
 
<td> Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of integer handle numbers in the same order as the given identifiers.
 
4121
<td>Used to return an 'out' argument if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: An array of integer handle numbers in the same order as the given identifiers.
3582
4122
</td>
3583
4123
</tr>
3584
4124
<tr>
3585
4125
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3586
 
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
4126
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
3587
4127
 is returned
3588
4128
</td>
3589
4129
</tr>
3590
4130
<tr>
3591
4131
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
3592
 
<td> If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
3593
 
 the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
 
4132
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering 
 
4133
 the main loop, to point to a <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> 
3594
4134
 which can be used to cancel this call with 
3595
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
3596
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
 
4135
 <a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of 
 
4136
 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
3597
4137
</td>
3598
4138
</tr>
3599
4139
<tr>
3608
4148
<div class="refsect2" title="tp_cli_connection_signal_callback_new_channel ()">
3609
4149
<a name="tp-cli-connection-signal-callback-new-channel"></a><h3>tp_cli_connection_signal_callback_new_channel ()</h3>
3610
4150
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_signal_callback_new_channel)
3611
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3612
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Object_Path,
3613
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Channel_Type,
3614
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Handle_Type,
3615
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Handle,
3616
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> arg_Suppress_Handler,
3617
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3618
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
4151
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4152
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Object_Path</code></em>,
 
4153
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Channel_Type</code></em>,
 
4154
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle_Type</code></em>,
 
4155
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Handle</code></em>,
 
4156
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_Suppress_Handler</code></em>,
 
4157
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4158
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3619
4159
<p>
3620
 
Represents the signature of a callback for the signal NewChannel.</p>
 
4160
Represents the signature of a callback for the signal NewChannel.
 
4161
</p>
3621
4162
<div class="variablelist"><table border="0">
3622
4163
<col align="left" valign="top">
3623
4164
<tbody>
3624
4165
<tr>
3625
4166
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3626
 
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-new-channel" title="tp_cli_connection_connect_to_new_channel ()"><code class="function">tp_cli_connection_connect_to_new_channel()</code></a>
 
4167
<td>The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-new-channel" title="tp_cli_connection_connect_to_new_channel ()"><code class="function">tp_cli_connection_connect_to_new_channel()</code></a>
3627
4168
 was called
3628
4169
</td>
3629
4170
</tr>
3630
4171
<tr>
3631
4172
<td><p><span class="term"><em class="parameter"><code>arg_Object_Path</code></em> :</span></p></td>
3632
 
<td> A D-Bus object path for the channel object on this service
 
4173
<td>A D-Bus object path for the channel object on this service
3633
4174
</td>
3634
4175
</tr>
3635
4176
<tr>
3636
4177
<td><p><span class="term"><em class="parameter"><code>arg_Channel_Type</code></em> :</span></p></td>
3637
 
<td> A D-Bus interface name representing the channel type
 
4178
<td>A D-Bus interface name representing the channel type
3638
4179
</td>
3639
4180
</tr>
3640
4181
<tr>
3641
4182
<td><p><span class="term"><em class="parameter"><code>arg_Handle_Type</code></em> :</span></p></td>
3642
 
<td> An integer representing the type of handle this channel           communicates with, or Handle_Type_None if no handle is specified
 
4183
<td>An integer representing the type of handle this channel           communicates with, or Handle_Type_None if no handle is specified
3643
4184
</td>
3644
4185
</tr>
3645
4186
<tr>
3646
4187
<td><p><span class="term"><em class="parameter"><code>arg_Handle</code></em> :</span></p></td>
3647
 
<td> A handle indicating the specific contact, room or list this           channel communicates with, or zero if no handle is specified
 
4188
<td>A handle indicating the specific contact, room or list this           channel communicates with, or zero if no handle is specified
3648
4189
</td>
3649
4190
</tr>
3650
4191
<tr>
3651
4192
<td><p><span class="term"><em class="parameter"><code>arg_Suppress_Handler</code></em> :</span></p></td>
3652
 
<td> &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;If true, the channel was requested by a client that intends to             present it to the user itself (i.e. it passed suppress_handler=TRUE             to the &lt;tp:member-ref&gt;RequestChannel&lt;/tp:member-ref&gt; method), so no             other handler should be             launched. Clients MAY assume that channels where this is true             were created by a user request.&lt;/p&gt;            &lt;p&gt;If false, either the channel was created due to incoming             information from the service, or the channel was requested by             a local client that does not intend to handle the channel itself             (this usage is deprecated).&lt;/p&gt;            &lt;p&gt;Clients MUST NOT assume that only incoming channels will have             this flag set to false.&lt;/p&gt;
 
4193
<td>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;If true, the channel was requested by a client that intends to             present it to the user itself (i.e. it passed suppress_handler=TRUE             to the &lt;tp:member-ref&gt;RequestChannel&lt;/tp:member-ref&gt; method), so no             other handler should be             launched. Clients MAY assume that channels where this is true             were created by a user request.&lt;/p&gt;            &lt;p&gt;If false, either the channel was created due to incoming             information from the service, or the channel was requested by             a local client that does not intend to handle the channel itself             (this usage is deprecated).&lt;/p&gt;            &lt;p&gt;Clients MUST NOT assume that only incoming channels will have             this flag set to false.&lt;/p&gt;
3653
4194
</td>
3654
4195
</tr>
3655
4196
<tr>
3656
4197
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3657
 
<td> User-supplied data
 
4198
<td>User-supplied data
3658
4199
</td>
3659
4200
</tr>
3660
4201
<tr>
3661
4202
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3662
 
<td> User-supplied weakly referenced object
 
4203
<td>User-supplied weakly referenced object
3663
4204
</td>
3664
4205
</tr>
3665
4206
</tbody>
3669
4210
<div class="refsect2" title="tp_cli_connection_connect_to_new_channel ()">
3670
4211
<a name="tp-cli-connection-connect-to-new-channel"></a><h3>tp_cli_connection_connect_to_new_channel ()</h3>
3671
4212
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_connect_to_new_channel
3672
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3673
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()"><span class="returnvalue">tp_cli_connection_signal_callback_new_channel</span></a> callback,
3674
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3675
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3676
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
3677
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
4213
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4214
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-new-channel" title="tp_cli_connection_signal_callback_new_channel ()"><span class="type">tp_cli_connection_signal_callback_new_channel</span></a> callback</code></em>,
 
4215
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4216
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
4217
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
4218
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3678
4219
<p>
3679
4220
Connect a handler to the signal NewChannel.
3680
4221
</p>
3681
4222
<p>
3682
 
Emitted when a new Channel object is created, either through user         request or incoming information from the service.</p>
 
4223
Emitted when a new Channel object is created, either through user         request or incoming information from the service.
 
4224
</p>
3683
4225
<div class="variablelist"><table border="0">
3684
4226
<col align="left" valign="top">
3685
4227
<tbody>
3686
4228
<tr>
3687
4229
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3688
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
4230
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3689
4231
</td>
3690
4232
</tr>
3691
4233
<tr>
3692
4234
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3693
 
<td> Callback to be called when the signal is
 
4235
<td>Callback to be called when the signal is
3694
4236
  received
3695
4237
</td>
3696
4238
</tr>
3697
4239
<tr>
3698
4240
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3699
 
<td> User-supplied data for the callback
 
4241
<td>User-supplied data for the callback
3700
4242
</td>
3701
4243
</tr>
3702
4244
<tr>
3703
4245
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3704
 
<td> Destructor for the user-supplied data, which
 
4246
<td>Destructor for the user-supplied data, which
3705
4247
  will be called when this signal is disconnected, or
3706
 
  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>
 
4248
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3707
4249
</td>
3708
4250
</tr>
3709
4251
<tr>
3710
4252
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3711
 
<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; 
 
4253
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
3712
4254
  if it is destroyed, this callback will automatically be
3713
4255
  disconnected
3714
4256
</td>
3715
4257
</tr>
3716
4258
<tr>
3717
4259
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3718
 
<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
 
4260
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3719
4261
  returned
3720
4262
</td>
3721
4263
</tr>
3723
4265
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3724
4266
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3725
4267
above, which can be used to disconnect the signal; or
3726
 
<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
 
4268
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3727
4269
or has become invalid.
3728
4270
</td>
3729
4271
</tr>
3734
4276
<div class="refsect2" title="tp_cli_connection_signal_callback_self_handle_changed ()">
3735
4277
<a name="tp-cli-connection-signal-callback-self-handle-changed"></a><h3>tp_cli_connection_signal_callback_self_handle_changed ()</h3>
3736
4278
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_signal_callback_self_handle_changed)
3737
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3738
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Self_Handle,
3739
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3740
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
4279
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4280
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Self_Handle</code></em>,
 
4281
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4282
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3741
4283
<p>
3742
 
Represents the signature of a callback for the signal SelfHandleChanged.</p>
 
4284
Represents the signature of a callback for the signal SelfHandleChanged.
 
4285
</p>
3743
4286
<div class="variablelist"><table border="0">
3744
4287
<col align="left" valign="top">
3745
4288
<tbody>
3746
4289
<tr>
3747
4290
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3748
 
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-self-handle-changed" title="tp_cli_connection_connect_to_self_handle_changed ()"><code class="function">tp_cli_connection_connect_to_self_handle_changed()</code></a>
 
4291
<td>The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-self-handle-changed" title="tp_cli_connection_connect_to_self_handle_changed ()"><code class="function">tp_cli_connection_connect_to_self_handle_changed()</code></a>
3749
4292
 was called
3750
4293
</td>
3751
4294
</tr>
3752
4295
<tr>
3753
4296
<td><p><span class="term"><em class="parameter"><code>arg_Self_Handle</code></em> :</span></p></td>
3754
 
<td> The new value of the SelfHandle property.
 
4297
<td>The new value of the SelfHandle property.
3755
4298
</td>
3756
4299
</tr>
3757
4300
<tr>
3758
4301
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3759
 
<td> User-supplied data
 
4302
<td>User-supplied data
3760
4303
</td>
3761
4304
</tr>
3762
4305
<tr>
3763
4306
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3764
 
<td> User-supplied weakly referenced object
 
4307
<td>User-supplied weakly referenced object
3765
4308
</td>
3766
4309
</tr>
3767
4310
</tbody>
3771
4314
<div class="refsect2" title="tp_cli_connection_connect_to_self_handle_changed ()">
3772
4315
<a name="tp-cli-connection-connect-to-self-handle-changed"></a><h3>tp_cli_connection_connect_to_self_handle_changed ()</h3>
3773
4316
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_connect_to_self_handle_changed
3774
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3775
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()"><span class="returnvalue">tp_cli_connection_signal_callback_self_handle_changed</span></a> callback,
3776
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3777
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3778
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
3779
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
4317
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4318
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-self-handle-changed" title="tp_cli_connection_signal_callback_self_handle_changed ()"><span class="type">tp_cli_connection_signal_callback_self_handle_changed</span></a> callback</code></em>,
 
4319
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4320
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
4321
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
4322
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3780
4323
<p>
3781
4324
Connect a handler to the signal SelfHandleChanged.
3782
4325
</p>
3783
4326
<p>
3784
 
Emitted whenever the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property         changes. If the connection         is not yet in the CONNECTED state, this signal is not guaranteed         to be emitted.</p>
 
4327
Emitted whenever the &lt;tp:member-ref&gt;SelfHandle&lt;/tp:member-ref&gt; property         changes. If the connection         is not yet in the CONNECTED state, this signal is not guaranteed         to be emitted.
 
4328
</p>
3785
4329
<div class="variablelist"><table border="0">
3786
4330
<col align="left" valign="top">
3787
4331
<tbody>
3788
4332
<tr>
3789
4333
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3790
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
4334
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3791
4335
</td>
3792
4336
</tr>
3793
4337
<tr>
3794
4338
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3795
 
<td> Callback to be called when the signal is
 
4339
<td>Callback to be called when the signal is
3796
4340
  received
3797
4341
</td>
3798
4342
</tr>
3799
4343
<tr>
3800
4344
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3801
 
<td> User-supplied data for the callback
 
4345
<td>User-supplied data for the callback
3802
4346
</td>
3803
4347
</tr>
3804
4348
<tr>
3805
4349
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3806
 
<td> Destructor for the user-supplied data, which
 
4350
<td>Destructor for the user-supplied data, which
3807
4351
  will be called when this signal is disconnected, or
3808
 
  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>
 
4352
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3809
4353
</td>
3810
4354
</tr>
3811
4355
<tr>
3812
4356
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3813
 
<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; 
 
4357
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
3814
4358
  if it is destroyed, this callback will automatically be
3815
4359
  disconnected
3816
4360
</td>
3817
4361
</tr>
3818
4362
<tr>
3819
4363
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3820
 
<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
 
4364
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3821
4365
  returned
3822
4366
</td>
3823
4367
</tr>
3825
4369
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3826
4370
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3827
4371
above, which can be used to disconnect the signal; or
3828
 
<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
 
4372
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3829
4373
or has become invalid.
3830
4374
</td>
3831
4375
</tr>
3836
4380
<div class="refsect2" title="tp_cli_connection_signal_callback_status_changed ()">
3837
4381
<a name="tp-cli-connection-signal-callback-status-changed"></a><h3>tp_cli_connection_signal_callback_status_changed ()</h3>
3838
4382
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_signal_callback_status_changed)
3839
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3840
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Status,
3841
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> arg_Reason,
3842
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3843
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
4383
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4384
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Status</code></em>,
 
4385
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Reason</code></em>,
 
4386
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4387
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3844
4388
<p>
3845
 
Represents the signature of a callback for the signal StatusChanged.</p>
 
4389
Represents the signature of a callback for the signal StatusChanged.
 
4390
</p>
3846
4391
<div class="variablelist"><table border="0">
3847
4392
<col align="left" valign="top">
3848
4393
<tbody>
3849
4394
<tr>
3850
4395
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3851
 
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-status-changed" title="tp_cli_connection_connect_to_status_changed ()"><code class="function">tp_cli_connection_connect_to_status_changed()</code></a>
 
4396
<td>The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-status-changed" title="tp_cli_connection_connect_to_status_changed ()"><code class="function">tp_cli_connection_connect_to_status_changed()</code></a>
3852
4397
 was called
3853
4398
</td>
3854
4399
</tr>
3855
4400
<tr>
3856
4401
<td><p><span class="term"><em class="parameter"><code>arg_Status</code></em> :</span></p></td>
3857
 
<td> An integer indicating the new status, as defined by ConnectionStatus
 
4402
<td>An integer indicating the new status, as defined by ConnectionStatus
3858
4403
</td>
3859
4404
</tr>
3860
4405
<tr>
3861
4406
<td><p><span class="term"><em class="parameter"><code>arg_Reason</code></em> :</span></p></td>
3862
 
<td> An integer indicating the reason for the status change, as defined           by ConnectionStatusReason
 
4407
<td>An integer indicating the reason for the status change, as defined           by ConnectionStatusReason
3863
4408
</td>
3864
4409
</tr>
3865
4410
<tr>
3866
4411
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3867
 
<td> User-supplied data
 
4412
<td>User-supplied data
3868
4413
</td>
3869
4414
</tr>
3870
4415
<tr>
3871
4416
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3872
 
<td> User-supplied weakly referenced object
 
4417
<td>User-supplied weakly referenced object
3873
4418
</td>
3874
4419
</tr>
3875
4420
</tbody>
3879
4424
<div class="refsect2" title="tp_cli_connection_connect_to_status_changed ()">
3880
4425
<a name="tp-cli-connection-connect-to-status-changed"></a><h3>tp_cli_connection_connect_to_status_changed ()</h3>
3881
4426
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_connect_to_status_changed
3882
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3883
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()"><span class="returnvalue">tp_cli_connection_signal_callback_status_changed</span></a> callback,
3884
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3885
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3886
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
3887
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
4427
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4428
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-status-changed" title="tp_cli_connection_signal_callback_status_changed ()"><span class="type">tp_cli_connection_signal_callback_status_changed</span></a> callback</code></em>,
 
4429
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4430
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
4431
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
4432
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3888
4433
<p>
3889
4434
Connect a handler to the signal StatusChanged.
3890
4435
</p>
3891
4436
<p>
3892
 
Emitted when the status of the connection changes.  All states and         reasons have numerical values, as defined in ConnectionStatus         and ConnectionStatusReason.</p>
 
4437
Emitted when the status of the connection changes.  All states and         reasons have numerical values, as defined in ConnectionStatus         and ConnectionStatusReason.
 
4438
</p>
3893
4439
<div class="variablelist"><table border="0">
3894
4440
<col align="left" valign="top">
3895
4441
<tbody>
3896
4442
<tr>
3897
4443
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3898
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
4444
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
3899
4445
</td>
3900
4446
</tr>
3901
4447
<tr>
3902
4448
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
3903
 
<td> Callback to be called when the signal is
 
4449
<td>Callback to be called when the signal is
3904
4450
  received
3905
4451
</td>
3906
4452
</tr>
3907
4453
<tr>
3908
4454
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3909
 
<td> User-supplied data for the callback
 
4455
<td>User-supplied data for the callback
3910
4456
</td>
3911
4457
</tr>
3912
4458
<tr>
3913
4459
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
3914
 
<td> Destructor for the user-supplied data, which
 
4460
<td>Destructor for the user-supplied data, which
3915
4461
  will be called when this signal is disconnected, or
3916
 
  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>
 
4462
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3917
4463
</td>
3918
4464
</tr>
3919
4465
<tr>
3920
4466
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3921
 
<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; 
 
4467
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
3922
4468
  if it is destroyed, this callback will automatically be
3923
4469
  disconnected
3924
4470
</td>
3925
4471
</tr>
3926
4472
<tr>
3927
4473
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3928
 
<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
 
4474
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
3929
4475
  returned
3930
4476
</td>
3931
4477
</tr>
3933
4479
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3934
4480
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
3935
4481
above, which can be used to disconnect the signal; or
3936
 
<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
 
4482
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
3937
4483
or has become invalid.
3938
4484
</td>
3939
4485
</tr>
3944
4490
<div class="refsect2" title="tp_cli_connection_signal_callback_connection_error ()">
3945
4491
<a name="tp-cli-connection-signal-callback-connection-error"></a><h3>tp_cli_connection_signal_callback_connection_error ()</h3>
3946
4492
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_signal_callback_connection_error)
3947
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3948
 
                                                         const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *arg_Error,
3949
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *arg_Details,
3950
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3951
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object);</pre>
 
4493
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4494
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Error</code></em>,
 
4495
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Details</code></em>,
 
4496
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4497
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
3952
4498
<p>
3953
 
Represents the signature of a callback for the signal ConnectionError.</p>
 
4499
Represents the signature of a callback for the signal ConnectionError.
 
4500
</p>
3954
4501
<div class="variablelist"><table border="0">
3955
4502
<col align="left" valign="top">
3956
4503
<tbody>
3957
4504
<tr>
3958
4505
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
3959
 
<td> The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-connection-error" title="tp_cli_connection_connect_to_connection_error ()"><code class="function">tp_cli_connection_connect_to_connection_error()</code></a>
 
4506
<td>The proxy on which <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-connect-to-connection-error" title="tp_cli_connection_connect_to_connection_error ()"><code class="function">tp_cli_connection_connect_to_connection_error()</code></a>
3960
4507
 was called
3961
4508
</td>
3962
4509
</tr>
3963
4510
<tr>
3964
4511
<td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
3965
 
<td> The name of a D-Bus error describing the error that occurred,           which may correspond to a           &lt;tp:type&gt;Connection_Status_Reason&lt;/tp:type&gt;, or may be a more           specific Telepathy error           (such as           &lt;code&gt;org.freedesktop.Telepathy.Errors.ConnectionRefused&lt;/code&gt;           for Connection_Status_Reason_Network_Error)           or a protocol-specific or connection-manager-specific error in a           suitable namespace.            &lt;tp:rationale&gt;             For instance, a SIP connection manager could signal             &amp;quot;402 Payment Required&amp;quot; as an error in a             connection-manager-specific namespace, or a link-local             XMPP implementation that used Avahi could provide the error             given to it by the avahi-daemon.           &lt;/tp:rationale&gt;
 
4512
<td>The name of a D-Bus error describing the error that occurred,           which may correspond to a           &lt;tp:type&gt;Connection_Status_Reason&lt;/tp:type&gt;, or may be a more           specific Telepathy error           (such as           &lt;code&gt;org.freedesktop.Telepathy.Errors.ConnectionRefused&lt;/code&gt;           for Connection_Status_Reason_Network_Error)           or a protocol-specific or connection-manager-specific error in a           suitable namespace.            &lt;tp:rationale&gt;             For instance, a SIP connection manager could signal             &amp;quot;402 Payment Required&amp;quot; as an error in a             connection-manager-specific namespace, or a link-local             XMPP implementation that used Avahi could provide the error             given to it by the avahi-daemon.           &lt;/tp:rationale&gt;
3966
4513
</td>
3967
4514
</tr>
3968
4515
<tr>
3969
4516
<td><p><span class="term"><em class="parameter"><code>arg_Details</code></em> :</span></p></td>
3970
 
<td> &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;Additional information about the error, which may include             the following well-known keys:&lt;/p&gt;            &lt;dl&gt;             &lt;dt&gt;debug-message (s)&lt;/dt&gt;             &lt;dd&gt;Debugging information on the change, corresponding to the               message part of a D-Bus error message, which SHOULD NOT be               displayed to users under normal circumstances&lt;/dd&gt;           &lt;/dl&gt;            &lt;tp:rationale&gt;             &lt;p&gt;This argument allows for future extensions. For instance,               if indicating DNS lookup failure, we could define a key               that indicates the hostname that could not be found.&lt;/p&gt;           &lt;/tp:rationale&gt;
 
4517
<td>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;Additional information about the error, which may include             the following well-known keys:&lt;/p&gt;            &lt;dl&gt;             &lt;dt&gt;debug-message (s)&lt;/dt&gt;             &lt;dd&gt;Debugging information on the change, corresponding to the               message part of a D-Bus error message, which SHOULD NOT be               displayed to users under normal circumstances&lt;/dd&gt;           &lt;/dl&gt;            &lt;tp:rationale&gt;             &lt;p&gt;This argument allows for future extensions. For instance,               if indicating DNS lookup failure, we could define a key               that indicates the hostname that could not be found.&lt;/p&gt;           &lt;/tp:rationale&gt;
3971
4518
</td>
3972
4519
</tr>
3973
4520
<tr>
3974
4521
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
3975
 
<td> User-supplied data
 
4522
<td>User-supplied data
3976
4523
</td>
3977
4524
</tr>
3978
4525
<tr>
3979
4526
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
3980
 
<td> User-supplied weakly referenced object
 
4527
<td>User-supplied weakly referenced object
3981
4528
</td>
3982
4529
</tr>
3983
4530
</tbody>
3987
4534
<div class="refsect2" title="tp_cli_connection_connect_to_connection_error ()">
3988
4535
<a name="tp-cli-connection-connect-to-connection-error"></a><h3>tp_cli_connection_connect_to_connection_error ()</h3>
3989
4536
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_connect_to_connection_error
3990
 
                                                        (<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *proxy,
3991
 
                                                         <a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()"><span class="returnvalue">tp_cli_connection_signal_callback_connection_error</span></a> callback,
3992
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data,
3993
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> destroy,
3994
 
                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *weak_object,
3995
 
                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 
4537
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
4538
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#tp-cli-connection-signal-callback-connection-error" title="tp_cli_connection_signal_callback_connection_error ()"><span class="type">tp_cli_connection_signal_callback_connection_error</span></a> callback</code></em>,
 
4539
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
4540
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
4541
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
4542
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3996
4543
<p>
3997
4544
Connect a handler to the signal ConnectionError.
3998
4545
</p>
3999
4546
<p>
4000
 
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Emitted when an error occurs that renders this connection unusable.         &lt;/p&gt;          &lt;p&gt;Whenever this signal is emitted, it MUST immediately be followed by           a &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal with status           Connection_Status_Reason_Disconnected and an appropriate reason           code.&lt;/p&gt;          &lt;p&gt;Connection managers SHOULD emit this signal on disconnection, but           need not do so. Clients MUST support connection managers that emit           StatusChanged(Disconnected, ...) without first emitting           ConnectionError.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;This signal provides additional information about the reason             for disconnection. The reason for connection is always             straightforward - it was requested - so it does not need further             explanation. However, on errors, it can be useful to provide             additional information.&lt;/p&gt;            &lt;p&gt;The &lt;tp:type&gt;Connection_Status_Reason&lt;/tp:type&gt; is not given             here, since it will be signalled in             &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt;. A reasonable client             implementation would be to store the information given by this             signal until StatusChanged is received, at which point the             information given by this signal can be used to supplement the             StatusChanged signal.&lt;/p&gt;         &lt;/tp:rationale&gt;</p>
 
4547
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Emitted when an error occurs that renders this connection unusable.         &lt;/p&gt;          &lt;p&gt;Whenever this signal is emitted, it MUST immediately be followed by           a &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt; signal with status           Connection_Status_Disconnected and an appropriate reason           code.&lt;/p&gt;          &lt;p&gt;Connection managers SHOULD emit this signal on disconnection, but           need not do so. Clients MUST support connection managers that emit           StatusChanged(Disconnected, ...) without first emitting           ConnectionError.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;This signal provides additional information about the reason             for disconnection. The reason for connection is always             straightforward - it was requested - so it does not need further             explanation. However, on errors, it can be useful to provide             additional information.&lt;/p&gt;            &lt;p&gt;The &lt;tp:type&gt;Connection_Status_Reason&lt;/tp:type&gt; is not given             here, since it will be signalled in             &lt;tp:member-ref&gt;StatusChanged&lt;/tp:member-ref&gt;. A reasonable client             implementation would be to store the information given by this             signal until StatusChanged is received, at which point the             information given by this signal can be used to supplement the             StatusChanged signal.&lt;/p&gt;         &lt;/tp:rationale&gt;
 
4548
</p>
4001
4549
<div class="variablelist"><table border="0">
4002
4550
<col align="left" valign="top">
4003
4551
<tbody>
4004
4552
<tr>
4005
4553
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
4006
 
<td> A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
 
4554
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass
4007
4555
</td>
4008
4556
</tr>
4009
4557
<tr>
4010
4558
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
4011
 
<td> Callback to be called when the signal is
 
4559
<td>Callback to be called when the signal is
4012
4560
  received
4013
4561
</td>
4014
4562
</tr>
4015
4563
<tr>
4016
4564
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
4017
 
<td> User-supplied data for the callback
 
4565
<td>User-supplied data for the callback
4018
4566
</td>
4019
4567
</tr>
4020
4568
<tr>
4021
4569
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
4022
 
<td> Destructor for the user-supplied data, which
 
4570
<td>Destructor for the user-supplied data, which
4023
4571
  will be called when this signal is disconnected, or
4024
 
  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>
 
4572
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
4025
4573
</td>
4026
4574
</tr>
4027
4575
<tr>
4028
4576
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
4029
 
<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; 
 
4577
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
4030
4578
  if it is destroyed, this callback will automatically be
4031
4579
  disconnected
4032
4580
</td>
4033
4581
</tr>
4034
4582
<tr>
4035
4583
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
4036
 
<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
 
4584
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
4037
4585
  returned
4038
4586
</td>
4039
4587
</tr>
4041
4589
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
4042
4590
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
4043
4591
above, which can be used to disconnect the signal; or
4044
 
<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
 
4592
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
4045
4593
or has become invalid.
4046
4594
</td>
4047
4595
</tr>
4051
4599
</div>
4052
4600
<div class="refsect1" title="Property Details">
4053
4601
<a name="telepathy-glib-connection.property-details"></a><h2>Property Details</h2>
 
4602
<div class="refsect2" title='The "capabilities" property'>
 
4603
<a name="TpConnection--capabilities"></a><h3>The <code class="literal">"capabilities"</code> property</h3>
 
4604
<pre class="programlisting">  "capabilities"             <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><span class="type">TpCapabilities</span></a>*       : Read</pre>
 
4605
<p>
 
4606
The <a class="link" href="telepathy-glib-capabilities.html#TpCapabilities"><code class="literal">TpCapabilities</code></a> object representing the capabilities of this
 
4607
connection, or NULL if we don't know yet.
 
4608
</p>
 
4609
<p>
 
4610
To wait for valid capability information, call <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>
 
4611
with the feature <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CAPABILITIES:CAPS" title="TP_CONNECTION_FEATURE_CAPABILITIES"><code class="literal">TP_CONNECTION_FEATURE_CAPABILITIES</code></a>.
 
4612
</p>
 
4613
</div>
 
4614
<hr>
4054
4615
<div class="refsect2" title='The "connection-ready" property'>
4055
4616
<a name="TpConnection--connection-ready"></a><h3>The <code class="literal">"connection-ready"</code> property</h3>
4056
 
<pre class="programlisting">  "connection-ready"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 
4617
<pre class="programlisting">  "connection-ready"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
4057
4618
<p>
4058
 
Initially <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>; changes to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the connection has gone to
 
4619
Initially <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>; changes to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the connection has gone to
4059
4620
CONNECTED status, introspection has finished and it's ready for use.
4060
4621
</p>
4061
4622
<p>
4062
 
By the time this property becomes <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, any extra interfaces will
 
4623
By the time this property becomes <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, any extra interfaces will
4063
4624
have been set up and the <a class="link" href="telepathy-glib-proxy.html#TpProxy--interfaces" title='The "interfaces" property'><span class="type">"interfaces"</span></a> property will have been
4064
 
populated.</p>
 
4625
populated.
 
4626
</p>
 
4627
<p>
 
4628
This is similar to <a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CONNECTED:CAPS" title="TP_CONNECTION_FEATURE_CONNECTED"><code class="literal">TP_CONNECTION_FEATURE_CONNECTED</code></a>, except that once
 
4629
it has changed to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, it remains <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> even if the connection has
 
4630
been invalidated.
 
4631
</p>
4065
4632
<p>Default value: FALSE</p>
4066
4633
</div>
4067
4634
<hr>
4068
4635
<div class="refsect2" title='The "self-handle" property'>
4069
4636
<a name="TpConnection--self-handle"></a><h3>The <code class="literal">"self-handle"</code> property</h3>
4070
 
<pre class="programlisting">  "self-handle"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
 
4637
<pre class="programlisting">  "self-handle"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
4071
4638
<p>
4072
4639
The <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-CONTACT:CAPS"><code class="literal">TP_HANDLE_TYPE_CONTACT</code></a> handle of the local user on this connection,
4073
 
or 0 if we don't know yet or if the connection has become invalid.</p>
 
4640
or 0 if we don't know yet or if the connection has become invalid.
 
4641
</p>
 
4642
<p>
 
4643
To wait for a valid self-handle (and other properties), call
 
4644
<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 feature
 
4645
<a class="link" href="telepathy-glib-connection.html#TP-CONNECTION-FEATURE-CONNECTED:CAPS" title="TP_CONNECTION_FEATURE_CONNECTED"><code class="literal">TP_CONNECTION_FEATURE_CONNECTED</code></a>.
 
4646
</p>
4074
4647
<p>Default value: 0</p>
4075
4648
</div>
4076
4649
<hr>
4077
4650
<div class="refsect2" title='The "status" property'>
4078
4651
<a name="TpConnection--status"></a><h3>The <code class="literal">"status"</code> property</h3>
4079
 
<pre class="programlisting">  "status"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
4080
 
<p>
4081
 
This connection's status, or TP_UNKNOWN_CONNECTION_STATUS if we don't
4082
 
know yet.</p>
 
4652
<pre class="programlisting">  "status"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
 
4653
<p>
 
4654
This connection's status, or <a class="link" href="telepathy-glib-connection.html#TP-UNKNOWN-CONNECTION-STATUS:CAPS" title="TP_UNKNOWN_CONNECTION_STATUS"><code class="literal">TP_UNKNOWN_CONNECTION_STATUS</code></a> if we don't
 
4655
know yet.
 
4656
</p>
 
4657
<p>
 
4658
To wait for a valid status (and other properties), call
 
4659
<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 feature <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>.
 
4660
</p>
 
4661
<p>
 
4662
Since version 0.11.3, the change to status
 
4663
<a class="link" href="telepathy-glib-enums.html#TP-CONNECTION-STATUS-CONNECTED:CAPS"><code class="literal">TP_CONNECTION_STATUS_CONNECTED</code></a> is delayed slightly, until introspection
 
4664
of the connection has finished.
 
4665
</p>
4083
4666
<p>Default value: 4294967295</p>
4084
4667
</div>
4085
4668
<hr>
4086
4669
<div class="refsect2" title='The "status-reason" property'>
4087
4670
<a name="TpConnection--status-reason"></a><h3>The <code class="literal">"status-reason"</code> property</h3>
4088
 
<pre class="programlisting">  "status-reason"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
 
4671
<pre class="programlisting">  "status-reason"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
 
4672
<p>
 
4673
To wait for a valid status (and other properties), call
 
4674
<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 feature <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>.
 
4675
</p>
4089
4676
<p>
4090
4677
The reason why <a class="link" href="telepathy-glib-connection.html#TpConnection--status" title='The "status" property'><span class="type">"status"</span></a> changed to its current value,
4091
4678
or TP_CONNECTION_STATUS_REASON_NONE_SPECIFIED if unknown.
4092
 
know yet.</p>
 
4679
know yet.
 
4680
</p>
4093
4681
<p>Default value: 0</p>
4094
4682
</div>
4095
4683
</div>
4100
4688
</div>
4101
4689
<div class="footer">
4102
4690
<hr>
4103
 
          Generated by GTK-Doc V1.13</div>
 
4691
          Generated by GTK-Doc V1.14</div>
4104
4692
</body>
4105
4693
</html>
 
 
b'\\ No newline at end of file'