~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Simon McVittie
  • Date: 2014-09-16 15:49:50 UTC
  • mfrom: (60.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20140916154950-krvowuvofhu8u6sp
Tags: 0.24.1-1
* New upstream stable release
* debian/copyright: clean up syntax (*.[ch] is unsupported),
  drop deleted files
* debian/watch: only match 0.x versions, 1.0 will be a separate
  source package

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>telepathy-glib API Reference Manual: Connection ClientTypes interface</title>
 
5
<title>Connection ClientTypes interface</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
8
8
<link rel="up" href="ch-client.html" title="Client-side proxies">
9
9
<link rel="prev" href="telepathy-glib-connection-balance.html" title="Connection Balance interface">
10
10
<link rel="next" href="telepathy-glib-connection-contacts.html" title="Connection Contacts interface">
11
 
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left" class="shortcuts">
17
 
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
 
                  <a href="#telepathy-glib-connection-client-types.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
 
                  <a href="#telepathy-glib-connection-client-types.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
20
 
</td>
21
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
 
<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23
 
<td><a accesskey="p" href="telepathy-glib-connection-balance.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
 
<td><a accesskey="n" href="telepathy-glib-connection-contacts.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25
 
</tr></table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="telepathy-glib-connection-balance.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">telepathy-glib API Reference Manual</th>
 
21
<td><a accesskey="n" href="telepathy-glib-connection-contacts.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#telepathy-glib-connection-client-types.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#telepathy-glib-connection-client-types.description" class="shortcut">Description</a>
 
27
</td></tr>
 
28
</table>
26
29
<div class="refentry">
27
30
<a name="telepathy-glib-connection-client-types"></a><div class="titlepage"></div>
28
31
<div class="refnamediv"><table width="100%"><tr>
30
33
<h2><span class="refentrytitle"><a name="telepathy-glib-connection-client-types.top_of_page"></a>Connection ClientTypes interface</span></h2>
31
34
<p>Connection ClientTypes interface — client-side wrappers for the ClientTypes interface</p>
32
35
</td>
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-client-types.functions"></a><h2>Functions</h2>
37
 
<div class="informaltable"><table width="100%" border="0">
38
 
<colgroup>
39
 
<col width="150px" class="functions_return">
40
 
<col class="functions_name">
41
 
</colgroup>
42
 
<tbody>
43
 
<tr>
44
 
<td class="function_type">
45
 
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
46
 
</td>
47
 
<td class="function_name">
48
 
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-get-client-types" title="tp_cli_connection_interface_client_types_call_get_client_types ()">tp_cli_connection_interface_client_types_call_get_client_types</a> <span class="c_punctuation">()</span>
49
 
</td>
50
 
</tr>
51
 
<tr>
52
 
<td class="function_type">
53
 
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
54
 
</td>
55
 
<td class="function_name">
56
 
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-request-client-types" title="tp_cli_connection_interface_client_types_call_request_client_types ()">tp_cli_connection_interface_client_types_call_request_client_types</a> <span class="c_punctuation">()</span>
57
 
</td>
58
 
</tr>
59
 
<tr>
60
 
<td class="function_type">
61
 
<span class="returnvalue">void</span>
62
 
</td>
63
 
<td class="function_name">
64
 
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()">*tp_cli_connection_interface_client_types_callback_for_get_client_types</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
65
 
</td>
66
 
</tr>
67
 
<tr>
68
 
<td class="function_type">
69
 
<span class="returnvalue">void</span>
70
 
</td>
71
 
<td class="function_name">
72
 
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()">*tp_cli_connection_interface_client_types_callback_for_request_client_types</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
73
 
</td>
74
 
</tr>
75
 
<tr>
76
 
<td class="function_type">
77
 
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
78
 
</td>
79
 
<td class="function_name">
80
 
<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()">tp_cli_connection_interface_client_types_connect_to_client_types_updated</a> <span class="c_punctuation">()</span>
81
 
</td>
82
 
</tr>
83
 
<tr>
84
 
<td class="function_type">
85
 
<span class="returnvalue">void</span>
86
 
</td>
87
 
<td class="function_name">
88
 
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()">*tp_cli_connection_interface_client_types_signal_callback_client_types_updated</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
89
 
</td>
90
 
</tr>
91
 
</tbody>
92
 
</table></div>
93
 
</div>
94
 
<div class="refsect1">
95
 
<a name="telepathy-glib-connection-client-types.object-hierarchy"></a><h2>Object Hierarchy</h2>
96
 
<pre class="screen">
97
 
</pre>
98
 
</div>
99
 
<div class="refsect1">
100
 
<a name="telepathy-glib-connection-client-types.includes"></a><h2>Includes</h2>
101
 
<pre class="synopsis">#include &lt;telepathy-glib/telepathy-glib-dbus.h&gt;
 
38
<div class="refsynopsisdiv">
 
39
<a name="telepathy-glib-connection-client-types.synopsis"></a><h2>Synopsis</h2>
 
40
<pre class="synopsis">
 
41
#include &lt;telepathy-glib/telepathy-glib-dbus.h&gt;
 
42
 
 
43
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-get-client-types" title="tp_cli_connection_interface_client_types_call_get_client_types ()">tp_cli_connection_interface_client_types_call_get_client_types</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 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
46
                                                         <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>,
 
47
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
 
48
                                                         <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>,
 
49
                                                         <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>,
 
50
                                                         <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>);
 
51
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-call-request-client-types" title="tp_cli_connection_interface_client_types_call_request_client_types ()">tp_cli_connection_interface_client_types_call_request_client_types</a>
 
52
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
53
                                                         <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>,
 
54
                                                         <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>,
 
55
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</code></em>,
 
56
                                                         <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>,
 
57
                                                         <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>,
 
58
                                                         <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>);
 
59
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()">*tp_cli_connection_interface_client_types_callback_for_get_client_types</a>)
 
60
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
61
                                                         <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_Client_Types</code></em>,
 
62
                                                         <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>,
 
63
                                                         <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>,
 
64
                                                         <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>);
 
65
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()">*tp_cli_connection_interface_client_types_callback_for_request_client_types</a>)
 
66
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
67
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Client_Types</code></em>,
 
68
                                                         <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>,
 
69
                                                         <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>,
 
70
                                                         <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>);
 
71
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()">tp_cli_connection_interface_client_types_connect_to_client_types_updated</a>
 
72
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
73
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
 
74
                                                         <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>,
 
75
                                                         <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>,
 
76
                                                         <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>,
 
77
                                                         <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>);
 
78
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()">*tp_cli_connection_interface_client_types_signal_callback_client_types_updated</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-Basic-Types.html#guint"><span class="type">guint</span></a> arg_Contact</code></em>,
 
81
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **arg_Client_Types</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>);
102
84
</pre>
103
85
</div>
104
86
<div class="refsect1">
105
87
<a name="telepathy-glib-connection-client-types.description"></a><h2>Description</h2>
106
 
<p>On some protocols it's possible to determine the type of client another
 
88
<p>
 
89
On some protocols it's possible to determine the type of client another
107
90
user is using, ranging from a simple "phone or not?" indicator to a
108
91
classification into several types of user interface. Telepathy represents
109
 
these using the client types defined by XMPP.</p>
110
 
<p>This section documents the auto-generated C wrappers for the
111
 
ClientTypes interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.</p>
 
92
these using the client types defined by XMPP.
 
93
</p>
 
94
<p>
 
95
This section documents the auto-generated C wrappers for the
 
96
ClientTypes interface, used with <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> objects.
 
97
</p>
112
98
</div>
113
99
<div class="refsect1">
114
 
<a name="telepathy-glib-connection-client-types.functions_details"></a><h2>Functions</h2>
115
 
<div class="refsect2">
116
 
<a name="tp-cli-connection-interface-client-types-call-get-client-types"></a><h3>tp_cli_connection_interface_client_types_call_get_client_types ()</h3>
117
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
118
 
tp_cli_connection_interface_client_types_call_get_client_types
119
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
120
 
                                <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>,
121
 
                                <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>,
122
 
                                <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
123
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
124
 
                                <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>,
125
 
                                <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>
126
 
<p>Start a GetClientTypes method call.</p>
127
 
<p>Return the client types of the given contacts, if they are         already known. If any of the given contacts' client types are         not known, request their current client types, but return         immediately without waiting for a reply; if a reply with a         non-empty client type array is later received for those         contacts, the         &lt;tp:member-ref&gt;ClientTypesUpdated&lt;/tp:member-ref&gt; signal will         be emitted for them.          &lt;tp:rationale&gt;           This method is appropriate for &amp;quot;lazy&amp;quot; client type finding, for instance           displaying the client types (if available) of everyone in your contact           list.         &lt;/tp:rationale&gt;</p>
128
 
<div class="refsect3">
129
 
<a name="id-1.4.10.7.2.6"></a><h4>Parameters</h4>
130
 
<div class="informaltable"><table width="100%" border="0">
131
 
<colgroup>
132
 
<col width="150px" class="parameters_name">
133
 
<col class="parameters_description">
134
 
<col width="200px" class="parameters_annotations">
135
 
</colgroup>
136
 
<tbody>
137
 
<tr>
138
 
<td class="parameter_name"><p>proxy</p></td>
139
 
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
140
 
<td class="parameter_annotations"> </td>
141
 
</tr>
142
 
<tr>
143
 
<td class="parameter_name"><p>timeout_ms</p></td>
144
 
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
145
 
default</p></td>
146
 
<td class="parameter_annotations"> </td>
147
 
</tr>
148
 
<tr>
149
 
<td class="parameter_name"><p>in_Contacts</p></td>
150
 
<td class="parameter_description"><p>Used to pass an 'in' argument: The contacts whose client types should be returned or signalled.</p></td>
151
 
<td class="parameter_annotations"> </td>
152
 
</tr>
153
 
<tr>
154
 
<td class="parameter_name"><p>callback</p></td>
155
 
<td class="parameter_description"><p>called when the method call succeeds or fails;
156
 
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
157
 
reply tracking</p></td>
158
 
<td class="parameter_annotations"> </td>
159
 
</tr>
160
 
<tr>
161
 
<td class="parameter_name"><p>user_data</p></td>
162
 
<td class="parameter_description"><p>user-supplied data passed to the callback;
163
 
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>
164
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
165
 
<td class="parameter_annotations"> </td>
166
 
</tr>
167
 
<tr>
168
 
<td class="parameter_name"><p>destroy</p></td>
169
 
<td class="parameter_description"><p>called with the user_data as argument, after the
170
 
call has succeeded, failed or been cancelled;
171
 
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>
172
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
173
 
<td class="parameter_annotations"> </td>
174
 
</tr>
175
 
<tr>
176
 
<td class="parameter_name"><p>weak_object</p></td>
177
 
<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
178
 
weakly referenced; if it is destroyed, this call
179
 
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
180
 
<em class="parameter"><code>callback</code></em>
181
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
182
 
<td class="parameter_annotations"> </td>
183
 
</tr>
184
 
</tbody>
185
 
</table></div>
186
 
</div>
187
 
<div class="refsect3">
188
 
<a name="id-1.4.10.7.2.7"></a><h4>Returns</h4>
189
 
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
190
 
progress. It is borrowed from the object, and will become
191
 
invalid when the callback is called, the call is
192
 
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
193
 
<p></p>
194
 
</div>
195
 
</div>
196
 
<hr>
197
 
<div class="refsect2">
198
 
<a name="tp-cli-connection-interface-client-types-call-request-client-types"></a><h3>tp_cli_connection_interface_client_types_call_request_client_types ()</h3>
199
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
200
 
tp_cli_connection_interface_client_types_call_request_client_types
201
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
202
 
                                <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>,
203
 
                                <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>,
204
 
                                <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</code></em>,
205
 
                                <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>,
206
 
                                <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>,
207
 
                                <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>
208
 
<p>Start a RequestClientTypes method call.</p>
209
 
<p>Return the current client types of the given contact. If necessary, make         a request to the server for up-to-date information, and wait for a         reply.          &lt;tp:rationale&gt;           This method is appropriate for use in a &amp;quot;Contact Information...&amp;quot;           dialog; it can be used to show progress information (while waiting           for the method to return), and can distinguish between various error           conditions.         &lt;/tp:rationale&gt;</p>
210
 
<div class="refsect3">
211
 
<a name="id-1.4.10.7.3.6"></a><h4>Parameters</h4>
212
 
<div class="informaltable"><table width="100%" border="0">
213
 
<colgroup>
214
 
<col width="150px" class="parameters_name">
215
 
<col class="parameters_description">
216
 
<col width="200px" class="parameters_annotations">
217
 
</colgroup>
218
 
<tbody>
219
 
<tr>
220
 
<td class="parameter_name"><p>proxy</p></td>
221
 
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
222
 
<td class="parameter_annotations"> </td>
223
 
</tr>
224
 
<tr>
225
 
<td class="parameter_name"><p>timeout_ms</p></td>
226
 
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
227
 
default</p></td>
228
 
<td class="parameter_annotations"> </td>
229
 
</tr>
230
 
<tr>
231
 
<td class="parameter_name"><p>in_Contact</p></td>
232
 
<td class="parameter_description"><p>Used to pass an 'in' argument: The contact whose client types should be returned. (<span class="type">TpContactHandle</span>)</p></td>
233
 
<td class="parameter_annotations"> </td>
234
 
</tr>
235
 
<tr>
236
 
<td class="parameter_name"><p>callback</p></td>
237
 
<td class="parameter_description"><p>called when the method call succeeds or fails;
238
 
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
239
 
reply tracking</p></td>
240
 
<td class="parameter_annotations"> </td>
241
 
</tr>
242
 
<tr>
243
 
<td class="parameter_name"><p>user_data</p></td>
244
 
<td class="parameter_description"><p>user-supplied data passed to the callback;
245
 
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>
246
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
247
 
<td class="parameter_annotations"> </td>
248
 
</tr>
249
 
<tr>
250
 
<td class="parameter_name"><p>destroy</p></td>
251
 
<td class="parameter_description"><p>called with the user_data as argument, after the
252
 
call has succeeded, failed or been cancelled;
253
 
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>
254
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
255
 
<td class="parameter_annotations"> </td>
256
 
</tr>
257
 
<tr>
258
 
<td class="parameter_name"><p>weak_object</p></td>
259
 
<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
260
 
weakly referenced; if it is destroyed, this call
261
 
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
262
 
<em class="parameter"><code>callback</code></em>
263
 
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
264
 
<td class="parameter_annotations"> </td>
265
 
</tr>
266
 
</tbody>
267
 
</table></div>
268
 
</div>
269
 
<div class="refsect3">
270
 
<a name="id-1.4.10.7.3.7"></a><h4>Returns</h4>
271
 
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
272
 
progress. It is borrowed from the object, and will become
273
 
invalid when the callback is called, the call is
274
 
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
275
 
<p></p>
276
 
</div>
277
 
</div>
278
 
<hr>
279
 
<div class="refsect2">
280
 
<a name="tp-cli-connection-interface-client-types-callback-for-get-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_get_client_types ()</h3>
281
 
<pre class="programlisting"><span class="returnvalue">void</span>
282
 
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_callback_for_get_client_types<span class="c_punctuation">)</span>
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><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *out_Client_Types</code></em>,
285
 
                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
286
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
287
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
288
 
<p>Signature of the callback called when a GetClientTypes method call
289
 
succeeds or fails.</p>
290
 
<div class="refsect3">
291
 
<a name="id-1.4.10.7.4.5"></a><h4>Parameters</h4>
292
 
<div class="informaltable"><table width="100%" border="0">
293
 
<colgroup>
294
 
<col width="150px" class="parameters_name">
295
 
<col class="parameters_description">
296
 
<col width="200px" class="parameters_annotations">
297
 
</colgroup>
298
 
<tbody>
299
 
<tr>
300
 
<td class="parameter_name"><p>proxy</p></td>
301
 
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
302
 
<td class="parameter_annotations"> </td>
303
 
</tr>
304
 
<tr>
305
 
<td class="parameter_name"><p>out_Client_Types</p></td>
306
 
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</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>: The contacts' client types, if already known. Contacts whose client           types are not already known are omitted from the mapping; contacts known           to have no client type information appear in the mapping with an empty           list.</p></td>
308
 
<td class="parameter_annotations"> </td>
309
 
</tr>
310
 
<tr>
311
 
<td class="parameter_name"><p>error</p></td>
312
 
<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>
313
 
<td class="parameter_annotations"> </td>
314
 
</tr>
315
 
<tr>
316
 
<td class="parameter_name"><p>user_data</p></td>
317
 
<td class="parameter_description"><p>user-supplied data</p></td>
318
 
<td class="parameter_annotations"> </td>
319
 
</tr>
320
 
<tr>
321
 
<td class="parameter_name"><p>weak_object</p></td>
322
 
<td class="parameter_description"><p>user-supplied object</p></td>
323
 
<td class="parameter_annotations"> </td>
324
 
</tr>
325
 
</tbody>
326
 
</table></div>
327
 
</div>
328
 
</div>
329
 
<hr>
330
 
<div class="refsect2">
331
 
<a name="tp-cli-connection-interface-client-types-callback-for-request-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_request_client_types ()</h3>
332
 
<pre class="programlisting"><span class="returnvalue">void</span>
333
 
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_callback_for_request_client_types<span class="c_punctuation">)</span>
334
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
335
 
                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Client_Types</code></em>,
336
 
                                <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>,
337
 
                                <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>,
338
 
                                <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>
339
 
<div class="warning"><p><code class="literal">tp_cli_connection_interface_client_types_callback_for_request_client_types</code> is deprecated and should not be used in newly-written code.</p></div>
340
 
<p>Signature of the callback called when a RequestClientTypes method call
341
 
succeeds or fails.</p>
342
 
<div class="refsect3">
343
 
<a name="id-1.4.10.7.5.6"></a><h4>Parameters</h4>
344
 
<div class="informaltable"><table width="100%" border="0">
345
 
<colgroup>
346
 
<col width="150px" class="parameters_name">
347
 
<col class="parameters_description">
348
 
<col width="200px" class="parameters_annotations">
349
 
</colgroup>
350
 
<tbody>
351
 
<tr>
352
 
<td class="parameter_name"><p>proxy</p></td>
353
 
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
354
 
<td class="parameter_annotations"> </td>
355
 
</tr>
356
 
<tr>
357
 
<td class="parameter_name"><p>out_Client_Types</p></td>
358
 
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
359
 
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 client types. It MAY be empty, indicating that no client           type information was found.</p></td>
360
 
<td class="parameter_annotations"> </td>
361
 
</tr>
362
 
<tr>
363
 
<td class="parameter_name"><p>error</p></td>
364
 
<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>
365
 
<td class="parameter_annotations"> </td>
366
 
</tr>
367
 
<tr>
368
 
<td class="parameter_name"><p>user_data</p></td>
369
 
<td class="parameter_description"><p>user-supplied data</p></td>
370
 
<td class="parameter_annotations"> </td>
371
 
</tr>
372
 
<tr>
373
 
<td class="parameter_name"><p>weak_object</p></td>
374
 
<td class="parameter_description"><p>user-supplied object</p></td>
375
 
<td class="parameter_annotations"> </td>
376
 
</tr>
377
 
</tbody>
378
 
</table></div>
379
 
</div>
380
 
</div>
381
 
<hr>
382
 
<div class="refsect2">
383
 
<a name="tp-cli-connection-interface-client-types-connect-to-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_connect_to_client_types_updated ()</h3>
384
 
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
385
 
tp_cli_connection_interface_client_types_connect_to_client_types_updated
386
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
387
 
                                <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
388
 
                                <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>,
389
 
                                <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>,
390
 
                                <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>,
391
 
                                <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>
392
 
<p>Connect a handler to the signal ClientTypesUpdated.</p>
393
 
<p>Emitted when a contact's client types change or become known.</p>
394
 
<div class="refsect3">
395
 
<a name="id-1.4.10.7.6.6"></a><h4>Parameters</h4>
396
 
<div class="informaltable"><table width="100%" border="0">
397
 
<colgroup>
398
 
<col width="150px" class="parameters_name">
399
 
<col class="parameters_description">
400
 
<col width="200px" class="parameters_annotations">
401
 
</colgroup>
402
 
<tbody>
403
 
<tr>
404
 
<td class="parameter_name"><p>proxy</p></td>
405
 
<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>
406
 
<td class="parameter_annotations"> </td>
407
 
</tr>
408
 
<tr>
409
 
<td class="parameter_name"><p>callback</p></td>
410
 
<td class="parameter_description"><p>Callback to be called when the signal is
411
 
received</p></td>
412
 
<td class="parameter_annotations"> </td>
413
 
</tr>
414
 
<tr>
415
 
<td class="parameter_name"><p>user_data</p></td>
416
 
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
417
 
<td class="parameter_annotations"> </td>
418
 
</tr>
419
 
<tr>
420
 
<td class="parameter_name"><p>destroy</p></td>
421
 
<td class="parameter_description"><p>Destructor for the user-supplied data, which
 
100
<a name="telepathy-glib-connection-client-types.details"></a><h2>Details</h2>
 
101
<div class="refsect2">
 
102
<a name="tp-cli-connection-interface-client-types-call-get-client-types"></a><h3>tp_cli_connection_interface_client_types_call_get_client_types ()</h3>
 
103
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_client_types_call_get_client_types
 
104
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
105
                                                         <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>,
 
106
                                                         <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>,
 
107
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-get-client-types" title="tp_cli_connection_interface_client_types_callback_for_get_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_get_client_types</span></a> callback</code></em>,
 
108
                                                         <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>,
 
109
                                                         <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>,
 
110
                                                         <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>
 
111
<p>
 
112
Start a GetClientTypes method call.
 
113
</p>
 
114
<p>
 
115
Return the client types of the given contacts, if they are         already known. If any of the given contacts' client types are         not known, request their current client types, but return         immediately without waiting for a reply; if a reply with a         non-empty client type array is later received for those         contacts, the         &lt;tp:member-ref&gt;ClientTypesUpdated&lt;/tp:member-ref&gt; signal will         be emitted for them.          &lt;tp:rationale&gt;           This method is appropriate for &amp;quot;lazy&amp;quot; client type finding, for instance           displaying the client types (if available) of everyone in your contact           list.         &lt;/tp:rationale&gt;
 
116
</p>
 
117
<div class="variablelist"><table border="0" class="variablelist">
 
118
<colgroup>
 
119
<col align="left" valign="top">
 
120
<col>
 
121
</colgroup>
 
122
<tbody>
 
123
<tr>
 
124
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
125
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
126
</td>
 
127
</tr>
 
128
<tr>
 
129
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
 
130
<td>the timeout in milliseconds, or -1 to use the
 
131
default</td>
 
132
</tr>
 
133
<tr>
 
134
<td><p><span class="term"><em class="parameter"><code>in_Contacts</code></em> :</span></p></td>
 
135
<td>Used to pass an 'in' argument: The contacts whose client types should be returned or signalled.</td>
 
136
</tr>
 
137
<tr>
 
138
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
139
<td>called when the method call succeeds or fails;
 
140
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
 
141
reply tracking</td>
 
142
</tr>
 
143
<tr>
 
144
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
145
<td>user-supplied data passed to the callback;
 
146
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>
 
147
</td>
 
148
</tr>
 
149
<tr>
 
150
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
151
<td>called with the user_data as argument, after the
 
152
call has succeeded, failed or been cancelled;
 
153
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>
 
154
</td>
 
155
</tr>
 
156
<tr>
 
157
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
158
<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
 
159
weakly referenced; if it is destroyed, this call
 
160
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
 
161
<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>
 
162
</td>
 
163
</tr>
 
164
<tr>
 
165
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
166
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
 
167
progress. It is borrowed from the object, and will become
 
168
invalid when the callback is called, the call is
 
169
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
 
170
</tr>
 
171
</tbody>
 
172
</table></div>
 
173
</div>
 
174
<hr>
 
175
<div class="refsect2">
 
176
<a name="tp-cli-connection-interface-client-types-call-request-client-types"></a><h3>tp_cli_connection_interface_client_types_call_request_client_types ()</h3>
 
177
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_connection_interface_client_types_call_request_client_types
 
178
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
179
                                                         <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>,
 
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> in_Contact</code></em>,
 
181
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-callback-for-request-client-types" title="tp_cli_connection_interface_client_types_callback_for_request_client_types ()"><span class="type">tp_cli_connection_interface_client_types_callback_for_request_client_types</span></a> callback</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/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
184
                                                         <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
<p>
 
186
Start a RequestClientTypes method call.
 
187
</p>
 
188
<p>
 
189
Return the current client types of the given contact. If necessary, make         a request to the server for up-to-date information, and wait for a         reply.          &lt;tp:rationale&gt;           This method is appropriate for use in a &amp;quot;Contact Information...&amp;quot;           dialog; it can be used to show progress information (while waiting           for the method to return), and can distinguish between various error           conditions.         &lt;/tp:rationale&gt;
 
190
</p>
 
191
<div class="variablelist"><table border="0" class="variablelist">
 
192
<colgroup>
 
193
<col align="left" valign="top">
 
194
<col>
 
195
</colgroup>
 
196
<tbody>
 
197
<tr>
 
198
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
199
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
200
</td>
 
201
</tr>
 
202
<tr>
 
203
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
 
204
<td>the timeout in milliseconds, or -1 to use the
 
205
default</td>
 
206
</tr>
 
207
<tr>
 
208
<td><p><span class="term"><em class="parameter"><code>in_Contact</code></em> :</span></p></td>
 
209
<td>Used to pass an 'in' argument: The contact whose client types should be returned. (<span class="type">TpContactHandle</span>)</td>
 
210
</tr>
 
211
<tr>
 
212
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
213
<td>called when the method call succeeds or fails;
 
214
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
 
215
reply tracking</td>
 
216
</tr>
 
217
<tr>
 
218
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
219
<td>user-supplied data passed to the callback;
 
220
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>
 
221
</td>
 
222
</tr>
 
223
<tr>
 
224
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
225
<td>called with the user_data as argument, after the
 
226
call has succeeded, failed or been cancelled;
 
227
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>
 
228
</td>
 
229
</tr>
 
230
<tr>
 
231
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
232
<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
 
233
weakly referenced; if it is destroyed, this call
 
234
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
 
235
<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>
 
236
</td>
 
237
</tr>
 
238
<tr>
 
239
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
240
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
 
241
progress. It is borrowed from the object, and will become
 
242
invalid when the callback is called, the call is
 
243
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
 
244
</tr>
 
245
</tbody>
 
246
</table></div>
 
247
</div>
 
248
<hr>
 
249
<div class="refsect2">
 
250
<a name="tp-cli-connection-interface-client-types-callback-for-get-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_get_client_types ()</h3>
 
251
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_interface_client_types_callback_for_get_client_types)
 
252
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
253
                                                         <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_Client_Types</code></em>,
 
254
                                                         <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>,
 
255
                                                         <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>,
 
256
                                                         <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>
 
257
<p>
 
258
Signature of the callback called when a GetClientTypes method call
 
259
succeeds or fails.
 
260
</p>
 
261
<div class="variablelist"><table border="0" class="variablelist">
 
262
<colgroup>
 
263
<col align="left" valign="top">
 
264
<col>
 
265
</colgroup>
 
266
<tbody>
 
267
<tr>
 
268
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
269
<td>the proxy on which the call was made</td>
 
270
</tr>
 
271
<tr>
 
272
<td><p><span class="term"><em class="parameter"><code>out_Client_Types</code></em> :</span></p></td>
 
273
<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' client types, if already known. Contacts whose client           types are not already known are omitted from the mapping; contacts known           to have no client type information appear in the mapping with an empty           list.</td>
 
274
</tr>
 
275
<tr>
 
276
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
277
<td>
 
278
<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>
 
279
</tr>
 
280
<tr>
 
281
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
282
<td>user-supplied data</td>
 
283
</tr>
 
284
<tr>
 
285
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
286
<td>user-supplied object</td>
 
287
</tr>
 
288
</tbody>
 
289
</table></div>
 
290
</div>
 
291
<hr>
 
292
<div class="refsect2">
 
293
<a name="tp-cli-connection-interface-client-types-callback-for-request-client-types"></a><h3>tp_cli_connection_interface_client_types_callback_for_request_client_types ()</h3>
 
294
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_interface_client_types_callback_for_request_client_types)
 
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>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_Client_Types</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>
 
300
<p>
 
301
Signature of the callback called when a RequestClientTypes method call
 
302
succeeds or fails.
 
303
</p>
 
304
<div class="variablelist"><table border="0" class="variablelist">
 
305
<colgroup>
 
306
<col align="left" valign="top">
 
307
<col>
 
308
</colgroup>
 
309
<tbody>
 
310
<tr>
 
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>
 
313
</tr>
 
314
<tr>
 
315
<td><p><span class="term"><em class="parameter"><code>out_Client_Types</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 contact's client types. It MAY be empty, indicating that no client           type information was found.</td>
 
317
</tr>
 
318
<tr>
 
319
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
320
<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>
 
322
</tr>
 
323
<tr>
 
324
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
325
<td>user-supplied data</td>
 
326
</tr>
 
327
<tr>
 
328
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
329
<td>user-supplied object</td>
 
330
</tr>
 
331
</tbody>
 
332
</table></div>
 
333
</div>
 
334
<hr>
 
335
<div class="refsect2">
 
336
<a name="tp-cli-connection-interface-client-types-connect-to-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_connect_to_client_types_updated ()</h3>
 
337
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_connection_interface_client_types_connect_to_client_types_updated
 
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 class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-signal-callback-client-types-updated" title="tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()"><span class="type">tp_cli_connection_interface_client_types_signal_callback_client_types_updated</span></a> callback</code></em>,
 
340
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
341
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
342
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
343
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
344
<p>
 
345
Connect a handler to the signal ClientTypesUpdated.
 
346
</p>
 
347
<p>
 
348
Emitted when a contact's client types change or become known.
 
349
</p>
 
350
<div class="variablelist"><table border="0" class="variablelist">
 
351
<colgroup>
 
352
<col align="left" valign="top">
 
353
<col>
 
354
</colgroup>
 
355
<tbody>
 
356
<tr>
 
357
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
358
<td>A <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> or subclass</td>
 
359
</tr>
 
360
<tr>
 
361
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
362
<td>Callback to be called when the signal is
 
363
received</td>
 
364
</tr>
 
365
<tr>
 
366
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
367
<td>User-supplied data for the callback</td>
 
368
</tr>
 
369
<tr>
 
370
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
371
<td>Destructor for the user-supplied data, which
422
372
will be called when this signal is disconnected, or
423
 
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>
424
 
<td class="parameter_annotations"> </td>
 
373
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>
 
374
</td>
425
375
</tr>
426
376
<tr>
427
 
<td class="parameter_name"><p>weak_object</p></td>
428
 
<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;
 
377
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
378
<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;
429
379
if it is destroyed, this callback will automatically be
430
 
disconnected</p></td>
431
 
<td class="parameter_annotations"> </td>
432
 
</tr>
433
 
<tr>
434
 
<td class="parameter_name"><p>error</p></td>
435
 
<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
436
 
returned</p></td>
437
 
<td class="parameter_annotations"> </td>
438
 
</tr>
439
 
</tbody>
440
 
</table></div>
441
 
</div>
442
 
<div class="refsect3">
443
 
<a name="id-1.4.10.7.6.7"></a><h4>Returns</h4>
444
 
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
 
380
disconnected</td>
 
381
</tr>
 
382
<tr>
 
383
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
384
<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
 
385
returned</td>
 
386
</tr>
 
387
<tr>
 
388
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
389
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
445
390
above, which can be used to disconnect the signal; or
446
391
<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
447
 
or has become invalid.</p>
448
 
<p></p>
449
 
</div>
 
392
or has become invalid.</td>
 
393
</tr>
 
394
</tbody>
 
395
</table></div>
450
396
</div>
451
397
<hr>
452
398
<div class="refsect2">
453
 
<a name="tp-cli-connection-interface-client-types-signal-callback-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()</h3>
454
 
<pre class="programlisting"><span class="returnvalue">void</span>
455
 
<span class="c_punctuation">(</span>*tp_cli_connection_interface_client_types_signal_callback_client_types_updated<span class="c_punctuation">)</span>
456
 
                               (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
457
 
                                <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>,
458
 
                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **arg_Client_Types</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/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
461
 
<p>Represents the signature of a callback for the signal ClientTypesUpdated.</p>
462
 
<div class="refsect3">
463
 
<a name="id-1.4.10.7.7.5"></a><h4>Parameters</h4>
464
 
<div class="informaltable"><table width="100%" border="0">
 
399
<a name="tp-cli-connection-interface-client-types-signal-callback-client-types-updated"></a><h3>tp_cli_connection_interface_client_types_signal_callback_client_types_updated ()</h3>
 
400
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_connection_interface_client_types_signal_callback_client_types_updated)
 
401
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *proxy</code></em>,
 
402
                                                         <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>,
 
403
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **arg_Client_Types</code></em>,
 
404
                                                         <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>,
 
405
                                                         <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>
 
406
<p>
 
407
Represents the signature of a callback for the signal ClientTypesUpdated.
 
408
</p>
 
409
<div class="variablelist"><table border="0" class="variablelist">
465
410
<colgroup>
466
 
<col width="150px" class="parameters_name">
467
 
<col class="parameters_description">
468
 
<col width="200px" class="parameters_annotations">
 
411
<col align="left" valign="top">
 
412
<col>
469
413
</colgroup>
470
414
<tbody>
471
415
<tr>
472
 
<td class="parameter_name"><p>proxy</p></td>
473
 
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()"><code class="function">tp_cli_connection_interface_client_types_connect_to_client_types_updated()</code></a>
474
 
was called</p></td>
475
 
<td class="parameter_annotations"> </td>
476
 
</tr>
477
 
<tr>
478
 
<td class="parameter_name"><p>arg_Contact</p></td>
479
 
<td class="parameter_description"><p>The contact. (<span class="type">TpContactHandle</span>)</p></td>
480
 
<td class="parameter_annotations"> </td>
481
 
</tr>
482
 
<tr>
483
 
<td class="parameter_name"><p>arg_Client_Types</p></td>
484
 
<td class="parameter_description"><p>The contact's client types, or an empty list to indicate that nothing           is known about the contact's client types.</p></td>
485
 
<td class="parameter_annotations"> </td>
486
 
</tr>
487
 
<tr>
488
 
<td class="parameter_name"><p>user_data</p></td>
489
 
<td class="parameter_description"><p>User-supplied data</p></td>
490
 
<td class="parameter_annotations"> </td>
491
 
</tr>
492
 
<tr>
493
 
<td class="parameter_name"><p>weak_object</p></td>
494
 
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
495
 
<td class="parameter_annotations"> </td>
 
416
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
417
<td>The proxy on which <a class="link" href="telepathy-glib-connection-client-types.html#tp-cli-connection-interface-client-types-connect-to-client-types-updated" title="tp_cli_connection_interface_client_types_connect_to_client_types_updated ()"><code class="function">tp_cli_connection_interface_client_types_connect_to_client_types_updated()</code></a>
 
418
was called</td>
 
419
</tr>
 
420
<tr>
 
421
<td><p><span class="term"><em class="parameter"><code>arg_Contact</code></em> :</span></p></td>
 
422
<td>The contact. (<span class="type">TpContactHandle</span>)</td>
 
423
</tr>
 
424
<tr>
 
425
<td><p><span class="term"><em class="parameter"><code>arg_Client_Types</code></em> :</span></p></td>
 
426
<td>The contact's client types, or an empty list to indicate that nothing           is known about the contact's client types.</td>
 
427
</tr>
 
428
<tr>
 
429
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
430
<td>User-supplied data</td>
 
431
</tr>
 
432
<tr>
 
433
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
434
<td>User-supplied weakly referenced object</td>
496
435
</tr>
497
436
</tbody>
498
437
</table></div>
499
438
</div>
500
439
</div>
501
440
</div>
502
 
<div class="refsect1">
503
 
<a name="telepathy-glib-connection-client-types.other_details"></a><h2>Types and Values</h2>
504
 
</div>
505
 
</div>
506
441
<div class="footer">
507
442
<hr>
508
 
          Generated by GTK-Doc V1.20</div>
 
443
          Generated by GTK-Doc V1.19</div>
509
444
</body>
510
445
</html>
 
 
b'\\ No newline at end of file'