30
33
<h2><span class="refentrytitle"><a name="telepathy-glib-connection-location.top_of_page"></a>Connection Location interface</span></h2>
31
34
<p>Connection Location interface — client-side wrappers for the Location interface</p>
33
<td class="gallery_image" valign="top" align="right"></td>
36
<td valign="top" align="right"></td>
34
37
</tr></table></div>
35
<div class="refsect1">
36
<a name="telepathy-glib-connection-location.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
44
<td class="function_type">
45
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
47
<td class="function_name">
48
<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-connect-to-location-updated" title="tp_cli_connection_interface_location_connect_to_location_updated ()">tp_cli_connection_interface_location_connect_to_location_updated</a> <span class="c_punctuation">()</span>
52
<td class="function_type">
53
<span class="returnvalue">void</span>
55
<td class="function_name">
56
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-signal-callback-location-updated" title="tp_cli_connection_interface_location_signal_callback_location_updated ()">*tp_cli_connection_interface_location_signal_callback_location_updated</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
60
<td class="function_type">
61
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
63
<td class="function_name">
64
<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-get-locations" title="tp_cli_connection_interface_location_call_get_locations ()">tp_cli_connection_interface_location_call_get_locations</a> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<span class="returnvalue">void</span>
71
<td class="function_name">
72
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-get-locations" title="tp_cli_connection_interface_location_callback_for_get_locations ()">*tp_cli_connection_interface_location_callback_for_get_locations</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
79
<td class="function_name">
80
<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-request-location" title="tp_cli_connection_interface_location_call_request_location ()">tp_cli_connection_interface_location_call_request_location</a> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<span class="returnvalue">void</span>
87
<td class="function_name">
88
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-request-location" title="tp_cli_connection_interface_location_callback_for_request_location ()">*tp_cli_connection_interface_location_callback_for_request_location</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
92
<td class="function_type">
93
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
95
<td class="function_name">
96
<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-set-location" title="tp_cli_connection_interface_location_call_set_location ()">tp_cli_connection_interface_location_call_set_location</a> <span class="c_punctuation">()</span>
100
<td class="function_type">
101
<span class="returnvalue">void</span>
103
<td class="function_name">
104
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-set-location" title="tp_cli_connection_interface_location_callback_for_set_location ()">*tp_cli_connection_interface_location_callback_for_set_location</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
110
<div class="refsect1">
111
<a name="telepathy-glib-connection-location.object-hierarchy"></a><h2>Object Hierarchy</h2>
115
<div class="refsect1">
116
<a name="telepathy-glib-connection-location.includes"></a><h2>Includes</h2>
117
<pre class="synopsis">#include <telepathy-glib/telepathy-glib-dbus.h>
38
<div class="refsynopsisdiv">
39
<a name="telepathy-glib-connection-location.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
41
#include <telepathy-glib/telepathy-glib-dbus.h>
43
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-connect-to-location-updated" title="tp_cli_connection_interface_location_connect_to_location_updated ()">tp_cli_connection_interface_location_connect_to_location_updated</a>
44
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
45
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-signal-callback-location-updated" title="tp_cli_connection_interface_location_signal_callback_location_updated ()"><span class="type">tp_cli_connection_interface_location_signal_callback_location_updated</span></a> callback</code></em>,
46
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
47
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
48
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
49
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
50
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-signal-callback-location-updated" title="tp_cli_connection_interface_location_signal_callback_location_updated ()">*tp_cli_connection_interface_location_signal_callback_location_updated</a>)
51
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
52
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
53
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Location</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
56
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-get-locations" title="tp_cli_connection_interface_location_call_get_locations ()">tp_cli_connection_interface_location_call_get_locations</a>
57
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
59
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
60
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-get-locations" title="tp_cli_connection_interface_location_callback_for_get_locations ()"><span class="type">tp_cli_connection_interface_location_callback_for_get_locations</span></a> callback</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
62
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
63
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
64
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-get-locations" title="tp_cli_connection_interface_location_callback_for_get_locations ()">*tp_cli_connection_interface_location_callback_for_get_locations</a>)
65
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
66
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Locations</code></em>,
67
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
68
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
69
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
70
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-request-location" title="tp_cli_connection_interface_location_call_request_location ()">tp_cli_connection_interface_location_call_request_location</a>
71
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
72
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
73
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
74
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-request-location" title="tp_cli_connection_interface_location_callback_for_request_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_request_location</span></a> callback</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
77
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
78
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-request-location" title="tp_cli_connection_interface_location_callback_for_request_location ()">*tp_cli_connection_interface_location_callback_for_request_location</a>)
79
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
80
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Location</code></em>,
81
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
82
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
83
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
84
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-call-set-location" title="tp_cli_connection_interface_location_call_set_location ()">tp_cli_connection_interface_location_call_set_location</a>
85
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
86
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
87
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Location</code></em>,
88
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-set-location" title="tp_cli_connection_interface_location_callback_for_set_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_set_location</span></a> callback</code></em>,
89
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
90
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
91
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
92
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-set-location" title="tp_cli_connection_interface_location_callback_for_set_location ()">*tp_cli_connection_interface_location_callback_for_set_location</a>)
93
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
94
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
95
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
96
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
120
99
<div class="refsect1">
121
100
<a name="telepathy-glib-connection-location.description"></a><h2>Description</h2>
122
<p>Some instant messaging protocols support "rich presence" functionality,
102
Some instant messaging protocols support "rich presence" functionality,
123
103
such as geolocation (advertising the user's location to authorized
124
contacts, and receiving contacts' locations).</p>
125
<p>This section documents the auto-generated C wrappers for the
126
Location interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
104
contacts, and receiving contacts' locations).
107
This section documents the auto-generated C wrappers for the
108
Location interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.
128
111
<div class="refsect1">
129
<a name="telepathy-glib-connection-location.functions_details"></a><h2>Functions</h2>
112
<a name="telepathy-glib-connection-location.details"></a><h2>Details</h2>
130
113
<div class="refsect2">
131
<a name="tp-cli-connection-interface-location-connect-to-location-updated"></a><h3>tp_cli_connection_interface_location_connect_to_location_updated ()</h3>
132
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
133
tp_cli_connection_interface_location_connect_to_location_updated
134
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
135
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-signal-callback-location-updated" title="tp_cli_connection_interface_location_signal_callback_location_updated ()"><span class="type">tp_cli_connection_interface_location_signal_callback_location_updated</span></a> callback</code></em>,
136
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
137
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
138
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
139
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
140
<p>Connect a handler to the signal LocationUpdated.</p>
141
<p>Emitted when a contact's location changes or becomes known.</p>
142
<div class="refsect3">
143
<a name="id-1.4.15.7.2.6"></a><h4>Parameters</h4>
144
<div class="informaltable"><table width="100%" border="0">
114
<a name="tp-cli-connection-interface-location-connect-to-location-updated"></a><h3>tp_cli_connection_interface_location_connect_to_location_updated ()</h3>
115
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_location_connect_to_location_updated
116
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
117
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-signal-callback-location-updated" title="tp_cli_connection_interface_location_signal_callback_location_updated ()"><span class="type">tp_cli_connection_interface_location_signal_callback_location_updated</span></a> callback</code></em>,
118
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
119
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
120
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
121
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
123
Connect a handler to the signal LocationUpdated.
126
Emitted when a contact's location changes or becomes known.
128
<div class="variablelist"><table border="0" class="variablelist">
146
<col width="150px" class="parameters_name">
147
<col class="parameters_description">
148
<col width="200px" class="parameters_annotations">
130
<col align="left" valign="top">
152
<td class="parameter_name"><p>proxy</p></td>
153
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</p></td>
154
<td class="parameter_annotations"> </td>
157
<td class="parameter_name"><p>callback</p></td>
158
<td class="parameter_description"><p>Callback to be called when the signal is
160
<td class="parameter_annotations"> </td>
163
<td class="parameter_name"><p>user_data</p></td>
164
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
165
<td class="parameter_annotations"> </td>
168
<td class="parameter_name"><p>destroy</p></td>
169
<td class="parameter_description"><p>Destructor for the user-supplied data, which
135
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
136
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</td>
139
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
140
<td>Callback to be called when the signal is
144
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
145
<td>User-supplied data for the callback</td>
148
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
149
<td>Destructor for the user-supplied data, which
170
150
will be called when this signal is disconnected, or
171
before this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
172
<td class="parameter_annotations"> </td>
151
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>
175
<td class="parameter_name"><p>weak_object</p></td>
176
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced;
155
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
156
<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;
177
157
if it is destroyed, this callback will automatically be
178
disconnected</p></td>
179
<td class="parameter_annotations"> </td>
182
<td class="parameter_name"><p>error</p></td>
183
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
185
<td class="parameter_annotations"> </td>
190
<div class="refsect3">
191
<a name="id-1.4.15.7.2.7"></a><h4>Returns</h4>
192
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
161
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
162
<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
166
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
167
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
193
168
above, which can be used to disconnect the signal; or
194
169
<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
195
or has become invalid.</p>
200
<div class="refsect2">
201
<a name="tp-cli-connection-interface-location-signal-callback-location-updated"></a><h3>tp_cli_connection_interface_location_signal_callback_location_updated ()</h3>
202
<pre class="programlisting"><span class="returnvalue">void</span>
203
<span class="c_punctuation">(</span>*tp_cli_connection_interface_location_signal_callback_location_updated<span class="c_punctuation">)</span>
204
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
205
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
206
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Location</code></em>,
207
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
208
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
209
<p>Represents the signature of a callback for the signal LocationUpdated.</p>
210
<div class="refsect3">
211
<a name="id-1.4.15.7.3.5"></a><h4>Parameters</h4>
212
<div class="informaltable"><table width="100%" border="0">
214
<col width="150px" class="parameters_name">
215
<col class="parameters_description">
216
<col width="200px" class="parameters_annotations">
220
<td class="parameter_name"><p>proxy</p></td>
221
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-connect-to-location-updated" title="tp_cli_connection_interface_location_connect_to_location_updated ()"><code class="function">tp_cli_connection_interface_location_connect_to_location_updated()</code></a>
223
<td class="parameter_annotations"> </td>
226
<td class="parameter_name"><p>arg_Contact</p></td>
227
<td class="parameter_description"><p>The contact (<span class="type">TpContactHandle</span>)</p></td>
228
<td class="parameter_annotations"> </td>
231
<td class="parameter_name"><p>arg_Location</p></td>
232
<td class="parameter_description"><p>The contact's location, or empty to indicate that nothing is known about the contact's location.</p></td>
233
<td class="parameter_annotations"> </td>
236
<td class="parameter_name"><p>user_data</p></td>
237
<td class="parameter_description"><p>User-supplied data</p></td>
238
<td class="parameter_annotations"> </td>
241
<td class="parameter_name"><p>weak_object</p></td>
242
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
243
<td class="parameter_annotations"> </td>
250
<div class="refsect2">
251
<a name="tp-cli-connection-interface-location-call-get-locations"></a><h3>tp_cli_connection_interface_location_call_get_locations ()</h3>
252
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
253
tp_cli_connection_interface_location_call_get_locations
254
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
255
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
256
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
257
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-get-locations" title="tp_cli_connection_interface_location_callback_for_get_locations ()"><span class="type">tp_cli_connection_interface_location_callback_for_get_locations</span></a> callback</code></em>,
258
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
259
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
260
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
261
<p>Start a GetLocations method call.</p>
262
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Return the current locations of the given contacts, if they are already known. If any of the given contacts' locations are not known, request their current locations, but return immediately without waiting for a reply; if a reply with a non-empty location is later received for those contacts, the <tp:member-ref>LocationUpdated</tp:member-ref> signal will be emitted for them.</p> <tp:rationale> <p>This method is appropriate for &quot;lazy&quot; location finding, for instance displaying the location (if available) of everyone in your contact list.</p> </tp:rationale> <p>For backwards compatibility, if this method is called by a client whose &quot;interest count&quot; for this interface, as defined by <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.AddClientInterest</tp:dbus-ref>, is zero, the Connection SHOULD behave as if AddClientInterest had been called for this interface just before that method call. Clients that do not explicitly call AddClientInterest SHOULD NOT call <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.RemoveClientInterest</tp:dbus-ref> either.</p></p>
263
<div class="refsect3">
264
<a name="id-1.4.15.7.4.6"></a><h4>Parameters</h4>
265
<div class="informaltable"><table width="100%" border="0">
267
<col width="150px" class="parameters_name">
268
<col class="parameters_description">
269
<col width="200px" class="parameters_annotations">
273
<td class="parameter_name"><p>proxy</p></td>
274
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
275
<td class="parameter_annotations"> </td>
278
<td class="parameter_name"><p>timeout_ms</p></td>
279
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
281
<td class="parameter_annotations"> </td>
284
<td class="parameter_name"><p>in_Contacts</p></td>
285
<td class="parameter_description"><p>Used to pass an 'in' argument: The contacts whose locations should be returned or signalled.</p></td>
286
<td class="parameter_annotations"> </td>
289
<td class="parameter_name"><p>callback</p></td>
290
<td class="parameter_description"><p>called when the method call succeeds or fails;
291
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
292
reply tracking</p></td>
293
<td class="parameter_annotations"> </td>
296
<td class="parameter_name"><p>user_data</p></td>
297
<td class="parameter_description"><p>user-supplied data passed to the callback;
298
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>
299
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
300
<td class="parameter_annotations"> </td>
303
<td class="parameter_name"><p>destroy</p></td>
304
<td class="parameter_description"><p>called with the user_data as argument, after the
305
call has succeeded, failed or been cancelled;
306
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>
307
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
308
<td class="parameter_annotations"> </td>
311
<td class="parameter_name"><p>weak_object</p></td>
312
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
313
weakly referenced; if it is destroyed, this call
314
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
315
<em class="parameter"><code>callback</code></em>
316
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
317
<td class="parameter_annotations"> </td>
322
<div class="refsect3">
323
<a name="id-1.4.15.7.4.7"></a><h4>Returns</h4>
324
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
325
progress. It is borrowed from the object, and will become
326
invalid when the callback is called, the call is
327
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
332
<div class="refsect2">
333
<a name="tp-cli-connection-interface-location-callback-for-get-locations"></a><h3>tp_cli_connection_interface_location_callback_for_get_locations ()</h3>
334
<pre class="programlisting"><span class="returnvalue">void</span>
335
<span class="c_punctuation">(</span>*tp_cli_connection_interface_location_callback_for_get_locations<span class="c_punctuation">)</span>
336
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
337
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Locations</code></em>,
338
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
339
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
340
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
341
<p>Signature of the callback called when a GetLocations method call
342
succeeds or fails.</p>
343
<div class="refsect3">
344
<a name="id-1.4.15.7.5.5"></a><h4>Parameters</h4>
345
<div class="informaltable"><table width="100%" border="0">
347
<col width="150px" class="parameters_name">
348
<col class="parameters_description">
349
<col width="200px" class="parameters_annotations">
353
<td class="parameter_name"><p>proxy</p></td>
354
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
355
<td class="parameter_annotations"> </td>
358
<td class="parameter_name"><p>out_Locations</p></td>
359
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
360
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contacts' locations, if already known. Contacts whose locations are not already known are omitted from the mapping; contacts known to have no location information appear in the mapping with an empty Location dictionary.</p></td>
361
<td class="parameter_annotations"> </td>
364
<td class="parameter_name"><p>error</p></td>
365
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
366
<td class="parameter_annotations"> </td>
369
<td class="parameter_name"><p>user_data</p></td>
370
<td class="parameter_description"><p>user-supplied data</p></td>
371
<td class="parameter_annotations"> </td>
374
<td class="parameter_name"><p>weak_object</p></td>
375
<td class="parameter_description"><p>user-supplied object</p></td>
376
<td class="parameter_annotations"> </td>
383
<div class="refsect2">
384
<a name="tp-cli-connection-interface-location-call-request-location"></a><h3>tp_cli_connection_interface_location_call_request_location ()</h3>
385
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
386
tp_cli_connection_interface_location_call_request_location
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
389
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
390
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-request-location" title="tp_cli_connection_interface_location_callback_for_request_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_request_location</span></a> callback</code></em>,
391
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
392
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
393
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
394
<p>Start a RequestLocation method call.</p>
395
<p>Return the current location of the given contact. If necessary, make a request to the server for up-to-date information, and wait for a reply. <tp:rationale> This method is appropriate for use in a &quot;Contact Information...&quot; dialog; it can be used to show progress information (while waiting for the method to return), and can distinguish between various error conditions. </tp:rationale></p>
396
<div class="refsect3">
397
<a name="id-1.4.15.7.6.6"></a><h4>Parameters</h4>
398
<div class="informaltable"><table width="100%" border="0">
400
<col width="150px" class="parameters_name">
401
<col class="parameters_description">
402
<col width="200px" class="parameters_annotations">
406
<td class="parameter_name"><p>proxy</p></td>
407
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
408
<td class="parameter_annotations"> </td>
411
<td class="parameter_name"><p>timeout_ms</p></td>
412
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
414
<td class="parameter_annotations"> </td>
417
<td class="parameter_name"><p>in_Contact</p></td>
418
<td class="parameter_description"><p>Used to pass an 'in' argument: The contact whose location should be returned. (<span class="type">TpContactHandle</span>)</p></td>
419
<td class="parameter_annotations"> </td>
422
<td class="parameter_name"><p>callback</p></td>
423
<td class="parameter_description"><p>called when the method call succeeds or fails;
424
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
425
reply tracking</p></td>
426
<td class="parameter_annotations"> </td>
429
<td class="parameter_name"><p>user_data</p></td>
430
<td class="parameter_description"><p>user-supplied data passed to the callback;
431
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>
432
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
433
<td class="parameter_annotations"> </td>
436
<td class="parameter_name"><p>destroy</p></td>
437
<td class="parameter_description"><p>called with the user_data as argument, after the
438
call has succeeded, failed or been cancelled;
439
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>
440
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
441
<td class="parameter_annotations"> </td>
444
<td class="parameter_name"><p>weak_object</p></td>
445
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
446
weakly referenced; if it is destroyed, this call
447
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
448
<em class="parameter"><code>callback</code></em>
449
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
450
<td class="parameter_annotations"> </td>
455
<div class="refsect3">
456
<a name="id-1.4.15.7.6.7"></a><h4>Returns</h4>
457
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
458
progress. It is borrowed from the object, and will become
459
invalid when the callback is called, the call is
460
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
465
<div class="refsect2">
466
<a name="tp-cli-connection-interface-location-callback-for-request-location"></a><h3>tp_cli_connection_interface_location_callback_for_request_location ()</h3>
467
<pre class="programlisting"><span class="returnvalue">void</span>
468
<span class="c_punctuation">(</span>*tp_cli_connection_interface_location_callback_for_request_location<span class="c_punctuation">)</span>
469
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
470
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Location</code></em>,
471
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
472
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
473
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
474
<div class="warning"><p><code class="literal">tp_cli_connection_interface_location_callback_for_request_location</code> is deprecated and should not be used in newly-written code.</p></div>
475
<p>Signature of the callback called when a RequestLocation method call
476
succeeds or fails.</p>
477
<div class="refsect3">
478
<a name="id-1.4.15.7.7.6"></a><h4>Parameters</h4>
479
<div class="informaltable"><table width="100%" border="0">
481
<col width="150px" class="parameters_name">
482
<col class="parameters_description">
483
<col width="200px" class="parameters_annotations">
487
<td class="parameter_name"><p>proxy</p></td>
488
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
489
<td class="parameter_annotations"> </td>
492
<td class="parameter_name"><p>out_Location</p></td>
493
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
494
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The contact's location. It MAY be empty, indicating that no location information was found.</p></td>
495
<td class="parameter_annotations"> </td>
498
<td class="parameter_name"><p>error</p></td>
499
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
500
<td class="parameter_annotations"> </td>
503
<td class="parameter_name"><p>user_data</p></td>
504
<td class="parameter_description"><p>user-supplied data</p></td>
505
<td class="parameter_annotations"> </td>
508
<td class="parameter_name"><p>weak_object</p></td>
509
<td class="parameter_description"><p>user-supplied object</p></td>
510
<td class="parameter_annotations"> </td>
517
<div class="refsect2">
518
<a name="tp-cli-connection-interface-location-call-set-location"></a><h3>tp_cli_connection_interface_location_call_set_location ()</h3>
519
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
520
tp_cli_connection_interface_location_call_set_location
521
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
522
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
523
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Location</code></em>,
524
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-set-location" title="tp_cli_connection_interface_location_callback_for_set_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_set_location</span></a> callback</code></em>,
525
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
526
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
527
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
528
<p>Start a SetLocation method call.</p>
529
<p>Set the local user's own location.</p>
530
<div class="refsect3">
531
<a name="id-1.4.15.7.8.6"></a><h4>Parameters</h4>
532
<div class="informaltable"><table width="100%" border="0">
534
<col width="150px" class="parameters_name">
535
<col class="parameters_description">
536
<col width="200px" class="parameters_annotations">
540
<td class="parameter_name"><p>proxy</p></td>
541
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
542
<td class="parameter_annotations"> </td>
545
<td class="parameter_name"><p>timeout_ms</p></td>
546
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
548
<td class="parameter_annotations"> </td>
551
<td class="parameter_name"><p>in_Location</p></td>
552
<td class="parameter_description"><p>Used to pass an 'in' argument: The location to advertise. If the user wants to obscure their exact location by reducing the precision or accuracy, clients MUST do this themselves, rather than relying on the connection manager to do so. Clients that interact with more than one connection SHOULD advertise the same reduced-accuracy location to all of them, so that contacts cannot obtain an undesirably accurate location by assuming that random errors have been added and averaging the locations advertised on multiple connections.</p></td>
553
<td class="parameter_annotations"> </td>
556
<td class="parameter_name"><p>callback</p></td>
557
<td class="parameter_description"><p>called when the method call succeeds or fails;
558
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
559
reply tracking</p></td>
560
<td class="parameter_annotations"> </td>
563
<td class="parameter_name"><p>user_data</p></td>
564
<td class="parameter_description"><p>user-supplied data passed to the callback;
565
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>
566
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
567
<td class="parameter_annotations"> </td>
570
<td class="parameter_name"><p>destroy</p></td>
571
<td class="parameter_description"><p>called with the user_data as argument, after the
572
call has succeeded, failed or been cancelled;
573
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>
574
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
575
<td class="parameter_annotations"> </td>
578
<td class="parameter_name"><p>weak_object</p></td>
579
<td class="parameter_description"><p>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be
580
weakly referenced; if it is destroyed, this call
581
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
582
<em class="parameter"><code>callback</code></em>
583
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
584
<td class="parameter_annotations"> </td>
589
<div class="refsect3">
590
<a name="id-1.4.15.7.8.7"></a><h4>Returns</h4>
591
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
592
progress. It is borrowed from the object, and will become
593
invalid when the callback is called, the call is
594
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
599
<div class="refsect2">
600
<a name="tp-cli-connection-interface-location-callback-for-set-location"></a><h3>tp_cli_connection_interface_location_callback_for_set_location ()</h3>
601
<pre class="programlisting"><span class="returnvalue">void</span>
602
<span class="c_punctuation">(</span>*tp_cli_connection_interface_location_callback_for_set_location<span class="c_punctuation">)</span>
603
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
604
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
605
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
606
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
607
<div class="warning"><p><code class="literal">tp_cli_connection_interface_location_callback_for_set_location</code> is deprecated and should not be used in newly-written code.</p></div>
608
<p>Signature of the callback called when a SetLocation method call
609
succeeds or fails.</p>
610
<div class="refsect3">
611
<a name="id-1.4.15.7.9.6"></a><h4>Parameters</h4>
612
<div class="informaltable"><table width="100%" border="0">
614
<col width="150px" class="parameters_name">
615
<col class="parameters_description">
616
<col width="200px" class="parameters_annotations">
620
<td class="parameter_name"><p>proxy</p></td>
621
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
622
<td class="parameter_annotations"> </td>
625
<td class="parameter_name"><p>error</p></td>
626
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</p></td>
627
<td class="parameter_annotations"> </td>
630
<td class="parameter_name"><p>user_data</p></td>
631
<td class="parameter_description"><p>user-supplied data</p></td>
632
<td class="parameter_annotations"> </td>
635
<td class="parameter_name"><p>weak_object</p></td>
636
<td class="parameter_description"><p>user-supplied object</p></td>
637
<td class="parameter_annotations"> </td>
644
<div class="refsect1">
645
<a name="telepathy-glib-connection-location.other_details"></a><h2>Types and Values</h2>
170
or has become invalid.</td>
176
<div class="refsect2">
177
<a name="tp-cli-connection-interface-location-signal-callback-location-updated"></a><h3>tp_cli_connection_interface_location_signal_callback_location_updated ()</h3>
178
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_location_signal_callback_location_updated)
179
(<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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
181
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *arg_Location</code></em>,
182
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
183
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
185
Represents the signature of a callback for the signal LocationUpdated.
187
<div class="variablelist"><table border="0" class="variablelist">
189
<col align="left" valign="top">
194
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
195
<td>The proxy on which <a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-connect-to-location-updated" title="tp_cli_connection_interface_location_connect_to_location_updated ()"><code class="function">tp_cli_connection_interface_location_connect_to_location_updated()</code></a>
199
<td><p><span class="term"><em class="parameter"><code>arg_Contact</code></em> :</span></p></td>
200
<td>The contact (<span class="type">TpContactHandle</span>)</td>
203
<td><p><span class="term"><em class="parameter"><code>arg_Location</code></em> :</span></p></td>
204
<td>The contact's location, or empty to indicate that nothing is known about the contact's location.</td>
207
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
208
<td>User-supplied data</td>
211
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
212
<td>User-supplied weakly referenced object</td>
218
<div class="refsect2">
219
<a name="tp-cli-connection-interface-location-call-get-locations"></a><h3>tp_cli_connection_interface_location_call_get_locations ()</h3>
220
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_location_call_get_locations
221
(<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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
223
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *in_Contacts</code></em>,
224
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-get-locations" title="tp_cli_connection_interface_location_callback_for_get_locations ()"><span class="type">tp_cli_connection_interface_location_callback_for_get_locations</span></a> callback</code></em>,
225
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
226
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
227
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
229
Start a GetLocations method call.
232
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Return the current locations of the given contacts, if they are already known. If any of the given contacts' locations are not known, request their current locations, but return immediately without waiting for a reply; if a reply with a non-empty location is later received for those contacts, the <tp:member-ref>LocationUpdated</tp:member-ref> signal will be emitted for them.</p> <tp:rationale> <p>This method is appropriate for &quot;lazy&quot; location finding, for instance displaying the location (if available) of everyone in your contact list.</p> </tp:rationale> <p>For backwards compatibility, if this method is called by a client whose &quot;interest count&quot; for this interface, as defined by <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.AddClientInterest</tp:dbus-ref>, is zero, the Connection SHOULD behave as if AddClientInterest had been called for this interface just before that method call. Clients that do not explicitly call AddClientInterest SHOULD NOT call <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.RemoveClientInterest</tp:dbus-ref> either.</p>
234
<div class="variablelist"><table border="0" class="variablelist">
236
<col align="left" valign="top">
241
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
242
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
246
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
247
<td>the timeout in milliseconds, or -1 to use the
251
<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
252
<td>Used to pass an 'in' argument: The contacts whose locations should be returned or signalled.</td>
255
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
256
<td>called when the method call succeeds or fails;
257
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
261
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
262
<td>user-supplied data passed to the callback;
263
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>
267
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
268
<td>called with the user_data as argument, after the
269
call has succeeded, failed or been cancelled;
270
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>
274
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
275
<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
276
weakly referenced; if it is destroyed, this call
277
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
278
<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>
282
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
283
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
284
progress. It is borrowed from the object, and will become
285
invalid when the callback is called, the call is
286
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
292
<div class="refsect2">
293
<a name="tp-cli-connection-interface-location-callback-for-get-locations"></a><h3>tp_cli_connection_interface_location_callback_for_get_locations ()</h3>
294
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_location_callback_for_get_locations)
295
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
296
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Locations</code></em>,
297
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
298
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
299
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
301
Signature of the callback called when a GetLocations method call
304
<div class="variablelist"><table border="0" class="variablelist">
306
<col align="left" valign="top">
311
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
312
<td>the proxy on which the call was made</td>
315
<td><p><span class="term"><em class="parameter"><code>out_Locations</code></em> :</span></p></td>
316
<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 contacts' locations, if already known. Contacts whose locations are not already known are omitted from the mapping; contacts known to have no location information appear in the mapping with an empty Location dictionary.</td>
319
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
321
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
324
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
325
<td>user-supplied data</td>
328
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
329
<td>user-supplied object</td>
335
<div class="refsect2">
336
<a name="tp-cli-connection-interface-location-call-request-location"></a><h3>tp_cli_connection_interface_location_call_request_location ()</h3>
337
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_location_call_request_location
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
340
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_Contact</code></em>,
341
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-request-location" title="tp_cli_connection_interface_location_callback_for_request_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_request_location</span></a> callback</code></em>,
342
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
343
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
344
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
346
Start a RequestLocation method call.
349
Return the current location of the given contact. If necessary, make a request to the server for up-to-date information, and wait for a reply. <tp:rationale> This method is appropriate for use in a &quot;Contact Information...&quot; dialog; it can be used to show progress information (while waiting for the method to return), and can distinguish between various error conditions. </tp:rationale>
351
<div class="variablelist"><table border="0" class="variablelist">
353
<col align="left" valign="top">
358
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
359
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
363
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
364
<td>the timeout in milliseconds, or -1 to use the
368
<td><p><span class="term"><em class="parameter"><code>in_Contact</code></em> :</span></p></td>
369
<td>Used to pass an 'in' argument: The contact whose location should be returned. (<span class="type">TpContactHandle</span>)</td>
372
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
373
<td>called when the method call succeeds or fails;
374
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
378
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
379
<td>user-supplied data passed to the callback;
380
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>
384
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
385
<td>called with the user_data as argument, after the
386
call has succeeded, failed or been cancelled;
387
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>
391
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
392
<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
393
weakly referenced; if it is destroyed, this call
394
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
395
<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>
399
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
400
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
401
progress. It is borrowed from the object, and will become
402
invalid when the callback is called, the call is
403
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
409
<div class="refsect2">
410
<a name="tp-cli-connection-interface-location-callback-for-request-location"></a><h3>tp_cli_connection_interface_location_callback_for_request_location ()</h3>
411
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_location_callback_for_request_location)
412
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
413
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Location</code></em>,
414
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
415
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
416
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
418
Signature of the callback called when a RequestLocation method call
421
<div class="variablelist"><table border="0" class="variablelist">
423
<col align="left" valign="top">
428
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
429
<td>the proxy on which the call was made</td>
432
<td><p><span class="term"><em class="parameter"><code>out_Location</code></em> :</span></p></td>
433
<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 contact's location. It MAY be empty, indicating that no location information was found.</td>
436
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
438
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
441
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
442
<td>user-supplied data</td>
445
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
446
<td>user-supplied object</td>
452
<div class="refsect2">
453
<a name="tp-cli-connection-interface-location-call-set-location"></a><h3>tp_cli_connection_interface_location_call_set_location ()</h3>
454
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_location_call_set_location
455
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
456
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
457
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *in_Location</code></em>,
458
<em class="parameter"><code><a class="link" href="telepathy-glib-connection-location.html#tp-cli-connection-interface-location-callback-for-set-location" title="tp_cli_connection_interface_location_callback_for_set_location ()"><span class="type">tp_cli_connection_interface_location_callback_for_set_location</span></a> callback</code></em>,
459
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
460
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
461
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
463
Start a SetLocation method call.
466
Set the local user's own location.
468
<div class="variablelist"><table border="0" class="variablelist">
470
<col align="left" valign="top">
475
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
476
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
480
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
481
<td>the timeout in milliseconds, or -1 to use the
485
<td><p><span class="term"><em class="parameter"><code>in_Location</code></em> :</span></p></td>
486
<td>Used to pass an 'in' argument: The location to advertise. If the user wants to obscure their exact location by reducing the precision or accuracy, clients MUST do this themselves, rather than relying on the connection manager to do so. Clients that interact with more than one connection SHOULD advertise the same reduced-accuracy location to all of them, so that contacts cannot obtain an undesirably accurate location by assuming that random errors have been added and averaging the locations advertised on multiple connections.</td>
489
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
490
<td>called when the method call succeeds or fails;
491
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
495
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
496
<td>user-supplied data passed to the callback;
497
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>
501
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
502
<td>called with the user_data as argument, after the
503
call has succeeded, failed or been cancelled;
504
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>
508
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
509
<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
510
weakly referenced; if it is destroyed, this call
511
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
512
<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>
516
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
517
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
518
progress. It is borrowed from the object, and will become
519
invalid when the callback is called, the call is
520
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
526
<div class="refsect2">
527
<a name="tp-cli-connection-interface-location-callback-for-set-location"></a><h3>tp_cli_connection_interface_location_callback_for_set_location ()</h3>
528
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_connection_interface_location_callback_for_set_location)
529
(<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
530
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
531
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
532
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
534
Signature of the callback called when a SetLocation method call
537
<div class="variablelist"><table border="0" class="variablelist">
539
<col align="left" valign="top">
544
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
545
<td>the proxy on which the call was made</td>
548
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
550
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure</td>
553
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
554
<td>user-supplied data</td>
557
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
558
<td>user-supplied object</td>
647
564
<div class="refsect1">
648
565
<a name="telepathy-glib-connection-location.see-also"></a><h2>See Also</h2>
649
<p><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a></p>
566
<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a>
652
569
<div class="footer">
654
Generated by GTK-Doc V1.20</div>
571
Generated by GTK-Doc V1.19</div>
b'\\ No newline at end of file'