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

<title>telepathy-glib API Reference Manual: TpChannelDispatchOperation</title>

<meta name="generator" content="GTK-Doc V1.20 (XML mode)">

<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">

<td width="100%" align="left" class="shortcuts">

<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 

                  <a href="#telepathy-glib-channel-dispatch-operation.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 

                  <a href="#telepathy-glib-channel-dispatch-operation.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> 

                  <a href="#telepathy-glib-channel-dispatch-operation.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span> 

                  <a href="#telepathy-glib-channel-dispatch-operation.signals" class="shortcut">Signals</a></span>

</td>

<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>

<td><a accesskey="u" href="ch-client.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>

<td><a accesskey="p" href="telepathy-glib-channel-dispatcher.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>

<td><a accesskey="n" href="telepathy-glib-channel-request.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>

</tr></table>

<td class="gallery_image" valign="top" align="right"></td>

<a name="telepathy-glib-channel-dispatch-operation.functions"></a><h2>Functions</h2>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="functions_return">

<col class="functions_name">

</colgroup>

<tbody>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="returnvalue">TpChannelDispatchOperation</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-new" title="tp_channel_dispatch_operation_new ()">tp_channel_dispatch_operation_new</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-init-known-interfaces" title="tp_channel_dispatch_operation_init_known_interfaces ()">tp_channel_dispatch_operation_init_known_interfaces</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim" title="tp_cli_channel_dispatch_operation_callback_for_claim ()">*tp_cli_channel_dispatch_operation_callback_for_claim</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-claim" title="tp_cli_channel_dispatch_operation_call_claim ()">tp_cli_channel_dispatch_operation_call_claim</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()">*tp_cli_channel_dispatch_operation_callback_for_handle_with</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with" title="tp_cli_channel_dispatch_operation_call_handle_with ()">tp_cli_channel_dispatch_operation_call_handle_with</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with-time" title="tp_cli_channel_dispatch_operation_callback_for_handle_with_time ()">*tp_cli_channel_dispatch_operation_callback_for_handle_with_time</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-call-handle-with-time" title="tp_cli_channel_dispatch_operation_call_handle_with_time ()">tp_cli_channel_dispatch_operation_call_handle_with_time</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()">*tp_cli_channel_dispatch_operation_signal_callback_channel_lost</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()">tp_cli_channel_dispatch_operation_connect_to_channel_lost</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<span class="c_punctuation">(</span><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()">*tp_cli_channel_dispatch_operation_signal_callback_finished</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished" title="tp_cli_channel_dispatch_operation_connect_to_finished ()">tp_cli_channel_dispatch_operation_connect_to_finished</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-borrow-account" title="tp_channel_dispatch_operation_borrow_account ()">tp_channel_dispatch_operation_borrow_account</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-borrow-channels" title="tp_channel_dispatch_operation_borrow_channels ()">tp_channel_dispatch_operation_borrow_channels</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-borrow-connection" title="tp_channel_dispatch_operation_borrow_connection ()">tp_channel_dispatch_operation_borrow_connection</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-borrow-immutable-properties" title="tp_channel_dispatch_operation_borrow_immutable_properties ()">tp_channel_dispatch_operation_borrow_immutable_properties</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="returnvalue">GStrv</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-borrow-possible-handlers" title="tp_channel_dispatch_operation_borrow_possible_handlers ()">tp_channel_dispatch_operation_borrow_possible_handlers</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-account" title="tp_channel_dispatch_operation_get_account ()">tp_channel_dispatch_operation_get_account</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-channels" title="tp_channel_dispatch_operation_get_channels ()">tp_channel_dispatch_operation_get_channels</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-connection" title="tp_channel_dispatch_operation_get_connection ()">tp_channel_dispatch_operation_get_connection</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="returnvalue">GStrv</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-possible-handlers" title="tp_channel_dispatch_operation_get_possible_handlers ()">tp_channel_dispatch_operation_get_possible_handlers</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-async" title="tp_channel_dispatch_operation_handle_with_async ()">tp_channel_dispatch_operation_handle_with_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-finish" title="tp_channel_dispatch_operation_handle_with_finish ()">tp_channel_dispatch_operation_handle_with_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-time-async" title="tp_channel_dispatch_operation_handle_with_time_async ()">tp_channel_dispatch_operation_handle_with_time_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-handle-with-time-finish" title="tp_channel_dispatch_operation_handle_with_time_finish ()">tp_channel_dispatch_operation_handle_with_time_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-claim-async" title="tp_channel_dispatch_operation_claim_async ()">tp_channel_dispatch_operation_claim_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-claim-finish" title="tp_channel_dispatch_operation_claim_finish ()">tp_channel_dispatch_operation_claim_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-claim-with-async" title="tp_channel_dispatch_operation_claim_with_async ()">tp_channel_dispatch_operation_claim_with_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-claim-with-finish" title="tp_channel_dispatch_operation_claim_with_finish ()">tp_channel_dispatch_operation_claim_with_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-close-channels-async" title="tp_channel_dispatch_operation_close_channels_async ()">tp_channel_dispatch_operation_close_channels_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-close-channels-finish" title="tp_channel_dispatch_operation_close_channels_finish ()">tp_channel_dispatch_operation_close_channels_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-leave-channels-async" title="tp_channel_dispatch_operation_leave_channels_async ()">tp_channel_dispatch_operation_leave_channels_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-leave-channels-finish" title="tp_channel_dispatch_operation_leave_channels_finish ()">tp_channel_dispatch_operation_leave_channels_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<span class="returnvalue">void</span>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-destroy-channels-async" title="tp_channel_dispatch_operation_destroy_channels_async ()">tp_channel_dispatch_operation_destroy_channels_async</a> <span class="c_punctuation">()</span>

</td>

</tr>

<tr>

<td class="function_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>

</td>

<td class="function_name">

<a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-destroy-channels-finish" title="tp_channel_dispatch_operation_destroy_channels_finish ()">tp_channel_dispatch_operation_destroy_channels_finish</a> <span class="c_punctuation">()</span>

</td>

</tr>

</tbody>

</table></div>

<div class="informaltable"><table border="0">

<colgroup>

<col width="150px" class="properties_type">

<col width="300px" class="properties_name">

<col width="200px" class="properties_flags">

</colgroup>

<tbody>

<tr>

<td class="property_type">

<a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *</td>

<td class="property_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--account" title="The “account” property">account</a></td>

<td class="property_flags">Read / Write / Construct Only</td>

</tr>

<tr>

<td class="property_type"><span class="type">GHashTable_gchararray+GValue_*</span></td>

<td class="property_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--cdo-properties" title="The “cdo-properties” property">cdo-properties</a></td>

<td class="property_flags">Read / Write / Construct Only</td>

</tr>

<tr>

<td class="property_type">

<a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *</td>

<td class="property_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--channels" title="The “channels” property">channels</a></td>

<td class="property_flags">Read / Write / Construct Only</td>

</tr>

<tr>

<td class="property_type">

<a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> *</td>

<td class="property_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--connection" title="The “connection” property">connection</a></td>

<td class="property_flags">Read / Write / Construct Only</td>

</tr>

<tr>

<td class="property_type"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a></td>

<td class="property_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--possible-handlers" title="The “possible-handlers” property">possible-handlers</a></td>

<td class="property_flags">Read</td>

</tr>

</tbody>

</table></div>

<div class="informaltable"><table border="0">

<colgroup>

<col width="150px" class="signals_return">

<col width="300px" class="signals_name">

<col width="200px" class="signals_flags">

</colgroup>

<tbody><tr>

<td class="signal_type"><span class="returnvalue">void</span></td>

<td class="signal_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-channel-lost" title="The “channel-lost” signal">channel-lost</a></td>

<td class="signal_flags">Has Details</td>

</tr></tbody>

</table></div>

</div>

<a name="TpChannelDispatchOperation"></a><div class="refsect1">

<a name="telepathy-glib-channel-dispatch-operation.other"></a><h2>Types and Values</h2>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="name">

<col class="description">

</colgroup>

<tbody>

<tr>

<td class="datatype_keyword">struct</td>

<td class="function_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation-struct" title="struct TpChannelDispatchOperation">TpChannelDispatchOperation</a></td>

</tr>

<tr>

<td class="datatype_keyword">struct</td>

<td class="function_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperationClass" title="struct TpChannelDispatchOperationClass">TpChannelDispatchOperationClass</a></td>

</tr>

<tr>

<td class="define_keyword">#define</td>

<td class="function_name"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TP-CHANNEL-DISPATCH-OPERATION-FEATURE-CORE:CAPS" title="TP_CHANNEL_DISPATCH_OPERATION_FEATURE_CORE">TP_CHANNEL_DISPATCH_OPERATION_FEATURE_CORE</a></td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect1">

<a name="telepathy-glib-channel-dispatch-operation.object-hierarchy"></a><h2>Object Hierarchy</h2>

<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

    <span class="lineart">╰──</span> <a class="link" href="telepathy-glib-proxy.html#TpProxy">TpProxy</a>

        <span class="lineart">╰──</span> TpChannelDispatchOperation

</pre>

</div>

<div class="refsect1">

<a name="telepathy-glib-channel-dispatch-operation.includes"></a><h2>Includes</h2>

<pre class="synopsis">#include &lt;telepathy-glib/telepathy-glib.h&gt;

<p>One of the channel dispatcher's functions is to offer incoming channels to

via a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> object.</p>

</div>

<div class="refsect1">

<a name="telepathy-glib-channel-dispatch-operation.functions_details"></a><h2>Functions</h2>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-new"></a><h3>tp_channel_dispatch_operation_new ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="returnvalue">TpChannelDispatchOperation</span></a> *

tp_channel_dispatch_operation_new (<em class="parameter"><code><a class="link" href="telepathy-glib-dbus.html#TpDBusDaemon"><span class="type">TpDBusDaemon</span></a> *bus_daemon</code></em>,

                                   <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,

                                   <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> *immutable_properties</code></em>,

                                   <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>

<div class="warning">

<p><code class="literal">tp_channel_dispatch_operation_new</code> is deprecated and should not be used in newly-written code.</p>

<p>Since 0.19.9. New code should get

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> objects from a <a class="link" href="telepathy-glib-base-client.html#TpBaseClient"><span class="type">TpBaseClient</span></a></p>

</div>

<p>Convenience function to create a new channel dispatch operation proxy.</p>

<p>The <em class="parameter"><code>immutable_properties</code></em>

 argument is not yet used.</p>

<div class="refsect3">

<a name="id-1.4.49.11.2.7"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>bus_daemon</p></td>

<td class="parameter_description"><p>Proxy for the D-Bus daemon</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>object_path</p></td>

<td class="parameter_description"><p>The non-NULL object path of this channel dispatch operation</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>immutable_properties</p></td>

<td class="parameter_description"><p>As many as are known of the immutable D-Bus

properties of this channel dispatch operation, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none are known</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<td class="parameter_description"><p>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 returned</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.2.8"></a><h4>Returns</h4>

<p> a new reference to an channel dispatch operation proxy, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

<em class="parameter"><code>object_path</code></em>

is not syntactically valid or the channel dispatcher is not

running</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-init-known-interfaces"></a><h3>tp_channel_dispatch_operation_init_known_interfaces ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

tp_channel_dispatch_operation_init_known_interfaces

                               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>

<p>Ensure that the known interfaces for TpChannelDispatchOperation have been

set up. This is done automatically when necessary, but for correct

overriding of library interfaces by local extensions, you should

call this function before calling

<a class="link" href="telepathy-glib-proxy-subclass.html#tp-proxy-or-subclass-hook-on-interface-add" title="tp_proxy_or_subclass_hook_on_interface_add ()"><code class="function">tp_proxy_or_subclass_hook_on_interface_add()</code></a> with first argument

<code class="literal">TP_TYPE_CHANNEL_DISPATCH_OPERATION</code>.</p>

<p class="since">Since 0.7.32</p>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-callback-for-claim"></a><h3>tp_cli_channel_dispatch_operation_callback_for_claim ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*tp_cli_channel_dispatch_operation_callback_for_claim<span class="c_punctuation">)</span>

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Signature of the callback called when a Claim method call

succeeds or fails.</p>

<div class="refsect3">

<a name="id-1.4.49.11.4.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the proxy on which the call was made</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<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>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<td class="parameter_description"><p>user-supplied object</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-call-claim"></a><h3>tp_cli_channel_dispatch_operation_call_claim ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

tp_cli_channel_dispatch_operation_call_claim

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-claim" title="tp_cli_channel_dispatch_operation_callback_for_claim ()"><span class="type">tp_cli_channel_dispatch_operation_callback_for_claim</span></a> callback</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Start a Claim method call.</p>

<p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Called by an approver to claim channels for handling           internally. If this method is called successfully, the process           calling this method becomes the handler for the channel, but           &lt;em&gt;does not&lt;/em&gt; have the &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt;           method called on it.&lt;/p&gt;          &lt;p&gt;Clients that call Claim on channels but do not immediately           close them SHOULD implement the Handler interface and its           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandledChannels&lt;/tp:dbus-ref&gt;           property.&lt;/p&gt;          &lt;p&gt;Approvers wishing to reject channels MUST call this method to           claim ownership of them, and MUST NOT call           &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"&gt;Close&lt;/tp:dbus-ref&gt;           on the channels unless/until this method returns successfully.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;The channel dispatcher can't know how best to close arbitrary             channel types, so it leaves it up to the approver to do so.             For instance, for Text channels it is necessary             to acknowledge any messages that have already been displayed to             the user first - ideally, the approver would display and then             acknowledge the messages - or to call &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel.Interface.Destroyable.Destroy&lt;/tp:dbus-ref&gt;             if the destructive behaviour of that method is desired.&lt;/p&gt;            &lt;p&gt;Similarly, an Approver for StreamedMedia channels can close the             channel with a reason (e.g. &amp;quot;busy&amp;quot;) if desired. The channel             dispatcher, which is designed to have no specific knowledge             of particular channel types, can't do that.&lt;/p&gt;         &lt;/tp:rationale&gt;          &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation           object to disappear, emitting           &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;, in the same way as for           &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt;.&lt;/p&gt;          &lt;p&gt;This method may fail because the dispatch operation has already           been completed. Again, see HandleWith for more details. The approver           MUST NOT attempt to interact with the channels further in this           case.&lt;/p&gt;          &lt;p&gt;(FIXME: list some other possible errors)&lt;/p&gt;</p>

<div class="refsect3">

<a name="id-1.4.49.11.5.6"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>timeout_ms</p></td>

<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the

default</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>callback</p></td>

<td class="parameter_description"><p>called when the method call succeeds or fails;

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

reply tracking</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data passed to the callback;

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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>destroy</p></td>

<td class="parameter_description"><p>called with the user_data as argument, after the

call has succeeded, failed or been 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 <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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<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

weakly referenced; if it is destroyed, this call

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

<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></p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.5.7"></a><h4>Returns</h4>

<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in

progress. It is borrowed from the object, and will become

invalid when the callback is called, the call is

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-callback-for-handle-with"></a><h3>tp_cli_channel_dispatch_operation_callback_for_handle_with ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*tp_cli_channel_dispatch_operation_callback_for_handle_with<span class="c_punctuation">)</span>

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Signature of the callback called when a HandleWith method call

succeeds or fails.</p>

<div class="refsect3">

<a name="id-1.4.49.11.6.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the proxy on which the call was made</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<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>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<td class="parameter_description"><p>user-supplied object</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-call-handle-with"></a><h3>tp_cli_channel_dispatch_operation_call_handle_with ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

tp_cli_channel_dispatch_operation_call_handle_with

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Handler</code></em>,

                                <em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with" title="tp_cli_channel_dispatch_operation_callback_for_handle_with ()"><span class="type">tp_cli_channel_dispatch_operation_callback_for_handle_with</span></a> callback</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Start a HandleWith method call.</p>

<p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Called by an approver to accept a channel bundle and request that           the given handler be used to handle it.&lt;/p&gt;          &lt;p&gt;If successful, this method will cause the ChannelDispatchOperation           object to disappear, emitting           &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt;          &lt;p&gt;However, this method may fail because the dispatch has already been           completed and the object has already gone. If this occurs, it           indicates that another approver has asked for the bundle to be           handled by a particular handler. The approver MUST NOT attempt           to interact with the channels further in this case, unless it is           separately invoked as the handler.&lt;/p&gt;          &lt;p&gt;Approvers which are also channel handlers SHOULD use           &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; instead           of HandleWith to request that they can handle a channel bundle           themselves.&lt;/p&gt;          &lt;p&gt;(FIXME: list some possible errors)&lt;/p&gt;          &lt;p&gt;If the channel handler raises an error from &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt;,           this method           MAY respond by raising that same error, even if it is not           specifically documented here.&lt;/p&gt;</p>

<div class="refsect3">

<a name="id-1.4.49.11.7.6"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>timeout_ms</p></td>

<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the

default</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>in_Handler</p></td>

<td class="parameter_description"><p>Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;The well-known bus name (starting with             &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the channel             handler that should handle the channel, or the empty string             if the client has no preferred channel handler.&lt;/p&gt;</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>callback</p></td>

<td class="parameter_description"><p>called when the method call succeeds or fails;

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

reply tracking</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data passed to the callback;

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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>destroy</p></td>

<td class="parameter_description"><p>called with the user_data as argument, after the

call has succeeded, failed or been 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 <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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<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

weakly referenced; if it is destroyed, this call

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

<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></p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.7.7"></a><h4>Returns</h4>

<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in

progress. It is borrowed from the object, and will become

invalid when the callback is called, the call is

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-callback-for-handle-with-time"></a><h3>tp_cli_channel_dispatch_operation_callback_for_handle_with_time ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*tp_cli_channel_dispatch_operation_callback_for_handle_with_time<span class="c_punctuation">)</span>

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Signature of the callback called when a HandleWithTime method call

succeeds or fails.</p>

<div class="refsect3">

<a name="id-1.4.49.11.8.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the proxy on which the call was made</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<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>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<td class="parameter_description"><p>user-supplied object</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-call-handle-with-time"></a><h3>tp_cli_channel_dispatch_operation_call_handle_with_time ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> *

tp_cli_channel_dispatch_operation_call_handle_with_time

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Handler</code></em>,

                                <em class="parameter"><code><span class="type">gint64</span> in_UserActionTime</code></em>,

                                <em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-callback-for-handle-with-time" title="tp_cli_channel_dispatch_operation_callback_for_handle_with_time ()"><span class="type">tp_cli_channel_dispatch_operation_callback_for_handle_with_time</span></a> callback</code></em>,

                                <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>,

                                <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>,

                                <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>

<p>Start a HandleWithTime method call.</p>

<p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;A variant of &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt; allowing the           approver to pass an user action time. This timestamp will be passed           to the Handler when &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler"&gt;HandleChannels&lt;/tp:dbus-ref&gt;           is called.&lt;/p&gt;</p>

<div class="refsect3">

<a name="id-1.4.49.11.9.6"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>timeout_ms</p></td>

<td class="parameter_description"><p>the timeout in milliseconds, or -1 to use the

default</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>in_Handler</p></td>

<td class="parameter_description"><p>Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;The well-known bus name (starting with             &lt;code&gt;org.freedesktop.Telepathy.Client.&lt;/code&gt;) of the channel             handler that should handle the channel, or the empty string             if the client has no preferred channel handler.&lt;/p&gt;</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>in_UserActionTime</p></td>

<td class="parameter_description"><p>Used to pass an 'in' argument: &lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;            &lt;p&gt;The time at which user action occurred.&lt;/p&gt;</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>callback</p></td>

<td class="parameter_description"><p>called when the method call succeeds or fails;

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

reply tracking</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>user-supplied data passed to the callback;

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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>destroy</p></td>

<td class="parameter_description"><p>called with the user_data as argument, after the

call has succeeded, failed or been 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 <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></p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<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

weakly referenced; if it is destroyed, this call

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

<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></p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.9.7"></a><h4>Returns</h4>

<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in

progress. It is borrowed from the object, and will become

invalid when the callback is called, the call is

cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-signal-callback-channel-lost"></a><h3>tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*tp_cli_channel_dispatch_operation_signal_callback_channel_lost<span class="c_punctuation">)</span>

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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_Channel</code></em>,

                                <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>,

                                <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>,

                                <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>,

                                <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>

<p>Represents the signature of a callback for the signal ChannelLost.</p>

<div class="refsect3">

<a name="id-1.4.49.11.10.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-channel-lost" title="tp_cli_channel_dispatch_operation_connect_to_channel_lost ()"><code class="function">tp_cli_channel_dispatch_operation_connect_to_channel_lost()</code></a>

was called</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>arg_Channel</p></td>

<td class="parameter_description"><p>The &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy"&gt;Channel&lt;/tp:dbus-ref&gt;           that closed.</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>arg_Error</p></td>

<td class="parameter_description"><p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;           &lt;p&gt;The name of a D-Bus error indicating why the channel closed. If             no better reason can be found,             &lt;code&gt;org.freedesktop.Telepathy.Error.NotAvailable&lt;/code&gt; MAY             be used as a fallback; this means that this error SHOULD NOT be             given any more specific meaning.&lt;/p&gt;</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>arg_Message</p></td>

<td class="parameter_description"><p>A string associated with the D-Bus error.</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>User-supplied data</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-connect-to-channel-lost"></a><h3>tp_cli_channel_dispatch_operation_connect_to_channel_lost ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *

tp_cli_channel_dispatch_operation_connect_to_channel_lost

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-channel-lost" title="tp_cli_channel_dispatch_operation_signal_callback_channel_lost ()"><span class="type">tp_cli_channel_dispatch_operation_signal_callback_channel_lost</span></a> callback</code></em>,

                                <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>,

                                <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>,

                                <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>,

                                <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>

<p>Connect a handler to the signal ChannelLost.</p>

<p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;A channel has closed before it could be claimed or handled. If           this is emitted for the last remaining channel in a channel           dispatch operation, it MUST immediately be followed by           &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;.&lt;/p&gt;          &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were           invoked have returned (successfully or with an error) from           their &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Approver"&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt;           method.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;This means that Approvers can connect to the ChannelLost signal             in a race-free way. Non-approver processes that discover             a channel dispatch operation in some way (such as observers)             will have to follow the usual &amp;quot;connect to signals then recover             state&amp;quot; model - first connect to ChannelLost and             &lt;tp:member-ref&gt;Finished&lt;/tp:member-ref&gt;,             then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt; (and             on error, perhaps assume that the operation has already             Finished).&lt;/p&gt;         &lt;/tp:rationale&gt;</p>

<div class="refsect3">

<a name="id-1.4.49.11.11.6"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> or subclass</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>callback</p></td>

<td class="parameter_description"><p>Callback to be called when the signal is

received</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>User-supplied data for the callback</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>destroy</p></td>

<td class="parameter_description"><p>Destructor for the user-supplied data, which

will be called when this signal is disconnected, or

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>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<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;

if it is destroyed, this callback will automatically be

disconnected</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<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

returned</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.11.7"></a><h4>Returns</h4>

<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the

above, which can be used to disconnect the signal; or

<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

or has become invalid.</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-signal-callback-finished"></a><h3>tp_cli_channel_dispatch_operation_signal_callback_finished ()</h3>

<pre class="programlisting"><span class="returnvalue">void</span>

<span class="c_punctuation">(</span>*tp_cli_channel_dispatch_operation_signal_callback_finished<span class="c_punctuation">)</span>

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <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>,

                                <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>

<p>Represents the signature of a callback for the signal Finished.</p>

<div class="refsect3">

<a name="id-1.4.49.11.12.5"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>The proxy on which <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-connect-to-finished" title="tp_cli_channel_dispatch_operation_connect_to_finished ()"><code class="function">tp_cli_channel_dispatch_operation_connect_to_finished()</code></a>

was called</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>User-supplied data</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<td class="parameter_description"><p>User-supplied weakly referenced object</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-cli-channel-dispatch-operation-connect-to-finished"></a><h3>tp_cli_channel_dispatch_operation_connect_to_finished ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> *

tp_cli_channel_dispatch_operation_connect_to_finished

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *proxy</code></em>,

                                <em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-cli-channel-dispatch-operation-signal-callback-finished" title="tp_cli_channel_dispatch_operation_signal_callback_finished ()"><span class="type">tp_cli_channel_dispatch_operation_signal_callback_finished</span></a> callback</code></em>,

                                <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>,

                                <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>,

                                <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>,

                                <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>

<p>Connect a handler to the signal Finished.</p>

<p>&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;Emitted when this dispatch operation finishes. The dispatch           operation is no longer present and further methods must not be           called on it.&lt;/p&gt;          &lt;p&gt;Approvers that have a user interface SHOULD stop notifying the user           about the channels in response to this signal; they MAY assume that           on errors, they would have received           &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; first.&lt;/p&gt;          &lt;p&gt;Its object path SHOULD NOT be reused for a subsequent dispatch           operation; the ChannelDispatcher MUST choose object paths           in a way that avoids immediate re-use.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;Otherwise, clients might accidentally call             &lt;tp:member-ref&gt;HandleWith&lt;/tp:member-ref&gt; or             &lt;tp:member-ref&gt;Claim&lt;/tp:member-ref&gt; on a new dispatch operation             instead of the one they intended to handle.&lt;/p&gt;         &lt;/tp:rationale&gt;          &lt;p&gt;This signal MUST NOT be emitted until all Approvers that were           invoked have returned (successfully or with an error) from           their &lt;tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Approver"&gt;AddDispatchOperation&lt;/tp:dbus-ref&gt;           method.&lt;/p&gt;          &lt;tp:rationale&gt;           &lt;p&gt;This means that Approvers can connect to the ChannelLost signal             in a race-free way. Non-approver processes that discover             a channel dispatch operation in some way (such as observers)             will have to follow the usual &amp;quot;connect to signals then recover             state&amp;quot; model - first connect to             &lt;tp:member-ref&gt;ChannelLost&lt;/tp:member-ref&gt; and             Finished, then download &lt;tp:member-ref&gt;Channels&lt;/tp:member-ref&gt;             (and on error, perhaps assume that the operation has already             Finished).&lt;/p&gt;         &lt;/tp:rationale&gt;</p>

<div class="refsect3">

<a name="id-1.4.49.11.13.6"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody>

<tr>

<td class="parameter_name"><p>proxy</p></td>

<td class="parameter_description"><p>A <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> or subclass</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>callback</p></td>

<td class="parameter_description"><p>Callback to be called when the signal is

received</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>user_data</p></td>

<td class="parameter_description"><p>User-supplied data for the callback</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>destroy</p></td>

<td class="parameter_description"><p>Destructor for the user-supplied data, which

will be called when this signal is disconnected, or

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>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>weak_object</p></td>

<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;

if it is destroyed, this callback will automatically be

disconnected</p></td>

<td class="parameter_annotations"> </td>

</tr>

<tr>

<td class="parameter_name"><p>error</p></td>

<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

returned</p></td>

<td class="parameter_annotations"> </td>

</tr>

</tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.13.7"></a><h4>Returns</h4>

<p> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the

above, which can be used to disconnect the signal; or

<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

or has become invalid.</p>

<p></p>

</div>

</div>

<hr>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-borrow-account"></a><h3>tp_channel_dispatch_operation_borrow_account ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-account.html#TpAccount"><span class="returnvalue">TpAccount</span></a> *

tp_channel_dispatch_operation_borrow_account

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>);</pre>

<div class="warning">

<p><code class="literal">tp_channel_dispatch_operation_borrow_account</code> is deprecated and should not be used in newly-written code.</p>

<p>Since 0.19.9. New code should use

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-account" title="tp_channel_dispatch_operation_get_account ()"><code class="function">tp_channel_dispatch_operation_get_account()</code></a> instead.</p>

</div>

<p>Returns the <a class="link" href="telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> of this ChannelDispatchOperation.

The returned pointer is only valid while <em class="parameter"><code>self</code></em>

 is valid - reference

it with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> if needed.</p>

<div class="refsect3">

<a name="id-1.4.49.11.14.7"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody><tr>

<td class="parameter_name"><p>self</p></td>

<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr></tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.14.8"></a><h4>Returns</h4>

<p> the value of <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--account" title="The “account” property"><span class="type">“account”</span></a>. </p>

<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

</div>

<p class="since">Since 0.11.5</p>

</div>

<hr>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-borrow-channels"></a><h3>tp_channel_dispatch_operation_borrow_channels ()</h3>

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *

tp_channel_dispatch_operation_borrow_channels

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>);</pre>

<div class="warning">

<p><code class="literal">tp_channel_dispatch_operation_borrow_channels</code> is deprecated and should not be used in newly-written code.</p>

<p>Since 0.19.9. New code should use

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-channels" title="tp_channel_dispatch_operation_get_channels ()"><code class="function">tp_channel_dispatch_operation_get_channels()</code></a> instead.</p>

</div>

<p>Returns a <a href="http://library.gnome.org/devel/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> containing the <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> of this

ChannelDispatchOperation.

The returned array and its <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> are only valid while <em class="parameter"><code>self</code></em>

 is

valid - copy array and reference channels with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> if needed.</p>

<div class="refsect3">

<a name="id-1.4.49.11.15.7"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody><tr>

<td class="parameter_name"><p>self</p></td>

<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr></tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.15.8"></a><h4>Returns</h4>

<p> the value of <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--channels" title="The “channels” property"><span class="type">“channels”</span></a>. </p>

<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

</div>

<p class="since">Since 0.11.5</p>

</div>

<hr>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-borrow-connection"></a><h3>tp_channel_dispatch_operation_borrow_connection ()</h3>

<pre class="programlisting"><a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="returnvalue">TpConnection</span></a> *

tp_channel_dispatch_operation_borrow_connection

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>);</pre>

<div class="warning">

<p><code class="literal">tp_channel_dispatch_operation_borrow_connection</code> is deprecated and should not be used in newly-written code.</p>

<p>Since 0.19.9. New code should use

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-connection" title="tp_channel_dispatch_operation_get_connection ()"><code class="function">tp_channel_dispatch_operation_get_connection()</code></a> instead.</p>

</div>

<p>Returns the <a class="link" href="telepathy-glib-connection.html#TpConnection"><span class="type">TpConnection</span></a> of this ChannelDispatchOperation.

The returned pointer is only valid while <em class="parameter"><code>self</code></em>

 is valid - reference

it with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> if needed.</p>

<div class="refsect3">

<a name="id-1.4.49.11.16.7"></a><h4>Parameters</h4>

<div class="informaltable"><table width="100%" border="0">

<colgroup>

<col width="150px" class="parameters_name">

<col class="parameters_description">

<col width="200px" class="parameters_annotations">

</colgroup>

<tbody><tr>

<td class="parameter_name"><p>self</p></td>

<td class="parameter_description"><p>a <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a></p></td>

<td class="parameter_annotations"> </td>

</tr></tbody>

</table></div>

</div>

<div class="refsect3">

<a name="id-1.4.49.11.16.8"></a><h4>Returns</h4>

<p> the value of <a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation--connection" title="The “connection” property"><span class="type">“connection”</span></a>. </p>

<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>

</div>

<p class="since">Since 0.11.5</p>

</div>

<hr>

<div class="refsect2">

<a name="tp-channel-dispatch-operation-borrow-immutable-properties"></a><h3>tp_channel_dispatch_operation_borrow_immutable_properties ()</h3>

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *

tp_channel_dispatch_operation_borrow_immutable_properties

                               (<em class="parameter"><code><a class="link" href="telepathy-glib-channel-dispatch-operation.html#TpChannelDispatchOperation"><span class="type">TpChannelDispatchOperation</span></a> *self</code></em>);</pre>

<div class="warning">

<p><code class="literal">tp_channel_dispatch_operation_borrow_immutable_properties</code> is deprecated and should not be used in newly-written code.</p>

<p>Since 0.19.9. New code should use individual property

 getters like <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-connection" title="tp_channel_dispatch_operation_get_connection ()"><code class="function">tp_channel_dispatch_operation_get_connection()</code></a>,

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-account" title="tp_channel_dispatch_operation_get_account ()"><code class="function">tp_channel_dispatch_operation_get_account()</code></a>,

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-channels" title="tp_channel_dispatch_operation_get_channels ()"><code class="function">tp_channel_dispatch_operation_get_channels()</code></a>, or

 <a class="link" href="telepathy-glib-channel-dispatch-operation.html#tp-channel-dispatch-operation-get-possible-handlers" title="tp_channel_dispatch_operation_get_possible_handlers ()"><code class="function">tp_channel_dispatch_operation_get_possible_handlers()</code></a> instead.</p>

</div>

<p>Returns the immutable D-Bus properties of this channel.

The returned hash table is only valid while <em class="parameter"><code>self</code></em>

 is valid - reference

it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#g-hash-table-ref"><code class="function">g_hash_table_ref()</code></a> if needed.</p>