~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic
» Revision
67
: docs/reference/html/telepathy-glib-channel-tube.html
« back to all changes in this revision
Viewing changes to docs/reference/html/telepathy-glib-channel-tube.html
- browse files at revision 67
- compare with another revision
- download diff
- download tarball
- view history from revision 67
- 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
* 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
- files removed:
- build-aux/compile
- files modified:
- ChangeLog
added
removed
docs/reference/html/telepathy-glib-channel-tube.html
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: Tube channels</title>
5
<title>Tube channels</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-channel-tubes.html" title="Tubes channels">
10
10
<link rel="next" href="telepathy-glib-channel-roomlist.html" title="Room List channels">
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-channel-tube.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
19
<a href="#telepathy-glib-channel-tube.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-channel-tubes.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24
<td><a accesskey="n" href="telepathy-glib-channel-roomlist.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-channel-tubes.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-channel-roomlist.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-channel-tube.synopsis" class="shortcut">Top</a>
25
|
26
<a href="#telepathy-glib-channel-tube.description" class="shortcut">Description</a>
27
</td></tr>
28
</table>
26
29
<div class="refentry">
27
30
<a name="telepathy-glib-channel-tube"></a><div class="titlepage"></div>
28
31
<div class="refnamediv"><table width="100%"><tr>
31
34
<p>Tube channels — client-side wrappers for the Tube channel interface,
32
35
StreamTube channel type and DBusTube channel type.</p>
33
36
</td>
34
<td class="gallery_image" valign="top" align="right"></td>
37
<td valign="top" align="right"></td>
35
38
</tr></table></div>
36
<div class="refsect1">
37
<a name="telepathy-glib-channel-tube.functions"></a><h2>Functions</h2>
38
<div class="informaltable"><table width="100%" border="0">
39
<colgroup>
40
<col width="150px" class="functions_return">
41
<col class="functions_name">
42
</colgroup>
43
<tbody>
44
<tr>
45
<td class="function_type">
46
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
47
</td>
48
<td class="function_name">
49
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed" title="tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()">tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed</a> <span class="c_punctuation">()</span>
50
</td>
51
</tr>
52
<tr>
53
<td class="function_type">
54
<span class="returnvalue">void</span>
55
</td>
56
<td class="function_name">
57
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed" title="tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()">*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
58
</td>
59
</tr>
60
<tr>
61
<td class="function_type">
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
63
</td>
64
<td class="function_name">
65
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-run-offer" title="tp_cli_channel_type_stream_tube_run_offer ()">tp_cli_channel_type_stream_tube_run_offer</a> <span class="c_punctuation">()</span>
66
</td>
67
</tr>
68
<tr>
69
<td class="function_type">
70
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
71
</td>
72
<td class="function_name">
73
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-run-accept" title="tp_cli_channel_type_stream_tube_run_accept ()">tp_cli_channel_type_stream_tube_run_accept</a> <span class="c_punctuation">()</span>
74
</td>
75
</tr>
76
<tr>
77
<td class="function_type">
78
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
79
</td>
80
<td class="function_name">
81
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-call-offer" title="tp_cli_channel_type_stream_tube_call_offer ()">tp_cli_channel_type_stream_tube_call_offer</a> <span class="c_punctuation">()</span>
82
</td>
83
</tr>
84
<tr>
85
<td class="function_type">
86
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
87
</td>
88
<td class="function_name">
89
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-call-accept" title="tp_cli_channel_type_stream_tube_call_accept ()">tp_cli_channel_type_stream_tube_call_accept</a> <span class="c_punctuation">()</span>
90
</td>
91
</tr>
92
<tr>
93
<td class="function_type">
94
<span class="returnvalue">void</span>
95
</td>
96
<td class="function_name">
97
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-offer" title="tp_cli_channel_type_stream_tube_callback_for_offer ()">*tp_cli_channel_type_stream_tube_callback_for_offer</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
98
</td>
99
</tr>
100
<tr>
101
<td class="function_type">
102
<span class="returnvalue">void</span>
103
</td>
104
<td class="function_name">
105
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-accept" title="tp_cli_channel_type_stream_tube_callback_for_accept ()">*tp_cli_channel_type_stream_tube_callback_for_accept</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
106
</td>
107
</tr>
108
<tr>
109
<td class="function_type">
110
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
111
</td>
112
<td class="function_name">
113
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-remote-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()">tp_cli_channel_type_stream_tube_connect_to_new_remote_connection</a> <span class="c_punctuation">()</span>
114
</td>
115
</tr>
116
<tr>
117
<td class="function_type">
118
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
119
</td>
120
<td class="function_name">
121
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-local-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()">tp_cli_channel_type_stream_tube_connect_to_new_local_connection</a> <span class="c_punctuation">()</span>
122
</td>
123
</tr>
124
<tr>
125
<td class="function_type">
126
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
127
</td>
128
<td class="function_name">
129
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-connection-closed" title="tp_cli_channel_type_stream_tube_connect_to_connection_closed ()">tp_cli_channel_type_stream_tube_connect_to_connection_closed</a> <span class="c_punctuation">()</span>
130
</td>
131
</tr>
132
<tr>
133
<td class="function_type">
134
<span class="returnvalue">void</span>
135
</td>
136
<td class="function_name">
137
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()">*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
138
</td>
139
</tr>
140
<tr>
141
<td class="function_type">
142
<span class="returnvalue">void</span>
143
</td>
144
<td class="function_name">
145
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-local-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()">*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
146
</td>
147
</tr>
148
<tr>
149
<td class="function_type">
150
<span class="returnvalue">void</span>
151
</td>
152
<td class="function_name">
153
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-connection-closed" title="tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()">*tp_cli_channel_type_stream_tube_signal_callback_connection_closed</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
154
</td>
155
</tr>
156
<tr>
157
<td class="function_type">
158
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
159
</td>
160
<td class="function_name">
161
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-run-offer" title="tp_cli_channel_type_dbus_tube_run_offer ()">tp_cli_channel_type_dbus_tube_run_offer</a> <span class="c_punctuation">()</span>
162
</td>
163
</tr>
164
<tr>
165
<td class="function_type">
166
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
167
</td>
168
<td class="function_name">
169
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-run-accept" title="tp_cli_channel_type_dbus_tube_run_accept ()">tp_cli_channel_type_dbus_tube_run_accept</a> <span class="c_punctuation">()</span>
170
</td>
171
</tr>
172
<tr>
173
<td class="function_type">
174
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
175
</td>
176
<td class="function_name">
177
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-call-offer" title="tp_cli_channel_type_dbus_tube_call_offer ()">tp_cli_channel_type_dbus_tube_call_offer</a> <span class="c_punctuation">()</span>
178
</td>
179
</tr>
180
<tr>
181
<td class="function_type">
182
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
183
</td>
184
<td class="function_name">
185
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-call-accept" title="tp_cli_channel_type_dbus_tube_call_accept ()">tp_cli_channel_type_dbus_tube_call_accept</a> <span class="c_punctuation">()</span>
186
</td>
187
</tr>
188
<tr>
189
<td class="function_type">
190
<span class="returnvalue">void</span>
191
</td>
192
<td class="function_name">
193
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-offer" title="tp_cli_channel_type_dbus_tube_callback_for_offer ()">*tp_cli_channel_type_dbus_tube_callback_for_offer</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
194
</td>
195
</tr>
196
<tr>
197
<td class="function_type">
198
<span class="returnvalue">void</span>
199
</td>
200
<td class="function_name">
201
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-accept" title="tp_cli_channel_type_dbus_tube_callback_for_accept ()">*tp_cli_channel_type_dbus_tube_callback_for_accept</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
202
</td>
203
</tr>
204
<tr>
205
<td class="function_type">
206
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
207
</td>
208
<td class="function_name">
209
<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()">tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed</a> <span class="c_punctuation">()</span>
210
</td>
211
</tr>
212
<tr>
213
<td class="function_type">
214
<span class="returnvalue">void</span>
215
</td>
216
<td class="function_name">
217
<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()">*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
218
</td>
219
</tr>
220
</tbody>
221
</table></div>
222
</div>
223
<div class="refsect1">
224
<a name="telepathy-glib-channel-tube.object-hierarchy"></a><h2>Object Hierarchy</h2>
225
<pre class="screen">
226
</pre>
227
</div>
228
<div class="refsect1">
229
<a name="telepathy-glib-channel-tube.includes"></a><h2>Includes</h2>
230
<pre class="synopsis">#include <telepathy-glib/telepathy-glib-dbus.h>
39
<div class="refsynopsisdiv">
40
<a name="telepathy-glib-channel-tube.synopsis"></a><h2>Synopsis</h2>
41
<pre class="synopsis">
42
#include <telepathy-glib/telepathy-glib-dbus.h>
43
44
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed" title="tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()">tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed</a>
45
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
46
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed" title="tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()"><span class="type">tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</span></a> callback</code></em>,
47
<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>,
48
<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>,
49
<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>,
50
<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>);
51
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed" title="tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()">*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</a>)
52
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
53
<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_State</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 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-run-offer" title="tp_cli_channel_type_stream_tube_run_offer ()">tp_cli_channel_type_stream_tube_run_offer</a>
57
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</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><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> in_address_type</code></em>,
60
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
61
<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_access_control</code></em>,
62
<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_parameters</code></em>,
63
<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>,
64
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
65
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-run-accept" title="tp_cli_channel_type_stream_tube_run_accept ()">tp_cli_channel_type_stream_tube_run_accept</a>
66
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
67
<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>,
68
<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_address_type</code></em>,
69
<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_access_control</code></em>,
70
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
71
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> **out_address</code></em>,
72
<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>,
73
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
74
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-call-offer" title="tp_cli_channel_type_stream_tube_call_offer ()">tp_cli_channel_type_stream_tube_call_offer</a>
75
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
76
<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>,
77
<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_address_type</code></em>,
78
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
79
<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_access_control</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> *in_parameters</code></em>,
81
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-offer" title="tp_cli_channel_type_stream_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_offer</span></a> callback</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/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
84
<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>);
85
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-call-accept" title="tp_cli_channel_type_stream_tube_call_accept ()">tp_cli_channel_type_stream_tube_call_accept</a>
86
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
87
<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>,
88
<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_address_type</code></em>,
89
<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_access_control</code></em>,
90
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
91
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-accept" title="tp_cli_channel_type_stream_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_accept</span></a> callback</code></em>,
92
<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>,
93
<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>,
94
<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>);
95
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-offer" title="tp_cli_channel_type_stream_tube_callback_for_offer ()">*tp_cli_channel_type_stream_tube_callback_for_offer</a>)
96
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
97
<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>,
98
<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>,
99
<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>);
100
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-accept" title="tp_cli_channel_type_stream_tube_callback_for_accept ()">*tp_cli_channel_type_stream_tube_callback_for_accept</a>)
101
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
102
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_address</code></em>,
103
<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>,
104
<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>,
105
<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>);
106
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-remote-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()">tp_cli_channel_type_stream_tube_connect_to_new_remote_connection</a>
107
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
108
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</span></a> callback</code></em>,
109
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
110
<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>,
111
<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>,
112
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
113
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-local-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()">tp_cli_channel_type_stream_tube_connect_to_new_local_connection</a>
114
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
115
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-local-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_local_connection</span></a> callback</code></em>,
116
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
117
<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>,
118
<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>,
119
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
120
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-connection-closed" title="tp_cli_channel_type_stream_tube_connect_to_connection_closed ()">tp_cli_channel_type_stream_tube_connect_to_connection_closed</a>
121
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
122
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-connection-closed" title="tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_connection_closed</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>,
126
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
127
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()">*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</a>)
128
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
129
<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_Handle</code></em>,
130
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *arg_Connection_Param</code></em>,
131
<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_Connection_ID</code></em>,
132
<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>,
133
<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>);
134
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-local-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()">*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection</a>)
135
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
136
<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_Connection_ID</code></em>,
137
<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>,
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
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-connection-closed" title="tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()">*tp_cli_channel_type_stream_tube_signal_callback_connection_closed</a>)
140
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
141
<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_Connection_ID</code></em>,
142
<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_Error</code></em>,
143
<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_Message</code></em>,
144
<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>,
145
<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>);
146
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-run-offer" title="tp_cli_channel_type_dbus_tube_run_offer ()">tp_cli_channel_type_dbus_tube_run_offer</a>
147
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
148
<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>,
149
<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_parameters</code></em>,
150
<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_access_control</code></em>,
151
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
152
<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>,
153
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
154
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-run-accept" title="tp_cli_channel_type_dbus_tube_run_accept ()">tp_cli_channel_type_dbus_tube_run_accept</a>
155
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
156
<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>,
157
<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_access_control</code></em>,
158
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
159
<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>,
160
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);
161
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-call-offer" title="tp_cli_channel_type_dbus_tube_call_offer ()">tp_cli_channel_type_dbus_tube_call_offer</a>
162
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
163
<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>,
164
<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_parameters</code></em>,
165
<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_access_control</code></em>,
166
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-offer" title="tp_cli_channel_type_dbus_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_offer</span></a> callback</code></em>,
167
<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>,
168
<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>,
169
<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>);
170
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-call-accept" title="tp_cli_channel_type_dbus_tube_call_accept ()">tp_cli_channel_type_dbus_tube_call_accept</a>
171
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
172
<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>,
173
<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_access_control</code></em>,
174
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-accept" title="tp_cli_channel_type_dbus_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_accept</span></a> callback</code></em>,
175
<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>,
176
<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>,
177
<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>);
178
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-offer" title="tp_cli_channel_type_dbus_tube_callback_for_offer ()">*tp_cli_channel_type_dbus_tube_callback_for_offer</a>)
179
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
180
<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_address</code></em>,
181
<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>,
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>);
184
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-accept" title="tp_cli_channel_type_dbus_tube_callback_for_accept ()">*tp_cli_channel_type_dbus_tube_callback_for_accept</a>)
185
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
186
<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_address</code></em>,
187
<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>,
188
<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>,
189
<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>);
190
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()">tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed</a>
191
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
192
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()"><span class="type">tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</span></a> callback</code></em>,
193
<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>,
194
<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>,
195
<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>,
196
<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>);
197
<span class="returnvalue">void</span> (<a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()">*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</a>)
198
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
199
<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_Added</code></em>,
200
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *arg_Removed</code></em>,
201
<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>,
202
<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>);
231
203
</pre>
232
204
</div>
233
205
<div class="refsect1">
234
206
<a name="telepathy-glib-channel-tube.description"></a><h2>Description</h2>
235
<p>A "tube" is a mechanism for arbitrary data transfer.
207
<p>
208
A "tube" is a mechanism for arbitrary data transfer.
236
209
This section documents the auto-generated C wrappers for the Tube
237
channel interface, StreamTube channel type and DBusTube channel type.</p>
238
</div>
239
<div class="refsect1">
240
<a name="telepathy-glib-channel-tube.functions_details"></a><h2>Functions</h2>
241
<div class="refsect2">
242
<a name="tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed"></a><h3>tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()</h3>
243
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
244
tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed
245
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
246
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed" title="tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()"><span class="type">tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</span></a> callback</code></em>,
247
<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>,
248
<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>,
249
<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>,
250
<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>
251
<p>Connect a handler to the signal TubeChannelStateChanged.</p>
252
<p>Emitted when the state of the tube channel changes. Valid state transitions are documented with <tp:type>Tube_Channel_State</tp:type>.</p>
253
<div class="refsect3">
254
<a name="id-1.4.34.7.2.6"></a><h4>Parameters</h4>
255
<div class="informaltable"><table width="100%" border="0">
256
<colgroup>
257
<col width="150px" class="parameters_name">
258
<col class="parameters_description">
259
<col width="200px" class="parameters_annotations">
260
</colgroup>
261
<tbody>
262
<tr>
263
<td class="parameter_name"><p>proxy</p></td>
264
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
265
<td class="parameter_annotations"> </td>
266
</tr>
267
<tr>
268
<td class="parameter_name"><p>callback</p></td>
269
<td class="parameter_description"><p>Callback to be called when the signal is
270
received</p></td>
271
<td class="parameter_annotations"> </td>
272
</tr>
273
<tr>
274
<td class="parameter_name"><p>user_data</p></td>
275
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
276
<td class="parameter_annotations"> </td>
277
</tr>
278
<tr>
279
<td class="parameter_name"><p>destroy</p></td>
280
<td class="parameter_description"><p>Destructor for the user-supplied data, which
281
will be called when this signal is disconnected, or
282
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>
283
<td class="parameter_annotations"> </td>
284
</tr>
285
<tr>
286
<td class="parameter_name"><p>weak_object</p></td>
287
<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;
288
if it is destroyed, this callback will automatically be
289
disconnected</p></td>
290
<td class="parameter_annotations"> </td>
291
</tr>
292
<tr>
293
<td class="parameter_name"><p>error</p></td>
294
<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
295
returned</p></td>
296
<td class="parameter_annotations"> </td>
297
</tr>
298
</tbody>
299
</table></div>
300
</div>
301
<div class="refsect3">
302
<a name="id-1.4.34.7.2.7"></a><h4>Returns</h4>
303
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
304
above, which can be used to disconnect the signal; or
305
<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
306
or has become invalid.</p>
307
<p></p>
308
</div>
309
</div>
310
<hr>
311
<div class="refsect2">
312
<a name="tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed"></a><h3>tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()</h3>
313
<pre class="programlisting"><span class="returnvalue">void</span>
314
<span class="c_punctuation">(</span>*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed<span class="c_punctuation">)</span>
315
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
316
<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_State</code></em>,
317
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
318
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
319
<p>Represents the signature of a callback for the signal TubeChannelStateChanged.</p>
320
<div class="refsect3">
321
<a name="id-1.4.34.7.3.5"></a><h4>Parameters</h4>
322
<div class="informaltable"><table width="100%" border="0">
323
<colgroup>
324
<col width="150px" class="parameters_name">
325
<col class="parameters_description">
326
<col width="200px" class="parameters_annotations">
327
</colgroup>
328
<tbody>
329
<tr>
330
<td class="parameter_name"><p>proxy</p></td>
331
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed" title="tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()"><code class="function">tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed()</code></a>
332
was called</p></td>
333
<td class="parameter_annotations"> </td>
334
</tr>
335
<tr>
336
<td class="parameter_name"><p>arg_State</p></td>
337
<td class="parameter_description"><p>The new state of the tube. (<a class="link" href="telepathy-glib-enums.html#TpTubeChannelState" title="enum TpTubeChannelState"><span class="type">TpTubeChannelState</span></a>)</p></td>
338
<td class="parameter_annotations"> </td>
339
</tr>
340
<tr>
341
<td class="parameter_name"><p>user_data</p></td>
342
<td class="parameter_description"><p>User-supplied data</p></td>
343
<td class="parameter_annotations"> </td>
344
</tr>
345
<tr>
346
<td class="parameter_name"><p>weak_object</p></td>
347
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
348
<td class="parameter_annotations"> </td>
349
</tr>
350
</tbody>
351
</table></div>
352
</div>
353
</div>
354
<hr>
355
<div class="refsect2">
356
<a name="tp-cli-channel-type-stream-tube-run-offer"></a><h3>tp_cli_channel_type_stream_tube_run_offer ()</h3>
357
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
358
tp_cli_channel_type_stream_tube_run_offer
359
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
360
<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>,
361
<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_address_type</code></em>,
362
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
363
<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_access_control</code></em>,
364
<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_parameters</code></em>,
365
<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>,
366
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
367
<div class="warning"><p><code class="literal">tp_cli_channel_type_stream_tube_run_offer</code> is deprecated and should not be used in newly-written code.</p></div>
368
<p>Call the method Offer and run the main loop
369
until it returns. Before calling this method, you must
370
add a reference to any borrowed objects you need to keep,
371
and generally ensure that everything is in a consistent
372
state.</p>
373
<p>Offer a stream tube exporting the local socket specified.</p>
374
<div class="refsect3">
375
<a name="id-1.4.34.7.4.7"></a><h4>Parameters</h4>
376
<div class="informaltable"><table width="100%" border="0">
377
<colgroup>
378
<col width="150px" class="parameters_name">
379
<col class="parameters_description">
380
<col width="200px" class="parameters_annotations">
381
</colgroup>
382
<tbody>
383
<tr>
384
<td class="parameter_name"><p>proxy</p></td>
385
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
386
<td class="parameter_annotations"> </td>
387
</tr>
388
<tr>
389
<td class="parameter_name"><p>timeout_ms</p></td>
390
<td class="parameter_description"><p>Timeout in milliseconds, or -1 for default</p></td>
391
<td class="parameter_annotations"> </td>
392
</tr>
393
<tr>
394
<td class="parameter_name"><p>in_address_type</p></td>
395
<td class="parameter_description"><p>Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</p></td>
396
<td class="parameter_annotations"> </td>
397
</tr>
398
<tr>
399
<td class="parameter_name"><p>in_address</p></td>
400
<td class="parameter_description"><p>Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.</p></td>
401
<td class="parameter_annotations"> </td>
402
</tr>
403
<tr>
404
<td class="parameter_name"><p>in_access_control</p></td>
405
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
406
<td class="parameter_annotations"> </td>
407
</tr>
408
<tr>
409
<td class="parameter_name"><p>in_parameters</p></td>
410
<td class="parameter_description"><p>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</p></td>
411
<td class="parameter_annotations"> </td>
412
</tr>
413
<tr>
414
<td class="parameter_name"><p>error</p></td>
415
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
416
is returned</p></td>
417
<td class="parameter_annotations"> </td>
418
</tr>
419
<tr>
420
<td class="parameter_name"><p>loop</p></td>
421
<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>, set before re-entering
422
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
423
which can be used to cancel this call with
424
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
425
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em>
426
set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a></p></td>
427
<td class="parameter_annotations"> </td>
428
</tr>
429
</tbody>
430
</table></div>
431
</div>
432
<div class="refsect3">
433
<a name="id-1.4.34.7.4.8"></a><h4>Returns</h4>
434
<p> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em>
435
on error</p>
436
<p></p>
437
</div>
438
</div>
439
<hr>
440
<div class="refsect2">
441
<a name="tp-cli-channel-type-stream-tube-run-accept"></a><h3>tp_cli_channel_type_stream_tube_run_accept ()</h3>
442
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
443
tp_cli_channel_type_stream_tube_run_accept
444
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
445
<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>,
446
<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_address_type</code></em>,
447
<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_access_control</code></em>,
448
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
449
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> **out_address</code></em>,
450
<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>,
451
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
452
<div class="warning"><p><code class="literal">tp_cli_channel_type_stream_tube_run_accept</code> is deprecated and should not be used in newly-written code.</p></div>
453
<p>Call the method Accept and run the main loop
454
until it returns. Before calling this method, you must
455
add a reference to any borrowed objects you need to keep,
456
and generally ensure that everything is in a consistent
457
state.</p>
458
<p>Accept a stream tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.</p>
459
<div class="refsect3">
460
<a name="id-1.4.34.7.5.7"></a><h4>Parameters</h4>
461
<div class="informaltable"><table width="100%" border="0">
462
<colgroup>
463
<col width="150px" class="parameters_name">
464
<col class="parameters_description">
465
<col width="200px" class="parameters_annotations">
466
</colgroup>
467
<tbody>
468
<tr>
469
<td class="parameter_name"><p>proxy</p></td>
470
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
471
<td class="parameter_annotations"> </td>
472
</tr>
473
<tr>
474
<td class="parameter_name"><p>timeout_ms</p></td>
475
<td class="parameter_description"><p>Timeout in milliseconds, or -1 for default</p></td>
476
<td class="parameter_annotations"> </td>
477
</tr>
478
<tr>
479
<td class="parameter_name"><p>in_address_type</p></td>
480
<td class="parameter_description"><p>Used to pass an 'in' argument: The type of address the connection manager should listen on. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</p></td>
481
<td class="parameter_annotations"> </td>
482
</tr>
483
<tr>
484
<td class="parameter_name"><p>in_access_control</p></td>
485
<td class="parameter_description"><p>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
486
<td class="parameter_annotations"> </td>
487
</tr>
488
<tr>
489
<td class="parameter_name"><p>in_access_control_param</p></td>
490
<td class="parameter_description"><p>Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum.</p></td>
491
<td class="parameter_annotations"> </td>
492
</tr>
493
<tr>
494
<td class="parameter_name"><p>out_address</p></td>
495
<td class="parameter_description"><p>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The address on which the connection manager will listen for connections to this tube. The client should not attempt to connect to the address until the tube is open.</p></td>
496
<td class="parameter_annotations"> </td>
497
</tr>
498
<tr>
499
<td class="parameter_name"><p>error</p></td>
500
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
501
is returned</p></td>
502
<td class="parameter_annotations"> </td>
503
</tr>
504
<tr>
505
<td class="parameter_name"><p>loop</p></td>
506
<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>, set before re-entering
507
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
508
which can be used to cancel this call with
509
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
510
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em>
511
set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a></p></td>
512
<td class="parameter_annotations"> </td>
513
</tr>
514
</tbody>
515
</table></div>
516
</div>
517
<div class="refsect3">
518
<a name="id-1.4.34.7.5.8"></a><h4>Returns</h4>
519
<p> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em>
520
on error</p>
521
<p></p>
522
</div>
523
</div>
524
<hr>
525
<div class="refsect2">
526
<a name="tp-cli-channel-type-stream-tube-call-offer"></a><h3>tp_cli_channel_type_stream_tube_call_offer ()</h3>
527
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
528
tp_cli_channel_type_stream_tube_call_offer
529
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
530
<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>,
531
<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_address_type</code></em>,
532
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
533
<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_access_control</code></em>,
534
<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_parameters</code></em>,
535
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-offer" title="tp_cli_channel_type_stream_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_offer</span></a> callback</code></em>,
536
<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>,
537
<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>,
538
<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>
539
<p>Start a Offer method call.</p>
540
<p>Offer a stream tube exporting the local socket specified.</p>
541
<div class="refsect3">
542
<a name="id-1.4.34.7.6.6"></a><h4>Parameters</h4>
543
<div class="informaltable"><table width="100%" border="0">
544
<colgroup>
545
<col width="150px" class="parameters_name">
546
<col class="parameters_description">
547
<col width="200px" class="parameters_annotations">
548
</colgroup>
549
<tbody>
550
<tr>
551
<td class="parameter_name"><p>proxy</p></td>
552
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
553
<td class="parameter_annotations"> </td>
554
</tr>
555
<tr>
556
<td class="parameter_name"><p>timeout_ms</p></td>
557
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
558
default</p></td>
559
<td class="parameter_annotations"> </td>
560
</tr>
561
<tr>
562
<td class="parameter_name"><p>in_address_type</p></td>
563
<td class="parameter_description"><p>Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</p></td>
564
<td class="parameter_annotations"> </td>
565
</tr>
566
<tr>
567
<td class="parameter_name"><p>in_address</p></td>
568
<td class="parameter_description"><p>Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.</p></td>
569
<td class="parameter_annotations"> </td>
570
</tr>
571
<tr>
572
<td class="parameter_name"><p>in_access_control</p></td>
573
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
574
<td class="parameter_annotations"> </td>
575
</tr>
576
<tr>
577
<td class="parameter_name"><p>in_parameters</p></td>
578
<td class="parameter_description"><p>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</p></td>
579
<td class="parameter_annotations"> </td>
580
</tr>
581
<tr>
582
<td class="parameter_name"><p>callback</p></td>
583
<td class="parameter_description"><p>called when the method call succeeds or fails;
584
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
585
reply tracking</p></td>
586
<td class="parameter_annotations"> </td>
587
</tr>
588
<tr>
589
<td class="parameter_name"><p>user_data</p></td>
590
<td class="parameter_description"><p>user-supplied data passed to the callback;
591
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>
592
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
593
<td class="parameter_annotations"> </td>
594
</tr>
595
<tr>
596
<td class="parameter_name"><p>destroy</p></td>
597
<td class="parameter_description"><p>called with the user_data as argument, after the
598
call has succeeded, failed or been cancelled;
599
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>
600
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
601
<td class="parameter_annotations"> </td>
602
</tr>
603
<tr>
604
<td class="parameter_name"><p>weak_object</p></td>
605
<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
606
weakly referenced; if it is destroyed, this call
607
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
608
<em class="parameter"><code>callback</code></em>
609
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
610
<td class="parameter_annotations"> </td>
611
</tr>
612
</tbody>
613
</table></div>
614
</div>
615
<div class="refsect3">
616
<a name="id-1.4.34.7.6.7"></a><h4>Returns</h4>
617
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
618
progress. It is borrowed from the object, and will become
619
invalid when the callback is called, the call is
620
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
621
<p></p>
622
</div>
623
</div>
624
<hr>
625
<div class="refsect2">
626
<a name="tp-cli-channel-type-stream-tube-call-accept"></a><h3>tp_cli_channel_type_stream_tube_call_accept ()</h3>
627
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
628
tp_cli_channel_type_stream_tube_call_accept
629
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
630
<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>,
631
<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_address_type</code></em>,
632
<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_access_control</code></em>,
633
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
634
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-accept" title="tp_cli_channel_type_stream_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_accept</span></a> callback</code></em>,
635
<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>,
636
<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>,
637
<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>
638
<p>Start a Accept method call.</p>
639
<p>Accept a stream tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.</p>
640
<div class="refsect3">
641
<a name="id-1.4.34.7.7.6"></a><h4>Parameters</h4>
642
<div class="informaltable"><table width="100%" border="0">
643
<colgroup>
644
<col width="150px" class="parameters_name">
645
<col class="parameters_description">
646
<col width="200px" class="parameters_annotations">
647
</colgroup>
648
<tbody>
649
<tr>
650
<td class="parameter_name"><p>proxy</p></td>
651
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
652
<td class="parameter_annotations"> </td>
653
</tr>
654
<tr>
655
<td class="parameter_name"><p>timeout_ms</p></td>
656
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
657
default</p></td>
658
<td class="parameter_annotations"> </td>
659
</tr>
660
<tr>
661
<td class="parameter_name"><p>in_address_type</p></td>
662
<td class="parameter_description"><p>Used to pass an 'in' argument: The type of address the connection manager should listen on. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</p></td>
663
<td class="parameter_annotations"> </td>
664
</tr>
665
<tr>
666
<td class="parameter_name"><p>in_access_control</p></td>
667
<td class="parameter_description"><p>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
668
<td class="parameter_annotations"> </td>
669
</tr>
670
<tr>
671
<td class="parameter_name"><p>in_access_control_param</p></td>
672
<td class="parameter_description"><p>Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum.</p></td>
673
<td class="parameter_annotations"> </td>
674
</tr>
675
<tr>
676
<td class="parameter_name"><p>callback</p></td>
677
<td class="parameter_description"><p>called when the method call succeeds or fails;
678
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
679
reply tracking</p></td>
680
<td class="parameter_annotations"> </td>
681
</tr>
682
<tr>
683
<td class="parameter_name"><p>user_data</p></td>
684
<td class="parameter_description"><p>user-supplied data passed to the callback;
685
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>
686
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
687
<td class="parameter_annotations"> </td>
688
</tr>
689
<tr>
690
<td class="parameter_name"><p>destroy</p></td>
691
<td class="parameter_description"><p>called with the user_data as argument, after the
692
call has succeeded, failed or been cancelled;
693
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>
694
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
695
<td class="parameter_annotations"> </td>
696
</tr>
697
<tr>
698
<td class="parameter_name"><p>weak_object</p></td>
699
<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
700
weakly referenced; if it is destroyed, this call
701
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
702
<em class="parameter"><code>callback</code></em>
703
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
704
<td class="parameter_annotations"> </td>
705
</tr>
706
</tbody>
707
</table></div>
708
</div>
709
<div class="refsect3">
710
<a name="id-1.4.34.7.7.7"></a><h4>Returns</h4>
711
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
712
progress. It is borrowed from the object, and will become
713
invalid when the callback is called, the call is
714
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
715
<p></p>
716
</div>
717
</div>
718
<hr>
719
<div class="refsect2">
720
<a name="tp-cli-channel-type-stream-tube-callback-for-offer"></a><h3>tp_cli_channel_type_stream_tube_callback_for_offer ()</h3>
721
<pre class="programlisting"><span class="returnvalue">void</span>
722
<span class="c_punctuation">(</span>*tp_cli_channel_type_stream_tube_callback_for_offer<span class="c_punctuation">)</span>
723
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
724
<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>,
725
<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>,
726
<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>
727
<p>Signature of the callback called when a Offer method call
728
succeeds or fails.</p>
729
<div class="refsect3">
730
<a name="id-1.4.34.7.8.5"></a><h4>Parameters</h4>
731
<div class="informaltable"><table width="100%" border="0">
732
<colgroup>
733
<col width="150px" class="parameters_name">
734
<col class="parameters_description">
735
<col width="200px" class="parameters_annotations">
736
</colgroup>
737
<tbody>
738
<tr>
739
<td class="parameter_name"><p>proxy</p></td>
740
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
741
<td class="parameter_annotations"> </td>
742
</tr>
743
<tr>
744
<td class="parameter_name"><p>error</p></td>
745
<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>
746
<td class="parameter_annotations"> </td>
747
</tr>
748
<tr>
749
<td class="parameter_name"><p>user_data</p></td>
750
<td class="parameter_description"><p>user-supplied data</p></td>
751
<td class="parameter_annotations"> </td>
752
</tr>
753
<tr>
754
<td class="parameter_name"><p>weak_object</p></td>
755
<td class="parameter_description"><p>user-supplied object</p></td>
756
<td class="parameter_annotations"> </td>
757
</tr>
758
</tbody>
759
</table></div>
760
</div>
761
</div>
762
<hr>
763
<div class="refsect2">
764
<a name="tp-cli-channel-type-stream-tube-callback-for-accept"></a><h3>tp_cli_channel_type_stream_tube_callback_for_accept ()</h3>
765
<pre class="programlisting"><span class="returnvalue">void</span>
766
<span class="c_punctuation">(</span>*tp_cli_channel_type_stream_tube_callback_for_accept<span class="c_punctuation">)</span>
767
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
768
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_address</code></em>,
769
<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>,
770
<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>,
771
<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>
772
<div class="warning"><p><code class="literal">tp_cli_channel_type_stream_tube_callback_for_accept</code> is deprecated and should not be used in newly-written code.</p></div>
773
<p>Signature of the callback called when a Accept method call
774
succeeds or fails.</p>
775
<div class="refsect3">
776
<a name="id-1.4.34.7.9.6"></a><h4>Parameters</h4>
777
<div class="informaltable"><table width="100%" border="0">
778
<colgroup>
779
<col width="150px" class="parameters_name">
780
<col class="parameters_description">
781
<col width="200px" class="parameters_annotations">
782
</colgroup>
783
<tbody>
784
<tr>
785
<td class="parameter_name"><p>proxy</p></td>
786
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
787
<td class="parameter_annotations"> </td>
788
</tr>
789
<tr>
790
<td class="parameter_name"><p>out_address</p></td>
791
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
792
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The address on which the connection manager will listen for connections to this tube. The client should not attempt to connect to the address until the tube is open.</p></td>
793
<td class="parameter_annotations"> </td>
794
</tr>
795
<tr>
796
<td class="parameter_name"><p>error</p></td>
797
<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>
798
<td class="parameter_annotations"> </td>
799
</tr>
800
<tr>
801
<td class="parameter_name"><p>user_data</p></td>
802
<td class="parameter_description"><p>user-supplied data</p></td>
803
<td class="parameter_annotations"> </td>
804
</tr>
805
<tr>
806
<td class="parameter_name"><p>weak_object</p></td>
807
<td class="parameter_description"><p>user-supplied object</p></td>
808
<td class="parameter_annotations"> </td>
809
</tr>
810
</tbody>
811
</table></div>
812
</div>
813
</div>
814
<hr>
815
<div class="refsect2">
816
<a name="tp-cli-channel-type-stream-tube-connect-to-new-remote-connection"></a><h3>tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()</h3>
817
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
818
tp_cli_channel_type_stream_tube_connect_to_new_remote_connection
819
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
820
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</span></a> callback</code></em>,
821
<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>,
822
<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>,
823
<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>,
824
<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>
825
<p>Connect a handler to the signal NewRemoteConnection.</p>
826
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted each time a participant opens a new connection to its socket.</p> <p>This signal is only fired on the offering side.</p></p>
827
<div class="refsect3">
828
<a name="id-1.4.34.7.10.6"></a><h4>Parameters</h4>
829
<div class="informaltable"><table width="100%" border="0">
830
<colgroup>
831
<col width="150px" class="parameters_name">
832
<col class="parameters_description">
833
<col width="200px" class="parameters_annotations">
834
</colgroup>
835
<tbody>
836
<tr>
837
<td class="parameter_name"><p>proxy</p></td>
838
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
839
<td class="parameter_annotations"> </td>
840
</tr>
841
<tr>
842
<td class="parameter_name"><p>callback</p></td>
843
<td class="parameter_description"><p>Callback to be called when the signal is
844
received</p></td>
845
<td class="parameter_annotations"> </td>
846
</tr>
847
<tr>
848
<td class="parameter_name"><p>user_data</p></td>
849
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
850
<td class="parameter_annotations"> </td>
851
</tr>
852
<tr>
853
<td class="parameter_name"><p>destroy</p></td>
854
<td class="parameter_description"><p>Destructor for the user-supplied data, which
855
will be called when this signal is disconnected, or
856
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>
857
<td class="parameter_annotations"> </td>
858
</tr>
859
<tr>
860
<td class="parameter_name"><p>weak_object</p></td>
861
<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;
862
if it is destroyed, this callback will automatically be
863
disconnected</p></td>
864
<td class="parameter_annotations"> </td>
865
</tr>
866
<tr>
867
<td class="parameter_name"><p>error</p></td>
868
<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
869
returned</p></td>
870
<td class="parameter_annotations"> </td>
871
</tr>
872
</tbody>
873
</table></div>
874
</div>
875
<div class="refsect3">
876
<a name="id-1.4.34.7.10.7"></a><h4>Returns</h4>
877
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
878
above, which can be used to disconnect the signal; or
879
<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
880
or has become invalid.</p>
881
<p></p>
882
</div>
883
</div>
884
<hr>
885
<div class="refsect2">
886
<a name="tp-cli-channel-type-stream-tube-connect-to-new-local-connection"></a><h3>tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()</h3>
887
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
888
tp_cli_channel_type_stream_tube_connect_to_new_local_connection
889
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
890
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-local-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_local_connection</span></a> callback</code></em>,
891
<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>,
892
<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>,
893
<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>,
894
<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>
895
<p>Connect a handler to the signal NewLocalConnection.</p>
896
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the tube application connects to the CM's socket.</p> <p>This signal is only fired on the accepting side.</p></p>
897
<div class="refsect3">
898
<a name="id-1.4.34.7.11.6"></a><h4>Parameters</h4>
899
<div class="informaltable"><table width="100%" border="0">
900
<colgroup>
901
<col width="150px" class="parameters_name">
902
<col class="parameters_description">
903
<col width="200px" class="parameters_annotations">
904
</colgroup>
905
<tbody>
906
<tr>
907
<td class="parameter_name"><p>proxy</p></td>
908
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
909
<td class="parameter_annotations"> </td>
910
</tr>
911
<tr>
912
<td class="parameter_name"><p>callback</p></td>
913
<td class="parameter_description"><p>Callback to be called when the signal is
914
received</p></td>
915
<td class="parameter_annotations"> </td>
916
</tr>
917
<tr>
918
<td class="parameter_name"><p>user_data</p></td>
919
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
920
<td class="parameter_annotations"> </td>
921
</tr>
922
<tr>
923
<td class="parameter_name"><p>destroy</p></td>
924
<td class="parameter_description"><p>Destructor for the user-supplied data, which
925
will be called when this signal is disconnected, or
926
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>
927
<td class="parameter_annotations"> </td>
928
</tr>
929
<tr>
930
<td class="parameter_name"><p>weak_object</p></td>
931
<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;
932
if it is destroyed, this callback will automatically be
933
disconnected</p></td>
934
<td class="parameter_annotations"> </td>
935
</tr>
936
<tr>
937
<td class="parameter_name"><p>error</p></td>
938
<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
939
returned</p></td>
940
<td class="parameter_annotations"> </td>
941
</tr>
942
</tbody>
943
</table></div>
944
</div>
945
<div class="refsect3">
946
<a name="id-1.4.34.7.11.7"></a><h4>Returns</h4>
947
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
948
above, which can be used to disconnect the signal; or
949
<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
950
or has become invalid.</p>
951
<p></p>
952
</div>
953
</div>
954
<hr>
955
<div class="refsect2">
956
<a name="tp-cli-channel-type-stream-tube-connect-to-connection-closed"></a><h3>tp_cli_channel_type_stream_tube_connect_to_connection_closed ()</h3>
957
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
958
tp_cli_channel_type_stream_tube_connect_to_connection_closed
959
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
960
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-connection-closed" title="tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_connection_closed</span></a> callback</code></em>,
961
<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>,
962
<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>,
963
<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>,
964
<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>
965
<p>Connect a handler to the signal ConnectionClosed.</p>
966
<p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when a connection has been closed.</p></p>
967
<div class="refsect3">
968
<a name="id-1.4.34.7.12.6"></a><h4>Parameters</h4>
969
<div class="informaltable"><table width="100%" border="0">
970
<colgroup>
971
<col width="150px" class="parameters_name">
972
<col class="parameters_description">
973
<col width="200px" class="parameters_annotations">
974
</colgroup>
975
<tbody>
976
<tr>
977
<td class="parameter_name"><p>proxy</p></td>
978
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
979
<td class="parameter_annotations"> </td>
980
</tr>
981
<tr>
982
<td class="parameter_name"><p>callback</p></td>
983
<td class="parameter_description"><p>Callback to be called when the signal is
984
received</p></td>
985
<td class="parameter_annotations"> </td>
986
</tr>
987
<tr>
988
<td class="parameter_name"><p>user_data</p></td>
989
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
990
<td class="parameter_annotations"> </td>
991
</tr>
992
<tr>
993
<td class="parameter_name"><p>destroy</p></td>
994
<td class="parameter_description"><p>Destructor for the user-supplied data, which
995
will be called when this signal is disconnected, or
996
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>
997
<td class="parameter_annotations"> </td>
998
</tr>
999
<tr>
1000
<td class="parameter_name"><p>weak_object</p></td>
1001
<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;
1002
if it is destroyed, this callback will automatically be
1003
disconnected</p></td>
1004
<td class="parameter_annotations"> </td>
1005
</tr>
1006
<tr>
1007
<td class="parameter_name"><p>error</p></td>
1008
<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
1009
returned</p></td>
1010
<td class="parameter_annotations"> </td>
1011
</tr>
1012
</tbody>
1013
</table></div>
1014
</div>
1015
<div class="refsect3">
1016
<a name="id-1.4.34.7.12.7"></a><h4>Returns</h4>
1017
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
1018
above, which can be used to disconnect the signal; or
1019
<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
1020
or has become invalid.</p>
1021
<p></p>
1022
</div>
1023
</div>
1024
<hr>
1025
<div class="refsect2">
1026
<a name="tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()</h3>
1027
<pre class="programlisting"><span class="returnvalue">void</span>
1028
<span class="c_punctuation">(</span>*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection<span class="c_punctuation">)</span>
1029
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1030
<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_Handle</code></em>,
1031
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *arg_Connection_Param</code></em>,
1032
<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_Connection_ID</code></em>,
1033
<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>,
1034
<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>
1035
<div class="warning"><p><code class="literal">tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</code> is deprecated and should not be used in newly-written code.</p></div>
1036
<p>Represents the signature of a callback for the signal NewRemoteConnection.</p>
1037
<div class="refsect3">
1038
<a name="id-1.4.34.7.13.6"></a><h4>Parameters</h4>
1039
<div class="informaltable"><table width="100%" border="0">
1040
<colgroup>
1041
<col width="150px" class="parameters_name">
1042
<col class="parameters_description">
1043
<col width="200px" class="parameters_annotations">
1044
</colgroup>
1045
<tbody>
1046
<tr>
1047
<td class="parameter_name"><p>proxy</p></td>
1048
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-remote-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_new_remote_connection()</code></a>
1049
was called</p></td>
1050
<td class="parameter_annotations"> </td>
1051
</tr>
1052
<tr>
1053
<td class="parameter_name"><p>arg_Handle</p></td>
1054
<td class="parameter_description"><p>The handle of the participant who opened the new connection (<span class="type">TpContactHandle</span>)</p></td>
1055
<td class="parameter_annotations"> </td>
1056
</tr>
1057
<tr>
1058
<td class="parameter_name"><p>arg_Connection_Param</p></td>
1059
<td class="parameter_description"><p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A parameter which can be used by the listening process to identify the connection. Note that this parameter has a meaningful value only in the Socket_Access_Control_Port and Socket_Access_Control_Credentials cases. If a different Socket_Access_Control has been chosen when offering the tube, this parameter should be ignored.</p> <p>In the Socket_Access_Control_Port case, the variant contains a struct Socket_Address_IPv4 (or Socket_Address_IPv6) containing the address from which the CM is connected to the client application.</p> <p>In the Socket_Access_Control_Credentials case, the variant contains the byte (D-Bus signature 'y') that has been sent with the credentials.</p></p></td>
1060
<td class="parameter_annotations"> </td>
1061
</tr>
1062
<tr>
1063
<td class="parameter_name"><p>arg_Connection_ID</p></td>
1064
<td class="parameter_description"><p>The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (<span class="type">TpStreamTubeConnectionID</span>)</p></td>
1065
<td class="parameter_annotations"> </td>
1066
</tr>
1067
<tr>
1068
<td class="parameter_name"><p>user_data</p></td>
1069
<td class="parameter_description"><p>User-supplied data</p></td>
1070
<td class="parameter_annotations"> </td>
1071
</tr>
1072
<tr>
1073
<td class="parameter_name"><p>weak_object</p></td>
1074
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
1075
<td class="parameter_annotations"> </td>
1076
</tr>
1077
</tbody>
1078
</table></div>
1079
</div>
1080
</div>
1081
<hr>
1082
<div class="refsect2">
1083
<a name="tp-cli-channel-type-stream-tube-signal-callback-new-local-connection"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()</h3>
1084
<pre class="programlisting"><span class="returnvalue">void</span>
1085
<span class="c_punctuation">(</span>*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection<span class="c_punctuation">)</span>
1086
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1087
<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_Connection_ID</code></em>,
1088
<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>,
1089
<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>
1090
<p>Represents the signature of a callback for the signal NewLocalConnection.</p>
1091
<div class="refsect3">
1092
<a name="id-1.4.34.7.14.5"></a><h4>Parameters</h4>
1093
<div class="informaltable"><table width="100%" border="0">
1094
<colgroup>
1095
<col width="150px" class="parameters_name">
1096
<col class="parameters_description">
1097
<col width="200px" class="parameters_annotations">
1098
</colgroup>
1099
<tbody>
1100
<tr>
1101
<td class="parameter_name"><p>proxy</p></td>
1102
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-local-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_new_local_connection()</code></a>
1103
was called</p></td>
1104
<td class="parameter_annotations"> </td>
1105
</tr>
1106
<tr>
1107
<td class="parameter_name"><p>arg_Connection_ID</p></td>
1108
<td class="parameter_description"><p>The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (<span class="type">TpStreamTubeConnectionID</span>)</p></td>
1109
<td class="parameter_annotations"> </td>
1110
</tr>
1111
<tr>
1112
<td class="parameter_name"><p>user_data</p></td>
1113
<td class="parameter_description"><p>User-supplied data</p></td>
1114
<td class="parameter_annotations"> </td>
1115
</tr>
1116
<tr>
1117
<td class="parameter_name"><p>weak_object</p></td>
1118
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
1119
<td class="parameter_annotations"> </td>
1120
</tr>
1121
</tbody>
1122
</table></div>
1123
</div>
1124
</div>
1125
<hr>
1126
<div class="refsect2">
1127
<a name="tp-cli-channel-type-stream-tube-signal-callback-connection-closed"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()</h3>
1128
<pre class="programlisting"><span class="returnvalue">void</span>
1129
<span class="c_punctuation">(</span>*tp_cli_channel_type_stream_tube_signal_callback_connection_closed<span class="c_punctuation">)</span>
1130
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1131
<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_Connection_ID</code></em>,
1132
<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_Error</code></em>,
1133
<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_Message</code></em>,
1134
<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>,
1135
<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>
1136
<p>Represents the signature of a callback for the signal ConnectionClosed.</p>
1137
<div class="refsect3">
1138
<a name="id-1.4.34.7.15.5"></a><h4>Parameters</h4>
1139
<div class="informaltable"><table width="100%" border="0">
1140
<colgroup>
1141
<col width="150px" class="parameters_name">
1142
<col class="parameters_description">
1143
<col width="200px" class="parameters_annotations">
1144
</colgroup>
1145
<tbody>
1146
<tr>
1147
<td class="parameter_name"><p>proxy</p></td>
1148
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-connection-closed" title="tp_cli_channel_type_stream_tube_connect_to_connection_closed ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_connection_closed()</code></a>
1149
was called</p></td>
1150
<td class="parameter_annotations"> </td>
1151
</tr>
1152
<tr>
1153
<td class="parameter_name"><p>arg_Connection_ID</p></td>
1154
<td class="parameter_description"><p>The ID of the connection. (<span class="type">TpStreamTubeConnectionID</span>)</p></td>
1155
<td class="parameter_annotations"> </td>
1156
</tr>
1157
<tr>
1158
<td class="parameter_name"><p>arg_Error</p></td>
1159
<td class="parameter_description"><p><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The name of a D-Bus error describing the error that occurred.</p> <p>The following errors can be used:</p> <ul> <li><code>org.freedesktop.Telepathy.Error.Cancelled</code>: user closed the socket or the tube.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionLost</code>: the bytestream relaying connection's data has been broken.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionRefused</code>: the tube offer refused the connection.</li> </ul></p></td>
1160
<td class="parameter_annotations"> </td>
1161
</tr>
1162
<tr>
1163
<td class="parameter_name"><p>arg_Message</p></td>
1164
<td class="parameter_description"><p>A debug message.</p></td>
1165
<td class="parameter_annotations"> </td>
1166
</tr>
1167
<tr>
1168
<td class="parameter_name"><p>user_data</p></td>
1169
<td class="parameter_description"><p>User-supplied data</p></td>
1170
<td class="parameter_annotations"> </td>
1171
</tr>
1172
<tr>
1173
<td class="parameter_name"><p>weak_object</p></td>
1174
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
1175
<td class="parameter_annotations"> </td>
1176
</tr>
1177
</tbody>
1178
</table></div>
1179
</div>
1180
</div>
1181
<hr>
1182
<div class="refsect2">
1183
<a name="tp-cli-channel-type-dbus-tube-run-offer"></a><h3>tp_cli_channel_type_dbus_tube_run_offer ()</h3>
1184
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1185
tp_cli_channel_type_dbus_tube_run_offer
1186
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1187
<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>,
1188
<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_parameters</code></em>,
1189
<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_access_control</code></em>,
1190
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
1191
<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>,
1192
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
1193
<div class="warning"><p><code class="literal">tp_cli_channel_type_dbus_tube_run_offer</code> is deprecated and should not be used in newly-written code.</p></div>
1194
<p>Call the method Offer and run the main loop
1195
until it returns. Before calling this method, you must
1196
add a reference to any borrowed objects you need to keep,
1197
and generally ensure that everything is in a consistent
1198
state.</p>
1199
<p>Offers a D-Bus tube providing the service specified.</p>
1200
<div class="refsect3">
1201
<a name="id-1.4.34.7.16.7"></a><h4>Parameters</h4>
1202
<div class="informaltable"><table width="100%" border="0">
1203
<colgroup>
1204
<col width="150px" class="parameters_name">
1205
<col class="parameters_description">
1206
<col width="200px" class="parameters_annotations">
1207
</colgroup>
1208
<tbody>
1209
<tr>
1210
<td class="parameter_name"><p>proxy</p></td>
1211
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
1212
<td class="parameter_annotations"> </td>
1213
</tr>
1214
<tr>
1215
<td class="parameter_name"><p>timeout_ms</p></td>
1216
<td class="parameter_description"><p>Timeout in milliseconds, or -1 for default</p></td>
1217
<td class="parameter_annotations"> </td>
1218
</tr>
1219
<tr>
1220
<td class="parameter_name"><p>in_parameters</p></td>
1221
<td class="parameter_description"><p>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</p></td>
1222
<td class="parameter_annotations"> </td>
1223
</tr>
1224
<tr>
1225
<td class="parameter_name"><p>in_access_control</p></td>
1226
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
1227
<td class="parameter_annotations"> </td>
1228
</tr>
1229
<tr>
1230
<td class="parameter_name"><p>out_address</p></td>
1231
<td class="parameter_description"><p>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</p></td>
1232
<td class="parameter_annotations"> </td>
1233
</tr>
1234
<tr>
1235
<td class="parameter_name"><p>error</p></td>
1236
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1237
is returned</p></td>
1238
<td class="parameter_annotations"> </td>
1239
</tr>
1240
<tr>
1241
<td class="parameter_name"><p>loop</p></td>
1242
<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>, set before re-entering
1243
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
1244
which can be used to cancel this call with
1245
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
1246
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em>
1247
set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a></p></td>
1248
<td class="parameter_annotations"> </td>
1249
</tr>
1250
</tbody>
1251
</table></div>
1252
</div>
1253
<div class="refsect3">
1254
<a name="id-1.4.34.7.16.8"></a><h4>Returns</h4>
1255
<p> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em>
1256
on error</p>
1257
<p></p>
1258
</div>
1259
</div>
1260
<hr>
1261
<div class="refsect2">
1262
<a name="tp-cli-channel-type-dbus-tube-run-accept"></a><h3>tp_cli_channel_type_dbus_tube_run_accept ()</h3>
1263
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1264
tp_cli_channel_type_dbus_tube_run_accept
1265
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1266
<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>,
1267
<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_access_control</code></em>,
1268
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
1269
<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>,
1270
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
1271
<div class="warning"><p><code class="literal">tp_cli_channel_type_dbus_tube_run_accept</code> is deprecated and should not be used in newly-written code.</p></div>
1272
<p>Call the method Accept and run the main loop
1273
until it returns. Before calling this method, you must
1274
add a reference to any borrowed objects you need to keep,
1275
and generally ensure that everything is in a consistent
1276
state.</p>
1277
<p>Accept a D-Bus tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.</p>
1278
<div class="refsect3">
1279
<a name="id-1.4.34.7.17.7"></a><h4>Parameters</h4>
1280
<div class="informaltable"><table width="100%" border="0">
1281
<colgroup>
1282
<col width="150px" class="parameters_name">
1283
<col class="parameters_description">
1284
<col width="200px" class="parameters_annotations">
1285
</colgroup>
1286
<tbody>
1287
<tr>
1288
<td class="parameter_name"><p>proxy</p></td>
1289
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
1290
<td class="parameter_annotations"> </td>
1291
</tr>
1292
<tr>
1293
<td class="parameter_name"><p>timeout_ms</p></td>
1294
<td class="parameter_description"><p>Timeout in milliseconds, or -1 for default</p></td>
1295
<td class="parameter_annotations"> </td>
1296
</tr>
1297
<tr>
1298
<td class="parameter_name"><p>in_access_control</p></td>
1299
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
1300
<td class="parameter_annotations"> </td>
1301
</tr>
1302
<tr>
1303
<td class="parameter_name"><p>out_address</p></td>
1304
<td class="parameter_description"><p>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</p></td>
1305
<td class="parameter_annotations"> </td>
1306
</tr>
1307
<tr>
1308
<td class="parameter_name"><p>error</p></td>
1309
<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 return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1310
is returned</p></td>
1311
<td class="parameter_annotations"> </td>
1312
</tr>
1313
<tr>
1314
<td class="parameter_name"><p>loop</p></td>
1315
<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>, set before re-entering
1316
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
1317
which can be used to cancel this call with
1318
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
1319
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em>
1320
set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a></p></td>
1321
<td class="parameter_annotations"> </td>
1322
</tr>
1323
</tbody>
1324
</table></div>
1325
</div>
1326
<div class="refsect3">
1327
<a name="id-1.4.34.7.17.8"></a><h4>Returns</h4>
1328
<p> TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em>
1329
on error</p>
1330
<p></p>
1331
</div>
1332
</div>
1333
<hr>
1334
<div class="refsect2">
1335
<a name="tp-cli-channel-type-dbus-tube-call-offer"></a><h3>tp_cli_channel_type_dbus_tube_call_offer ()</h3>
1336
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
1337
tp_cli_channel_type_dbus_tube_call_offer
1338
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1339
<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>,
1340
<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_parameters</code></em>,
1341
<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_access_control</code></em>,
1342
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-offer" title="tp_cli_channel_type_dbus_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_offer</span></a> callback</code></em>,
1343
<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>,
1344
<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>,
1345
<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>
1346
<p>Start a Offer method call.</p>
1347
<p>Offers a D-Bus tube providing the service specified.</p>
1348
<div class="refsect3">
1349
<a name="id-1.4.34.7.18.6"></a><h4>Parameters</h4>
1350
<div class="informaltable"><table width="100%" border="0">
1351
<colgroup>
1352
<col width="150px" class="parameters_name">
1353
<col class="parameters_description">
1354
<col width="200px" class="parameters_annotations">
1355
</colgroup>
1356
<tbody>
1357
<tr>
1358
<td class="parameter_name"><p>proxy</p></td>
1359
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
1360
<td class="parameter_annotations"> </td>
1361
</tr>
1362
<tr>
1363
<td class="parameter_name"><p>timeout_ms</p></td>
1364
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
1365
default</p></td>
1366
<td class="parameter_annotations"> </td>
1367
</tr>
1368
<tr>
1369
<td class="parameter_name"><p>in_parameters</p></td>
1370
<td class="parameter_description"><p>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</p></td>
1371
<td class="parameter_annotations"> </td>
1372
</tr>
1373
<tr>
1374
<td class="parameter_name"><p>in_access_control</p></td>
1375
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
1376
<td class="parameter_annotations"> </td>
1377
</tr>
1378
<tr>
1379
<td class="parameter_name"><p>callback</p></td>
1380
<td class="parameter_description"><p>called when the method call succeeds or fails;
1381
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
1382
reply tracking</p></td>
1383
<td class="parameter_annotations"> </td>
1384
</tr>
1385
<tr>
1386
<td class="parameter_name"><p>user_data</p></td>
1387
<td class="parameter_description"><p>user-supplied data passed to the callback;
1388
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>
1389
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1390
<td class="parameter_annotations"> </td>
1391
</tr>
1392
<tr>
1393
<td class="parameter_name"><p>destroy</p></td>
1394
<td class="parameter_description"><p>called with the user_data as argument, after the
1395
call has succeeded, failed or been cancelled;
1396
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>
1397
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1398
<td class="parameter_annotations"> </td>
1399
</tr>
1400
<tr>
1401
<td class="parameter_name"><p>weak_object</p></td>
1402
<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
1403
weakly referenced; if it is destroyed, this call
1404
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
1405
<em class="parameter"><code>callback</code></em>
1406
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1407
<td class="parameter_annotations"> </td>
1408
</tr>
1409
</tbody>
1410
</table></div>
1411
</div>
1412
<div class="refsect3">
1413
<a name="id-1.4.34.7.18.7"></a><h4>Returns</h4>
1414
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1415
progress. It is borrowed from the object, and will become
1416
invalid when the callback is called, the call is
1417
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
1418
<p></p>
1419
</div>
1420
</div>
1421
<hr>
1422
<div class="refsect2">
1423
<a name="tp-cli-channel-type-dbus-tube-call-accept"></a><h3>tp_cli_channel_type_dbus_tube_call_accept ()</h3>
1424
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *
1425
tp_cli_channel_type_dbus_tube_call_accept
1426
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1427
<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>,
1428
<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_access_control</code></em>,
1429
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-accept" title="tp_cli_channel_type_dbus_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_accept</span></a> callback</code></em>,
1430
<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>,
1431
<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>,
1432
<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>
1433
<p>Start a Accept method call.</p>
1434
<p>Accept a D-Bus tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.</p>
1435
<div class="refsect3">
1436
<a name="id-1.4.34.7.19.6"></a><h4>Parameters</h4>
1437
<div class="informaltable"><table width="100%" border="0">
1438
<colgroup>
1439
<col width="150px" class="parameters_name">
1440
<col class="parameters_description">
1441
<col width="200px" class="parameters_annotations">
1442
</colgroup>
1443
<tbody>
1444
<tr>
1445
<td class="parameter_name"><p>proxy</p></td>
1446
<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>
1447
<td class="parameter_annotations"> </td>
1448
</tr>
1449
<tr>
1450
<td class="parameter_name"><p>timeout_ms</p></td>
1451
<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the
1452
default</p></td>
1453
<td class="parameter_annotations"> </td>
1454
</tr>
1455
<tr>
1456
<td class="parameter_name"><p>in_access_control</p></td>
1457
<td class="parameter_description"><p>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</p></td>
1458
<td class="parameter_annotations"> </td>
1459
</tr>
1460
<tr>
1461
<td class="parameter_name"><p>callback</p></td>
1462
<td class="parameter_description"><p>called when the method call succeeds or fails;
1463
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
1464
reply tracking</p></td>
1465
<td class="parameter_annotations"> </td>
1466
</tr>
1467
<tr>
1468
<td class="parameter_name"><p>user_data</p></td>
1469
<td class="parameter_description"><p>user-supplied data passed to the callback;
1470
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>
1471
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1472
<td class="parameter_annotations"> </td>
1473
</tr>
1474
<tr>
1475
<td class="parameter_name"><p>destroy</p></td>
1476
<td class="parameter_description"><p>called with the user_data as argument, after the
1477
call has succeeded, failed or been cancelled;
1478
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>
1479
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1480
<td class="parameter_annotations"> </td>
1481
</tr>
1482
<tr>
1483
<td class="parameter_name"><p>weak_object</p></td>
1484
<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
1485
weakly referenced; if it is destroyed, this call
1486
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
1487
<em class="parameter"><code>callback</code></em>
1488
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1489
<td class="parameter_annotations"> </td>
1490
</tr>
1491
</tbody>
1492
</table></div>
1493
</div>
1494
<div class="refsect3">
1495
<a name="id-1.4.34.7.19.7"></a><h4>Returns</h4>
1496
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1497
progress. It is borrowed from the object, and will become
1498
invalid when the callback is called, the call is
1499
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>
1500
<p></p>
1501
</div>
1502
</div>
1503
<hr>
1504
<div class="refsect2">
1505
<a name="tp-cli-channel-type-dbus-tube-callback-for-offer"></a><h3>tp_cli_channel_type_dbus_tube_callback_for_offer ()</h3>
1506
<pre class="programlisting"><span class="returnvalue">void</span>
1507
<span class="c_punctuation">(</span>*tp_cli_channel_type_dbus_tube_callback_for_offer<span class="c_punctuation">)</span>
1508
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1509
<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_address</code></em>,
1510
<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>,
1511
<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>,
1512
<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>
1513
<p>Signature of the callback called when a Offer method call
1514
succeeds or fails.</p>
1515
<div class="refsect3">
1516
<a name="id-1.4.34.7.20.5"></a><h4>Parameters</h4>
1517
<div class="informaltable"><table width="100%" border="0">
1518
<colgroup>
1519
<col width="150px" class="parameters_name">
1520
<col class="parameters_description">
1521
<col width="200px" class="parameters_annotations">
1522
</colgroup>
1523
<tbody>
1524
<tr>
1525
<td class="parameter_name"><p>proxy</p></td>
1526
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
1527
<td class="parameter_annotations"> </td>
1528
</tr>
1529
<tr>
1530
<td class="parameter_name"><p>out_address</p></td>
1531
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
1532
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</p></td>
1533
<td class="parameter_annotations"> </td>
1534
</tr>
1535
<tr>
1536
<td class="parameter_name"><p>error</p></td>
1537
<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>
1538
<td class="parameter_annotations"> </td>
1539
</tr>
1540
<tr>
1541
<td class="parameter_name"><p>user_data</p></td>
1542
<td class="parameter_description"><p>user-supplied data</p></td>
1543
<td class="parameter_annotations"> </td>
1544
</tr>
1545
<tr>
1546
<td class="parameter_name"><p>weak_object</p></td>
1547
<td class="parameter_description"><p>user-supplied object</p></td>
1548
<td class="parameter_annotations"> </td>
1549
</tr>
1550
</tbody>
1551
</table></div>
1552
</div>
1553
</div>
1554
<hr>
1555
<div class="refsect2">
1556
<a name="tp-cli-channel-type-dbus-tube-callback-for-accept"></a><h3>tp_cli_channel_type_dbus_tube_callback_for_accept ()</h3>
1557
<pre class="programlisting"><span class="returnvalue">void</span>
1558
<span class="c_punctuation">(</span>*tp_cli_channel_type_dbus_tube_callback_for_accept<span class="c_punctuation">)</span>
1559
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1560
<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_address</code></em>,
1561
<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>,
1562
<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>,
1563
<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>
1564
<div class="warning"><p><code class="literal">tp_cli_channel_type_dbus_tube_callback_for_accept</code> is deprecated and should not be used in newly-written code.</p></div>
1565
<p>Signature of the callback called when a Accept method call
1566
succeeds or fails.</p>
1567
<div class="refsect3">
1568
<a name="id-1.4.34.7.21.6"></a><h4>Parameters</h4>
1569
<div class="informaltable"><table width="100%" border="0">
1570
<colgroup>
1571
<col width="150px" class="parameters_name">
1572
<col class="parameters_description">
1573
<col width="200px" class="parameters_annotations">
1574
</colgroup>
1575
<tbody>
1576
<tr>
1577
<td class="parameter_name"><p>proxy</p></td>
1578
<td class="parameter_description"><p>the proxy on which the call was made</p></td>
1579
<td class="parameter_annotations"> </td>
1580
</tr>
1581
<tr>
1582
<td class="parameter_name"><p>out_address</p></td>
1583
<td class="parameter_description"><p>Used to return an 'out' argument if <em class="parameter"><code>error</code></em>
1584
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</p></td>
1585
<td class="parameter_annotations"> </td>
1586
</tr>
1587
<tr>
1588
<td class="parameter_name"><p>error</p></td>
1589
<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>
1590
<td class="parameter_annotations"> </td>
1591
</tr>
1592
<tr>
1593
<td class="parameter_name"><p>user_data</p></td>
1594
<td class="parameter_description"><p>user-supplied data</p></td>
1595
<td class="parameter_annotations"> </td>
1596
</tr>
1597
<tr>
1598
<td class="parameter_name"><p>weak_object</p></td>
1599
<td class="parameter_description"><p>user-supplied object</p></td>
1600
<td class="parameter_annotations"> </td>
1601
</tr>
1602
</tbody>
1603
</table></div>
1604
</div>
1605
</div>
1606
<hr>
1607
<div class="refsect2">
1608
<a name="tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed"></a><h3>tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()</h3>
1609
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *
1610
tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed
1611
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1612
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()"><span class="type">tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</span></a> callback</code></em>,
1613
<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>,
1614
<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>,
1615
<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>,
1616
<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>
1617
<p>Connect a handler to the signal DBusNamesChanged.</p>
1618
<p>Emitted on a multi-user (i.e. Handle_Type_Room) D-Bus tube when a participant opens or closes the tube. This provides change notification for the <tp:member-ref>DBusNames</tp:member-ref> property.</p>
1619
<div class="refsect3">
1620
<a name="id-1.4.34.7.22.6"></a><h4>Parameters</h4>
1621
<div class="informaltable"><table width="100%" border="0">
1622
<colgroup>
1623
<col width="150px" class="parameters_name">
1624
<col class="parameters_description">
1625
<col width="200px" class="parameters_annotations">
1626
</colgroup>
1627
<tbody>
1628
<tr>
1629
<td class="parameter_name"><p>proxy</p></td>
1630
<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</p></td>
1631
<td class="parameter_annotations"> </td>
1632
</tr>
1633
<tr>
1634
<td class="parameter_name"><p>callback</p></td>
1635
<td class="parameter_description"><p>Callback to be called when the signal is
1636
received</p></td>
1637
<td class="parameter_annotations"> </td>
1638
</tr>
1639
<tr>
1640
<td class="parameter_name"><p>user_data</p></td>
1641
<td class="parameter_description"><p>User-supplied data for the callback</p></td>
1642
<td class="parameter_annotations"> </td>
1643
</tr>
1644
<tr>
1645
<td class="parameter_name"><p>destroy</p></td>
1646
<td class="parameter_description"><p>Destructor for the user-supplied data, which
1647
will be called when this signal is disconnected, or
1648
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>
1649
<td class="parameter_annotations"> </td>
1650
</tr>
1651
<tr>
1652
<td class="parameter_name"><p>weak_object</p></td>
1653
<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;
1654
if it is destroyed, this callback will automatically be
1655
disconnected</p></td>
1656
<td class="parameter_annotations"> </td>
1657
</tr>
1658
<tr>
1659
<td class="parameter_name"><p>error</p></td>
1660
<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
1661
returned</p></td>
1662
<td class="parameter_annotations"> </td>
1663
</tr>
1664
</tbody>
1665
</table></div>
1666
</div>
1667
<div class="refsect3">
1668
<a name="id-1.4.34.7.22.7"></a><h4>Returns</h4>
1669
<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
1670
above, which can be used to disconnect the signal; or
1671
<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
1672
or has become invalid.</p>
1673
<p></p>
1674
</div>
1675
</div>
1676
<hr>
1677
<div class="refsect2">
1678
<a name="tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed"></a><h3>tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()</h3>
1679
<pre class="programlisting"><span class="returnvalue">void</span>
1680
<span class="c_punctuation">(</span>*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed<span class="c_punctuation">)</span>
1681
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1682
<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_Added</code></em>,
1683
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *arg_Removed</code></em>,
1684
<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>,
1685
<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>
1686
<div class="warning"><p><code class="literal">tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</code> is deprecated and should not be used in newly-written code.</p></div>
1687
<p>Represents the signature of a callback for the signal DBusNamesChanged.</p>
1688
<div class="refsect3">
1689
<a name="id-1.4.34.7.23.6"></a><h4>Parameters</h4>
1690
<div class="informaltable"><table width="100%" border="0">
1691
<colgroup>
1692
<col width="150px" class="parameters_name">
1693
<col class="parameters_description">
1694
<col width="200px" class="parameters_annotations">
1695
</colgroup>
1696
<tbody>
1697
<tr>
1698
<td class="parameter_name"><p>proxy</p></td>
1699
<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()"><code class="function">tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed()</code></a>
1700
was called</p></td>
1701
<td class="parameter_annotations"> </td>
1702
</tr>
1703
<tr>
1704
<td class="parameter_name"><p>arg_Added</p></td>
1705
<td class="parameter_description"><p>Array of handles and D-Bus names of new participants.</p></td>
1706
<td class="parameter_annotations"> </td>
1707
</tr>
1708
<tr>
1709
<td class="parameter_name"><p>arg_Removed</p></td>
1710
<td class="parameter_description"><p>Array of handles of former participants.</p></td>
1711
<td class="parameter_annotations"> </td>
1712
</tr>
1713
<tr>
1714
<td class="parameter_name"><p>user_data</p></td>
1715
<td class="parameter_description"><p>User-supplied data</p></td>
1716
<td class="parameter_annotations"> </td>
1717
</tr>
1718
<tr>
1719
<td class="parameter_name"><p>weak_object</p></td>
1720
<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>
1721
<td class="parameter_annotations"> </td>
1722
</tr>
1723
</tbody>
1724
</table></div>
1725
</div>
1726
</div>
1727
</div>
1728
<div class="refsect1">
1729
<a name="telepathy-glib-channel-tube.other_details"></a><h2>Types and Values</h2>
210
channel interface, StreamTube channel type and DBusTube channel type.
211
</p>
212
</div>
213
<div class="refsect1">
214
<a name="telepathy-glib-channel-tube.details"></a><h2>Details</h2>
215
<div class="refsect2">
216
<a name="tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed"></a><h3>tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()</h3>
217
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed
218
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
219
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed" title="tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()"><span class="type">tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed</span></a> callback</code></em>,
220
<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>,
221
<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>,
222
<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>,
223
<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>
224
<p>
225
Connect a handler to the signal TubeChannelStateChanged.
226
</p>
227
<p>
228
Emitted when the state of the tube channel changes. Valid state transitions are documented with <tp:type>Tube_Channel_State</tp:type>.
229
</p>
230
<div class="variablelist"><table border="0" class="variablelist">
231
<colgroup>
232
<col align="left" valign="top">
233
<col>
234
</colgroup>
235
<tbody>
236
<tr>
237
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
238
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
239
</tr>
240
<tr>
241
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
242
<td>Callback to be called when the signal is
243
received</td>
244
</tr>
245
<tr>
246
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
247
<td>User-supplied data for the callback</td>
248
</tr>
249
<tr>
250
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
251
<td>Destructor for the user-supplied data, which
252
will be called when this signal is disconnected, or
253
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>
254
</td>
255
</tr>
256
<tr>
257
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
258
<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;
259
if it is destroyed, this callback will automatically be
260
disconnected</td>
261
</tr>
262
<tr>
263
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
264
<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
265
returned</td>
266
</tr>
267
<tr>
268
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
269
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
270
above, which can be used to disconnect the signal; or
271
<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
272
or has become invalid.</td>
273
</tr>
274
</tbody>
275
</table></div>
276
</div>
277
<hr>
278
<div class="refsect2">
279
<a name="tp-cli-channel-interface-tube-signal-callback-tube-channel-state-changed"></a><h3>tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed ()</h3>
280
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed)
281
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
282
<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_State</code></em>,
283
<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>,
284
<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>
285
<p>
286
Represents the signature of a callback for the signal TubeChannelStateChanged.
287
</p>
288
<div class="variablelist"><table border="0" class="variablelist">
289
<colgroup>
290
<col align="left" valign="top">
291
<col>
292
</colgroup>
293
<tbody>
294
<tr>
295
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
296
<td>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-interface-tube-connect-to-tube-channel-state-changed" title="tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed ()"><code class="function">tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed()</code></a>
297
was called</td>
298
</tr>
299
<tr>
300
<td><p><span class="term"><em class="parameter"><code>arg_State</code></em> :</span></p></td>
301
<td>The new state of the tube. (<a class="link" href="telepathy-glib-enums.html#TpTubeChannelState" title="enum TpTubeChannelState"><span class="type">TpTubeChannelState</span></a>)</td>
302
</tr>
303
<tr>
304
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
305
<td>User-supplied data</td>
306
</tr>
307
<tr>
308
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
309
<td>User-supplied weakly referenced object</td>
310
</tr>
311
</tbody>
312
</table></div>
313
</div>
314
<hr>
315
<div class="refsect2">
316
<a name="tp-cli-channel-type-stream-tube-run-offer"></a><h3>tp_cli_channel_type_stream_tube_run_offer ()</h3>
317
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_channel_type_stream_tube_run_offer
318
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
319
<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>,
320
<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_address_type</code></em>,
321
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
322
<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_access_control</code></em>,
323
<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_parameters</code></em>,
324
<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>,
325
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
326
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
327
<h3 class="title">Warning</h3>
328
<p><code class="literal">tp_cli_channel_type_stream_tube_run_offer</code> is deprecated and should not be used in newly-written code.</p>
329
</div>
330
<p>
331
Call the method Offer and run the main loop
332
until it returns. Before calling this method, you must
333
add a reference to any borrowed objects you need to keep,
334
and generally ensure that everything is in a consistent
335
state.
336
</p>
337
<p>
338
Offer a stream tube exporting the local socket specified.
339
</p>
340
<div class="variablelist"><table border="0" class="variablelist">
341
<colgroup>
342
<col align="left" valign="top">
343
<col>
344
</colgroup>
345
<tbody>
346
<tr>
347
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
348
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
349
</tr>
350
<tr>
351
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
352
<td>Timeout in milliseconds, or -1 for default</td>
353
</tr>
354
<tr>
355
<td><p><span class="term"><em class="parameter"><code>in_address_type</code></em> :</span></p></td>
356
<td>Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</td>
357
</tr>
358
<tr>
359
<td><p><span class="term"><em class="parameter"><code>in_address</code></em> :</span></p></td>
360
<td>Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.</td>
361
</tr>
362
<tr>
363
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
364
<td>Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
365
</tr>
366
<tr>
367
<td><p><span class="term"><em class="parameter"><code>in_parameters</code></em> :</span></p></td>
368
<td>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</td>
369
</tr>
370
<tr>
371
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
372
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
373
is returned</td>
374
</tr>
375
<tr>
376
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
377
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
378
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
379
which can be used to cancel this call with
380
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
381
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
382
</td>
383
</tr>
384
<tr>
385
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
386
<td>TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error</td>
387
</tr>
388
</tbody>
389
</table></div>
390
</div>
391
<hr>
392
<div class="refsect2">
393
<a name="tp-cli-channel-type-stream-tube-run-accept"></a><h3>tp_cli_channel_type_stream_tube_run_accept ()</h3>
394
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_channel_type_stream_tube_run_accept
395
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
396
<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>,
397
<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_address_type</code></em>,
398
<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_access_control</code></em>,
399
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
400
<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> **out_address</code></em>,
401
<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>,
402
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
403
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
404
<h3 class="title">Warning</h3>
405
<p><code class="literal">tp_cli_channel_type_stream_tube_run_accept</code> is deprecated and should not be used in newly-written code.</p>
406
</div>
407
<p>
408
Call the method Accept and run the main loop
409
until it returns. Before calling this method, you must
410
add a reference to any borrowed objects you need to keep,
411
and generally ensure that everything is in a consistent
412
state.
413
</p>
414
<p>
415
Accept a stream tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
416
</p>
417
<div class="variablelist"><table border="0" class="variablelist">
418
<colgroup>
419
<col align="left" valign="top">
420
<col>
421
</colgroup>
422
<tbody>
423
<tr>
424
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
425
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
426
</tr>
427
<tr>
428
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
429
<td>Timeout in milliseconds, or -1 for default</td>
430
</tr>
431
<tr>
432
<td><p><span class="term"><em class="parameter"><code>in_address_type</code></em> :</span></p></td>
433
<td>Used to pass an 'in' argument: The type of address the connection manager should listen on. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</td>
434
</tr>
435
<tr>
436
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
437
<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
438
</tr>
439
<tr>
440
<td><p><span class="term"><em class="parameter"><code>in_access_control_param</code></em> :</span></p></td>
441
<td>Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum.</td>
442
</tr>
443
<tr>
444
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
445
<td>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The address on which the connection manager will listen for connections to this tube. The client should not attempt to connect to the address until the tube is open.</td>
446
</tr>
447
<tr>
448
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
449
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
450
is returned</td>
451
</tr>
452
<tr>
453
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
454
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
455
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
456
which can be used to cancel this call with
457
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
458
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
459
</td>
460
</tr>
461
<tr>
462
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
463
<td>TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error</td>
464
</tr>
465
</tbody>
466
</table></div>
467
</div>
468
<hr>
469
<div class="refsect2">
470
<a name="tp-cli-channel-type-stream-tube-call-offer"></a><h3>tp_cli_channel_type_stream_tube_call_offer ()</h3>
471
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_channel_type_stream_tube_call_offer
472
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
473
<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>,
474
<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_address_type</code></em>,
475
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_address</code></em>,
476
<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_access_control</code></em>,
477
<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_parameters</code></em>,
478
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-offer" title="tp_cli_channel_type_stream_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_offer</span></a> callback</code></em>,
479
<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>,
480
<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>,
481
<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>
482
<p>
483
Start a Offer method call.
484
</p>
485
<p>
486
Offer a stream tube exporting the local socket specified.
487
</p>
488
<div class="variablelist"><table border="0" class="variablelist">
489
<colgroup>
490
<col align="left" valign="top">
491
<col>
492
</colgroup>
493
<tbody>
494
<tr>
495
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
496
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
497
</td>
498
</tr>
499
<tr>
500
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
501
<td>the timeout in milliseconds, or -1 to use the
502
default</td>
503
</tr>
504
<tr>
505
<td><p><span class="term"><em class="parameter"><code>in_address_type</code></em> :</span></p></td>
506
<td>Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</td>
507
</tr>
508
<tr>
509
<td><p><span class="term"><em class="parameter"><code>in_address</code></em> :</span></p></td>
510
<td>Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.</td>
511
</tr>
512
<tr>
513
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
514
<td>Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
515
</tr>
516
<tr>
517
<td><p><span class="term"><em class="parameter"><code>in_parameters</code></em> :</span></p></td>
518
<td>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</td>
519
</tr>
520
<tr>
521
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
522
<td>called when the method call succeeds or fails;
523
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
524
reply tracking</td>
525
</tr>
526
<tr>
527
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
528
<td>user-supplied data passed to the callback;
529
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>
530
</td>
531
</tr>
532
<tr>
533
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
534
<td>called with the user_data as argument, after the
535
call has succeeded, failed or been cancelled;
536
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>
537
</td>
538
</tr>
539
<tr>
540
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
541
<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
542
weakly referenced; if it is destroyed, this call
543
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
544
<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>
545
</td>
546
</tr>
547
<tr>
548
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
549
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
550
progress. It is borrowed from the object, and will become
551
invalid when the callback is called, the call is
552
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
553
</tr>
554
</tbody>
555
</table></div>
556
</div>
557
<hr>
558
<div class="refsect2">
559
<a name="tp-cli-channel-type-stream-tube-call-accept"></a><h3>tp_cli_channel_type_stream_tube_call_accept ()</h3>
560
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_channel_type_stream_tube_call_accept
561
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
562
<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>,
563
<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_address_type</code></em>,
564
<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_access_control</code></em>,
565
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *in_access_control_param</code></em>,
566
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-callback-for-accept" title="tp_cli_channel_type_stream_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_stream_tube_callback_for_accept</span></a> callback</code></em>,
567
<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>,
568
<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>,
569
<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>
570
<p>
571
Start a Accept method call.
572
</p>
573
<p>
574
Accept a stream tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
575
</p>
576
<div class="variablelist"><table border="0" class="variablelist">
577
<colgroup>
578
<col align="left" valign="top">
579
<col>
580
</colgroup>
581
<tbody>
582
<tr>
583
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
584
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
585
</td>
586
</tr>
587
<tr>
588
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
589
<td>the timeout in milliseconds, or -1 to use the
590
default</td>
591
</tr>
592
<tr>
593
<td><p><span class="term"><em class="parameter"><code>in_address_type</code></em> :</span></p></td>
594
<td>Used to pass an 'in' argument: The type of address the connection manager should listen on. (<a class="link" href="telepathy-glib-enums.html#TpSocketAddressType" title="enum TpSocketAddressType"><span class="type">TpSocketAddressType</span></a>)</td>
595
</tr>
596
<tr>
597
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
598
<td>Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
599
</tr>
600
<tr>
601
<td><p><span class="term"><em class="parameter"><code>in_access_control_param</code></em> :</span></p></td>
602
<td>Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum.</td>
603
</tr>
604
<tr>
605
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
606
<td>called when the method call succeeds or fails;
607
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
608
reply tracking</td>
609
</tr>
610
<tr>
611
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
612
<td>user-supplied data passed to the callback;
613
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>
614
</td>
615
</tr>
616
<tr>
617
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
618
<td>called with the user_data as argument, after the
619
call has succeeded, failed or been cancelled;
620
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>
621
</td>
622
</tr>
623
<tr>
624
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
625
<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
626
weakly referenced; if it is destroyed, this call
627
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
628
<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>
629
</td>
630
</tr>
631
<tr>
632
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
633
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
634
progress. It is borrowed from the object, and will become
635
invalid when the callback is called, the call is
636
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
637
</tr>
638
</tbody>
639
</table></div>
640
</div>
641
<hr>
642
<div class="refsect2">
643
<a name="tp-cli-channel-type-stream-tube-callback-for-offer"></a><h3>tp_cli_channel_type_stream_tube_callback_for_offer ()</h3>
644
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_stream_tube_callback_for_offer)
645
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
646
<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>,
647
<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>,
648
<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>
649
<p>
650
Signature of the callback called when a Offer method call
651
succeeds or fails.
652
</p>
653
<div class="variablelist"><table border="0" class="variablelist">
654
<colgroup>
655
<col align="left" valign="top">
656
<col>
657
</colgroup>
658
<tbody>
659
<tr>
660
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
661
<td>the proxy on which the call was made</td>
662
</tr>
663
<tr>
664
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
665
<td>
666
<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>
667
</tr>
668
<tr>
669
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
670
<td>user-supplied data</td>
671
</tr>
672
<tr>
673
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
674
<td>user-supplied object</td>
675
</tr>
676
</tbody>
677
</table></div>
678
</div>
679
<hr>
680
<div class="refsect2">
681
<a name="tp-cli-channel-type-stream-tube-callback-for-accept"></a><h3>tp_cli_channel_type_stream_tube_callback_for_accept ()</h3>
682
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_stream_tube_callback_for_accept)
683
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
684
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *out_address</code></em>,
685
<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>,
686
<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>,
687
<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>
688
<p>
689
Signature of the callback called when a Accept method call
690
succeeds or fails.
691
</p>
692
<div class="variablelist"><table border="0" class="variablelist">
693
<colgroup>
694
<col align="left" valign="top">
695
<col>
696
</colgroup>
697
<tbody>
698
<tr>
699
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
700
<td>the proxy on which the call was made</td>
701
</tr>
702
<tr>
703
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
704
<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 address on which the connection manager will listen for connections to this tube. The client should not attempt to connect to the address until the tube is open.</td>
705
</tr>
706
<tr>
707
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
708
<td>
709
<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>
710
</tr>
711
<tr>
712
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
713
<td>user-supplied data</td>
714
</tr>
715
<tr>
716
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
717
<td>user-supplied object</td>
718
</tr>
719
</tbody>
720
</table></div>
721
</div>
722
<hr>
723
<div class="refsect2">
724
<a name="tp-cli-channel-type-stream-tube-connect-to-new-remote-connection"></a><h3>tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()</h3>
725
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_type_stream_tube_connect_to_new_remote_connection
726
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
727
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection</span></a> callback</code></em>,
728
<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>,
729
<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>,
730
<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>,
731
<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>
732
<p>
733
Connect a handler to the signal NewRemoteConnection.
734
</p>
735
<p>
736
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted each time a participant opens a new connection to its socket.</p> <p>This signal is only fired on the offering side.</p>
737
</p>
738
<div class="variablelist"><table border="0" class="variablelist">
739
<colgroup>
740
<col align="left" valign="top">
741
<col>
742
</colgroup>
743
<tbody>
744
<tr>
745
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
746
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
747
</tr>
748
<tr>
749
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
750
<td>Callback to be called when the signal is
751
received</td>
752
</tr>
753
<tr>
754
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
755
<td>User-supplied data for the callback</td>
756
</tr>
757
<tr>
758
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
759
<td>Destructor for the user-supplied data, which
760
will be called when this signal is disconnected, or
761
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>
762
</td>
763
</tr>
764
<tr>
765
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
766
<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;
767
if it is destroyed, this callback will automatically be
768
disconnected</td>
769
</tr>
770
<tr>
771
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
772
<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
773
returned</td>
774
</tr>
775
<tr>
776
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
777
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
778
above, which can be used to disconnect the signal; or
779
<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
780
or has become invalid.</td>
781
</tr>
782
</tbody>
783
</table></div>
784
</div>
785
<hr>
786
<div class="refsect2">
787
<a name="tp-cli-channel-type-stream-tube-connect-to-new-local-connection"></a><h3>tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()</h3>
788
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_type_stream_tube_connect_to_new_local_connection
789
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
790
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-new-local-connection" title="tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_new_local_connection</span></a> callback</code></em>,
791
<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>,
792
<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>,
793
<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>,
794
<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>
795
<p>
796
Connect a handler to the signal NewLocalConnection.
797
</p>
798
<p>
799
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the tube application connects to the CM's socket.</p> <p>This signal is only fired on the accepting side.</p>
800
</p>
801
<div class="variablelist"><table border="0" class="variablelist">
802
<colgroup>
803
<col align="left" valign="top">
804
<col>
805
</colgroup>
806
<tbody>
807
<tr>
808
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
809
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
810
</tr>
811
<tr>
812
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
813
<td>Callback to be called when the signal is
814
received</td>
815
</tr>
816
<tr>
817
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
818
<td>User-supplied data for the callback</td>
819
</tr>
820
<tr>
821
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
822
<td>Destructor for the user-supplied data, which
823
will be called when this signal is disconnected, or
824
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>
825
</td>
826
</tr>
827
<tr>
828
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
829
<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;
830
if it is destroyed, this callback will automatically be
831
disconnected</td>
832
</tr>
833
<tr>
834
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
835
<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
836
returned</td>
837
</tr>
838
<tr>
839
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
840
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
841
above, which can be used to disconnect the signal; or
842
<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
843
or has become invalid.</td>
844
</tr>
845
</tbody>
846
</table></div>
847
</div>
848
<hr>
849
<div class="refsect2">
850
<a name="tp-cli-channel-type-stream-tube-connect-to-connection-closed"></a><h3>tp_cli_channel_type_stream_tube_connect_to_connection_closed ()</h3>
851
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_type_stream_tube_connect_to_connection_closed
852
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
853
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-signal-callback-connection-closed" title="tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()"><span class="type">tp_cli_channel_type_stream_tube_signal_callback_connection_closed</span></a> callback</code></em>,
854
<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>,
855
<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>,
856
<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>,
857
<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>
858
<p>
859
Connect a handler to the signal ConnectionClosed.
860
</p>
861
<p>
862
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when a connection has been closed.</p>
863
</p>
864
<div class="variablelist"><table border="0" class="variablelist">
865
<colgroup>
866
<col align="left" valign="top">
867
<col>
868
</colgroup>
869
<tbody>
870
<tr>
871
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
872
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
873
</tr>
874
<tr>
875
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
876
<td>Callback to be called when the signal is
877
received</td>
878
</tr>
879
<tr>
880
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
881
<td>User-supplied data for the callback</td>
882
</tr>
883
<tr>
884
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
885
<td>Destructor for the user-supplied data, which
886
will be called when this signal is disconnected, or
887
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>
888
</td>
889
</tr>
890
<tr>
891
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
892
<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;
893
if it is destroyed, this callback will automatically be
894
disconnected</td>
895
</tr>
896
<tr>
897
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
898
<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
899
returned</td>
900
</tr>
901
<tr>
902
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
903
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
904
above, which can be used to disconnect the signal; or
905
<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
906
or has become invalid.</td>
907
</tr>
908
</tbody>
909
</table></div>
910
</div>
911
<hr>
912
<div class="refsect2">
913
<a name="tp-cli-channel-type-stream-tube-signal-callback-new-remote-connection"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection ()</h3>
914
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection)
915
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
916
<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_Handle</code></em>,
917
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *arg_Connection_Param</code></em>,
918
<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_Connection_ID</code></em>,
919
<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>,
920
<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>
921
<p>
922
Represents the signature of a callback for the signal NewRemoteConnection.
923
</p>
924
<div class="variablelist"><table border="0" class="variablelist">
925
<colgroup>
926
<col align="left" valign="top">
927
<col>
928
</colgroup>
929
<tbody>
930
<tr>
931
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
932
<td>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-remote-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_remote_connection ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_new_remote_connection()</code></a>
933
was called</td>
934
</tr>
935
<tr>
936
<td><p><span class="term"><em class="parameter"><code>arg_Handle</code></em> :</span></p></td>
937
<td>The handle of the participant who opened the new connection (<span class="type">TpContactHandle</span>)</td>
938
</tr>
939
<tr>
940
<td><p><span class="term"><em class="parameter"><code>arg_Connection_Param</code></em> :</span></p></td>
941
<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A parameter which can be used by the listening process to identify the connection. Note that this parameter has a meaningful value only in the Socket_Access_Control_Port and Socket_Access_Control_Credentials cases. If a different Socket_Access_Control has been chosen when offering the tube, this parameter should be ignored.</p> <p>In the Socket_Access_Control_Port case, the variant contains a struct Socket_Address_IPv4 (or Socket_Address_IPv6) containing the address from which the CM is connected to the client application.</p> <p>In the Socket_Access_Control_Credentials case, the variant contains the byte (D-Bus signature 'y') that has been sent with the credentials.</p></td>
942
</tr>
943
<tr>
944
<td><p><span class="term"><em class="parameter"><code>arg_Connection_ID</code></em> :</span></p></td>
945
<td>The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (<span class="type">TpStreamTubeConnectionID</span>)</td>
946
</tr>
947
<tr>
948
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
949
<td>User-supplied data</td>
950
</tr>
951
<tr>
952
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
953
<td>User-supplied weakly referenced object</td>
954
</tr>
955
</tbody>
956
</table></div>
957
</div>
958
<hr>
959
<div class="refsect2">
960
<a name="tp-cli-channel-type-stream-tube-signal-callback-new-local-connection"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_new_local_connection ()</h3>
961
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection)
962
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
963
<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_Connection_ID</code></em>,
964
<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>,
965
<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>
966
<p>
967
Represents the signature of a callback for the signal NewLocalConnection.
968
</p>
969
<div class="variablelist"><table border="0" class="variablelist">
970
<colgroup>
971
<col align="left" valign="top">
972
<col>
973
</colgroup>
974
<tbody>
975
<tr>
976
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
977
<td>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-new-local-connection" title="tp_cli_channel_type_stream_tube_connect_to_new_local_connection ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_new_local_connection()</code></a>
978
was called</td>
979
</tr>
980
<tr>
981
<td><p><span class="term"><em class="parameter"><code>arg_Connection_ID</code></em> :</span></p></td>
982
<td>The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (<span class="type">TpStreamTubeConnectionID</span>)</td>
983
</tr>
984
<tr>
985
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
986
<td>User-supplied data</td>
987
</tr>
988
<tr>
989
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
990
<td>User-supplied weakly referenced object</td>
991
</tr>
992
</tbody>
993
</table></div>
994
</div>
995
<hr>
996
<div class="refsect2">
997
<a name="tp-cli-channel-type-stream-tube-signal-callback-connection-closed"></a><h3>tp_cli_channel_type_stream_tube_signal_callback_connection_closed ()</h3>
998
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_stream_tube_signal_callback_connection_closed)
999
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1000
<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_Connection_ID</code></em>,
1001
<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_Error</code></em>,
1002
<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_Message</code></em>,
1003
<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>,
1004
<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>
1005
<p>
1006
Represents the signature of a callback for the signal ConnectionClosed.
1007
</p>
1008
<div class="variablelist"><table border="0" class="variablelist">
1009
<colgroup>
1010
<col align="left" valign="top">
1011
<col>
1012
</colgroup>
1013
<tbody>
1014
<tr>
1015
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1016
<td>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-stream-tube-connect-to-connection-closed" title="tp_cli_channel_type_stream_tube_connect_to_connection_closed ()"><code class="function">tp_cli_channel_type_stream_tube_connect_to_connection_closed()</code></a>
1017
was called</td>
1018
</tr>
1019
<tr>
1020
<td><p><span class="term"><em class="parameter"><code>arg_Connection_ID</code></em> :</span></p></td>
1021
<td>The ID of the connection. (<span class="type">TpStreamTubeConnectionID</span>)</td>
1022
</tr>
1023
<tr>
1024
<td><p><span class="term"><em class="parameter"><code>arg_Error</code></em> :</span></p></td>
1025
<td><tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The name of a D-Bus error describing the error that occurred.</p> <p>The following errors can be used:</p> <ul> <li><code>org.freedesktop.Telepathy.Error.Cancelled</code>: user closed the socket or the tube.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionLost</code>: the bytestream relaying connection's data has been broken.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionRefused</code>: the tube offer refused the connection.</li> </ul></td>
1026
</tr>
1027
<tr>
1028
<td><p><span class="term"><em class="parameter"><code>arg_Message</code></em> :</span></p></td>
1029
<td>A debug message.</td>
1030
</tr>
1031
<tr>
1032
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1033
<td>User-supplied data</td>
1034
</tr>
1035
<tr>
1036
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1037
<td>User-supplied weakly referenced object</td>
1038
</tr>
1039
</tbody>
1040
</table></div>
1041
</div>
1042
<hr>
1043
<div class="refsect2">
1044
<a name="tp-cli-channel-type-dbus-tube-run-offer"></a><h3>tp_cli_channel_type_dbus_tube_run_offer ()</h3>
1045
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_channel_type_dbus_tube_run_offer
1046
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1047
<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>,
1048
<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_parameters</code></em>,
1049
<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_access_control</code></em>,
1050
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
1051
<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>,
1052
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
1053
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1054
<h3 class="title">Warning</h3>
1055
<p><code class="literal">tp_cli_channel_type_dbus_tube_run_offer</code> is deprecated and should not be used in newly-written code.</p>
1056
</div>
1057
<p>
1058
Call the method Offer and run the main loop
1059
until it returns. Before calling this method, you must
1060
add a reference to any borrowed objects you need to keep,
1061
and generally ensure that everything is in a consistent
1062
state.
1063
</p>
1064
<p>
1065
Offers a D-Bus tube providing the service specified.
1066
</p>
1067
<div class="variablelist"><table border="0" class="variablelist">
1068
<colgroup>
1069
<col align="left" valign="top">
1070
<col>
1071
</colgroup>
1072
<tbody>
1073
<tr>
1074
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1075
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
1076
</tr>
1077
<tr>
1078
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1079
<td>Timeout in milliseconds, or -1 for default</td>
1080
</tr>
1081
<tr>
1082
<td><p><span class="term"><em class="parameter"><code>in_parameters</code></em> :</span></p></td>
1083
<td>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</td>
1084
</tr>
1085
<tr>
1086
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
1087
<td>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
1088
</tr>
1089
<tr>
1090
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
1091
<td>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</td>
1092
</tr>
1093
<tr>
1094
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1095
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1096
is returned</td>
1097
</tr>
1098
<tr>
1099
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1100
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
1101
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
1102
which can be used to cancel this call with
1103
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
1104
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1105
</td>
1106
</tr>
1107
<tr>
1108
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1109
<td>TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error</td>
1110
</tr>
1111
</tbody>
1112
</table></div>
1113
</div>
1114
<hr>
1115
<div class="refsect2">
1116
<a name="tp-cli-channel-type-dbus-tube-run-accept"></a><h3>tp_cli_channel_type_dbus_tube_run_accept ()</h3>
1117
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> tp_cli_channel_type_dbus_tube_run_accept
1118
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1119
<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>,
1120
<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_access_control</code></em>,
1121
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **out_address</code></em>,
1122
<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>,
1123
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> **loop</code></em>);</pre>
1124
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1125
<h3 class="title">Warning</h3>
1126
<p><code class="literal">tp_cli_channel_type_dbus_tube_run_accept</code> is deprecated and should not be used in newly-written code.</p>
1127
</div>
1128
<p>
1129
Call the method Accept and run the main loop
1130
until it returns. Before calling this method, you must
1131
add a reference to any borrowed objects you need to keep,
1132
and generally ensure that everything is in a consistent
1133
state.
1134
</p>
1135
<p>
1136
Accept a D-Bus tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
1137
</p>
1138
<div class="variablelist"><table border="0" class="variablelist">
1139
<colgroup>
1140
<col align="left" valign="top">
1141
<col>
1142
</colgroup>
1143
<tbody>
1144
<tr>
1145
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1146
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
1147
</tr>
1148
<tr>
1149
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1150
<td>Timeout in milliseconds, or -1 for default</td>
1151
</tr>
1152
<tr>
1153
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
1154
<td>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
1155
</tr>
1156
<tr>
1157
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
1158
<td>Used to return an 'out' argument if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned: The string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</td>
1159
</tr>
1160
<tr>
1161
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1162
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to return errors if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1163
is returned</td>
1164
</tr>
1165
<tr>
1166
<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1167
<td>If not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, set before re-entering
1168
the main loop, to point to a <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a>
1169
which can be used to cancel this call with
1170
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-loop-quit"><code class="function">g_main_loop_quit()</code></a>, causing a return of
1171
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> with <em class="parameter"><code>error</code></em> set to <a class="link" href="telepathy-glib-proxy.html#TP-DBUS-ERROR-CANCELLED:CAPS"><code class="literal">TP_DBUS_ERROR_CANCELLED</code></a>
1172
</td>
1173
</tr>
1174
<tr>
1175
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1176
<td>TRUE on success, FALSE and sets <em class="parameter"><code>error</code></em> on error</td>
1177
</tr>
1178
</tbody>
1179
</table></div>
1180
</div>
1181
<hr>
1182
<div class="refsect2">
1183
<a name="tp-cli-channel-type-dbus-tube-call-offer"></a><h3>tp_cli_channel_type_dbus_tube_call_offer ()</h3>
1184
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_channel_type_dbus_tube_call_offer
1185
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1186
<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>,
1187
<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_parameters</code></em>,
1188
<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_access_control</code></em>,
1189
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-offer" title="tp_cli_channel_type_dbus_tube_callback_for_offer ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_offer</span></a> callback</code></em>,
1190
<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>,
1191
<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>,
1192
<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>
1193
<p>
1194
Start a Offer method call.
1195
</p>
1196
<p>
1197
Offers a D-Bus tube providing the service specified.
1198
</p>
1199
<div class="variablelist"><table border="0" class="variablelist">
1200
<colgroup>
1201
<col align="left" valign="top">
1202
<col>
1203
</colgroup>
1204
<tbody>
1205
<tr>
1206
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1207
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1208
</td>
1209
</tr>
1210
<tr>
1211
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1212
<td>the timeout in milliseconds, or -1 to use the
1213
default</td>
1214
</tr>
1215
<tr>
1216
<td><p><span class="term"><em class="parameter"><code>in_parameters</code></em> :</span></p></td>
1217
<td>Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer.</td>
1218
</tr>
1219
<tr>
1220
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
1221
<td>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
1222
</tr>
1223
<tr>
1224
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1225
<td>called when the method call succeeds or fails;
1226
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
1227
reply tracking</td>
1228
</tr>
1229
<tr>
1230
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1231
<td>user-supplied data passed to the callback;
1232
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>
1233
</td>
1234
</tr>
1235
<tr>
1236
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1237
<td>called with the user_data as argument, after the
1238
call has succeeded, failed or been cancelled;
1239
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>
1240
</td>
1241
</tr>
1242
<tr>
1243
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1244
<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
1245
weakly referenced; if it is destroyed, this call
1246
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
1247
<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>
1248
</td>
1249
</tr>
1250
<tr>
1251
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1252
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1253
progress. It is borrowed from the object, and will become
1254
invalid when the callback is called, the call is
1255
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
1256
</tr>
1257
</tbody>
1258
</table></div>
1259
</div>
1260
<hr>
1261
<div class="refsect2">
1262
<a name="tp-cli-channel-type-dbus-tube-call-accept"></a><h3>tp_cli_channel_type_dbus_tube_call_accept ()</h3>
1263
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_channel_type_dbus_tube_call_accept
1264
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1265
<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>,
1266
<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_access_control</code></em>,
1267
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-callback-for-accept" title="tp_cli_channel_type_dbus_tube_callback_for_accept ()"><span class="type">tp_cli_channel_type_dbus_tube_callback_for_accept</span></a> callback</code></em>,
1268
<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>,
1269
<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>,
1270
<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>
1271
<p>
1272
Start a Accept method call.
1273
</p>
1274
<p>
1275
Accept a D-Bus tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
1276
</p>
1277
<div class="variablelist"><table border="0" class="variablelist">
1278
<colgroup>
1279
<col align="left" valign="top">
1280
<col>
1281
</colgroup>
1282
<tbody>
1283
<tr>
1284
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1285
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
1286
</td>
1287
</tr>
1288
<tr>
1289
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
1290
<td>the timeout in milliseconds, or -1 to use the
1291
default</td>
1292
</tr>
1293
<tr>
1294
<td><p><span class="term"><em class="parameter"><code>in_access_control</code></em> :</span></p></td>
1295
<td>Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (<a class="link" href="telepathy-glib-enums.html#TpSocketAccessControl" title="enum TpSocketAccessControl"><span class="type">TpSocketAccessControl</span></a>)</td>
1296
</tr>
1297
<tr>
1298
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1299
<td>called when the method call succeeds or fails;
1300
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
1301
reply tracking</td>
1302
</tr>
1303
<tr>
1304
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1305
<td>user-supplied data passed to the callback;
1306
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>
1307
</td>
1308
</tr>
1309
<tr>
1310
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1311
<td>called with the user_data as argument, after the
1312
call has succeeded, failed or been cancelled;
1313
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>
1314
</td>
1315
</tr>
1316
<tr>
1317
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1318
<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
1319
weakly referenced; if it is destroyed, this call
1320
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
1321
<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>
1322
</td>
1323
</tr>
1324
<tr>
1325
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1326
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
1327
progress. It is borrowed from the object, and will become
1328
invalid when the callback is called, the call is
1329
cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</td>
1330
</tr>
1331
</tbody>
1332
</table></div>
1333
</div>
1334
<hr>
1335
<div class="refsect2">
1336
<a name="tp-cli-channel-type-dbus-tube-callback-for-offer"></a><h3>tp_cli_channel_type_dbus_tube_callback_for_offer ()</h3>
1337
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_dbus_tube_callback_for_offer)
1338
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1339
<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_address</code></em>,
1340
<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>,
1341
<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>,
1342
<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>
1343
<p>
1344
Signature of the callback called when a Offer method call
1345
succeeds or fails.
1346
</p>
1347
<div class="variablelist"><table border="0" class="variablelist">
1348
<colgroup>
1349
<col align="left" valign="top">
1350
<col>
1351
</colgroup>
1352
<tbody>
1353
<tr>
1354
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1355
<td>the proxy on which the call was made</td>
1356
</tr>
1357
<tr>
1358
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
1359
<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 string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</td>
1360
</tr>
1361
<tr>
1362
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1363
<td>
1364
<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>
1365
</tr>
1366
<tr>
1367
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1368
<td>user-supplied data</td>
1369
</tr>
1370
<tr>
1371
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1372
<td>user-supplied object</td>
1373
</tr>
1374
</tbody>
1375
</table></div>
1376
</div>
1377
<hr>
1378
<div class="refsect2">
1379
<a name="tp-cli-channel-type-dbus-tube-callback-for-accept"></a><h3>tp_cli_channel_type_dbus_tube_callback_for_accept ()</h3>
1380
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_dbus_tube_callback_for_accept)
1381
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1382
<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_address</code></em>,
1383
<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>,
1384
<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>,
1385
<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>
1386
<p>
1387
Signature of the callback called when a Accept method call
1388
succeeds or fails.
1389
</p>
1390
<div class="variablelist"><table border="0" class="variablelist">
1391
<colgroup>
1392
<col align="left" valign="top">
1393
<col>
1394
</colgroup>
1395
<tbody>
1396
<tr>
1397
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1398
<td>the proxy on which the call was made</td>
1399
</tr>
1400
<tr>
1401
<td><p><span class="term"><em class="parameter"><code>out_address</code></em> :</span></p></td>
1402
<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 string describing the address of the private bus. The client SHOULD NOT attempt to connect to the address until the tube is open.</td>
1403
</tr>
1404
<tr>
1405
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1406
<td>
1407
<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>
1408
</tr>
1409
<tr>
1410
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1411
<td>user-supplied data</td>
1412
</tr>
1413
<tr>
1414
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1415
<td>user-supplied object</td>
1416
</tr>
1417
</tbody>
1418
</table></div>
1419
</div>
1420
<hr>
1421
<div class="refsect2">
1422
<a name="tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed"></a><h3>tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()</h3>
1423
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed
1424
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1425
<em class="parameter"><code><a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()"><span class="type">tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed</span></a> callback</code></em>,
1426
<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>,
1427
<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>,
1428
<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>,
1429
<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>
1430
<p>
1431
Connect a handler to the signal DBusNamesChanged.
1432
</p>
1433
<p>
1434
Emitted on a multi-user (i.e. Handle_Type_Room) D-Bus tube when a participant opens or closes the tube. This provides change notification for the <tp:member-ref>DBusNames</tp:member-ref> property.
1435
</p>
1436
<div class="variablelist"><table border="0" class="variablelist">
1437
<colgroup>
1438
<col align="left" valign="top">
1439
<col>
1440
</colgroup>
1441
<tbody>
1442
<tr>
1443
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1444
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass</td>
1445
</tr>
1446
<tr>
1447
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1448
<td>Callback to be called when the signal is
1449
received</td>
1450
</tr>
1451
<tr>
1452
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1453
<td>User-supplied data for the callback</td>
1454
</tr>
1455
<tr>
1456
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1457
<td>Destructor for the user-supplied data, which
1458
will be called when this signal is disconnected, or
1459
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>
1460
</td>
1461
</tr>
1462
<tr>
1463
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1464
<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;
1465
if it is destroyed, this callback will automatically be
1466
disconnected</td>
1467
</tr>
1468
<tr>
1469
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1470
<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
1471
returned</td>
1472
</tr>
1473
<tr>
1474
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1475
<td>a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
1476
above, which can be used to disconnect the signal; or
1477
<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
1478
or has become invalid.</td>
1479
</tr>
1480
</tbody>
1481
</table></div>
1482
</div>
1483
<hr>
1484
<div class="refsect2">
1485
<a name="tp-cli-channel-type-dbus-tube-signal-callback-dbus-names-changed"></a><h3>tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed ()</h3>
1486
<pre class="programlisting"><span class="returnvalue">void</span> (*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed)
1487
(<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
1488
<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_Added</code></em>,
1489
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> *arg_Removed</code></em>,
1490
<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>,
1491
<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>
1492
<p>
1493
Represents the signature of a callback for the signal DBusNamesChanged.
1494
</p>
1495
<div class="variablelist"><table border="0" class="variablelist">
1496
<colgroup>
1497
<col align="left" valign="top">
1498
<col>
1499
</colgroup>
1500
<tbody>
1501
<tr>
1502
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
1503
<td>The proxy on which <a class="link" href="telepathy-glib-channel-tube.html#tp-cli-channel-type-dbus-tube-connect-to-dbus-names-changed" title="tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed ()"><code class="function">tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed()</code></a>
1504
was called</td>
1505
</tr>
1506
<tr>
1507
<td><p><span class="term"><em class="parameter"><code>arg_Added</code></em> :</span></p></td>
1508
<td>Array of handles and D-Bus names of new participants.</td>
1509
</tr>
1510
<tr>
1511
<td><p><span class="term"><em class="parameter"><code>arg_Removed</code></em> :</span></p></td>
1512
<td>Array of handles of former participants.</td>
1513
</tr>
1514
<tr>
1515
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1516
<td>User-supplied data</td>
1517
</tr>
1518
<tr>
1519
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
1520
<td>User-supplied weakly referenced object</td>
1521
</tr>
1522
</tbody>
1523
</table></div>
1524
</div>
1730
1525
</div>
1731
1526
<div class="refsect1">
1732
1527
<a name="telepathy-glib-channel-tube.see-also"></a><h2>See Also</h2>
1733
<p>channel-group</p>
1528
channel-group
1734
1529
</div>
1735
1530
</div>
1736
1531
<div class="footer">
1737
1532
<hr>
1738
Generated by GTK-Doc V1.20</div>
1533
Generated by GTK-Doc V1.19</div>
1739
1534
</body>
1740
1535
</html>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1