← Back to branch summary

~ubuntu-branches/ubuntu/utopic/telepathy-mission-control-5/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/reference/mission-control-plugins/html/mission-control-plugins-McpDispatchOperationPolicy.html

  • Committer: Package Import Robot
  • Author(s): Sebastien Bacher
  • Date: 2013-11-13 23:23:05 UTC
  • mfrom: (0.13.7) (0.2.27 sid)
  • Revision ID: package-import@ubuntu.com-20131113232305-sev3nx1lps1xgya6
Tags: 1:5.16.0-1ubuntu1
* Resynchronize on Debian, remaining changes:
* debian/apparmor-profile, debian/control:
  - build-depends on dh-apparmor, suggests apparmor
* debian/rules: 
  - install apparmor and apport files
* debian/telepathy-mission-control-5.apport: 
  - include extra debug informations
* debian/telepathy-mission-control-5.dirs:
  - create apparmor and apport directories

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/reference/mission-control-plugins/html/mission-control-plugins-McpDispatchOperationPolicy.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>McpDispatchOperationPolicy</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="Mission Control Plugins Reference Manual">
8
8
<link rel="up" href="ch04.html" title="Channel dispatch operations">
9
9
<link rel="prev" href="ch04.html" title="Channel dispatch operations">
10
10
<link rel="next" href="McpDispatchOperation.html" title="McpDispatchOperation">
11
 
<meta name="generator" content="GTK-Doc V1.18 (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">
42
42
 
43
43
<span class="returnvalue">void</span>                (<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyCb" title="McpDispatchOperationPolicyCb ()">*McpDispatchOperationPolicyCb</a>)     (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
44
44
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>);
 
45
<span class="returnvalue">void</span>                <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-check" title="mcp_dispatch_operation_policy_check ()">mcp_dispatch_operation_policy_check</a> (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
 
46
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>);
 
47
<span class="returnvalue">void</span>                (<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyHandlerIsSuitableAsync" title="McpDispatchOperationPolicyHandlerIsSuitableAsync ()">*McpDispatchOperationPolicyHandlerIsSuitableAsync</a>)
 
48
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
 
49
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.22.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
 
50
                                                         <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> *unique_name</code></em>,
 
51
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
 
52
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
53
                                                         <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>);
45
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyFinisher" title="McpDispatchOperationPolicyFinisher ()">*McpDispatchOperationPolicyFinisher</a>)
46
55
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
47
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
48
57
                                                         <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>);
49
 
<span class="returnvalue">void</span>                (<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyHandlerIsSuitableAsync" title="McpDispatchOperationPolicyHandlerIsSuitableAsync ()">*McpDispatchOperationPolicyHandlerIsSuitableAsync</a>)
50
 
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
51
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.20.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
52
 
                                                         <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> *unique_name</code></em>,
53
 
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
54
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
55
 
                                                         <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>);
56
 
struct              <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyIface" title="struct McpDispatchOperationPolicyIface">McpDispatchOperationPolicyIface</a>;
57
 
<span class="returnvalue">void</span>                <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-check" title="mcp_dispatch_operation_policy_check ()">mcp_dispatch_operation_policy_check</a> (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
58
 
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>);
59
58
<span class="returnvalue">void</span>                <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()">mcp_dispatch_operation_policy_handler_is_suitable_async</a>
60
59
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
61
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.20.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
 
60
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.22.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
62
61
                                                         <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> *unique_name</code></em>,
63
62
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
64
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
70
69
<span class="returnvalue">void</span>                <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-iface-implement-check" title="mcp_dispatch_operation_policy_iface_implement_check ()">mcp_dispatch_operation_policy_iface_implement_check</a>
71
70
                                                        (<em class="parameter"><code><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyIface" title="struct McpDispatchOperationPolicyIface"><span class="type">McpDispatchOperationPolicyIface</span></a> *iface</code></em>,
72
71
                                                         <em class="parameter"><code><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyCb" title="McpDispatchOperationPolicyCb ()"><span class="type">McpDispatchOperationPolicyCb</span></a> impl</code></em>);
 
72
struct              <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyIface" title="struct McpDispatchOperationPolicyIface">McpDispatchOperationPolicyIface</a>;
73
73
</pre>
74
74
</div>
75
75
<div class="refsect1">
93
93
<p>
94
94
</p>
95
95
<div class="example">
96
 
<a name="idp12609088"></a><p class="title"><b>Example 3. </b></p>
 
96
<a name="id-1.5.2.4.5.1"></a><p class="title"><b>Example 3. </b></p>
97
97
<div class="example-contents">
98
98
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
99
99
    <tbody>
150
150
<p>
151
151
Signature of an implementation of <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-check" title="mcp_dispatch_operation_policy_check ()"><code class="function">mcp_dispatch_operation_policy_check()</code></a>.
152
152
</p>
153
 
<div class="variablelist"><table border="0">
154
 
<col align="left" valign="top">
155
 
<tbody>
156
 
<tr>
157
 
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
158
 
<td>an implementation of this interface, provided by a plugin</td>
159
 
</tr>
160
 
<tr>
161
 
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
162
 
<td>an object representing a dispatch operation, i.e.
163
 
a bundle of channels being dispatched</td>
164
 
</tr>
165
 
</tbody>
166
 
</table></div>
167
 
</div>
168
 
<hr>
169
 
<div class="refsect2">
170
 
<a name="McpDispatchOperationPolicyFinisher"></a><h3>McpDispatchOperationPolicyFinisher ()</h3>
171
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*McpDispatchOperationPolicyFinisher)
172
 
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
173
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
174
 
                                                         <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>
175
 
<p>
176
 
Signature of a virtual method used to finish an asynchronous operation
177
 
that succeeds or fails, but does not return any additional value.
178
 
</p>
179
 
<div class="variablelist"><table border="0">
180
 
<col align="left" valign="top">
181
 
<tbody>
182
 
<tr>
183
 
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
184
 
<td>an implementation of this interface, provided by a plugin</td>
185
 
</tr>
186
 
<tr>
187
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
188
 
<td>the asynchronous result passed to a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a>
189
 
</td>
190
 
</tr>
191
 
<tr>
192
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
193
 
<td>used to return an error. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
194
 
</td>
195
 
</tr>
196
 
<tr>
197
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
198
 
<td>
199
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</td>
200
 
</tr>
201
 
</tbody>
202
 
</table></div>
203
 
</div>
204
 
<hr>
205
 
<div class="refsect2">
206
 
<a name="McpDispatchOperationPolicyHandlerIsSuitableAsync"></a><h3>McpDispatchOperationPolicyHandlerIsSuitableAsync ()</h3>
207
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*McpDispatchOperationPolicyHandlerIsSuitableAsync)
208
 
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
209
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.20.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
210
 
                                                         <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> *unique_name</code></em>,
211
 
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
212
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
213
 
                                                         <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>);</pre>
214
 
<p>
215
 
Signature of <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_async()</code></a>
216
 
</p>
217
 
<div class="variablelist"><table border="0">
218
 
<col align="left" valign="top">
219
 
<tbody>
220
 
<tr>
221
 
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
222
 
<td>an implementation of this interface, provided by a plugin</td>
223
 
</tr>
224
 
<tr>
225
 
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
226
 
<td>a proxy for the Handler's D-Bus API, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the Handler
227
 
is calling Claim (so its well-known name is not immediately obvious)</td>
228
 
</tr>
229
 
<tr>
230
 
<td><p><span class="term"><em class="parameter"><code>unique_name</code></em> :</span></p></td>
231
 
<td>The Handler's unique name, or empty or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it has not yet
232
 
been started</td>
233
 
</tr>
234
 
<tr>
235
 
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
236
 
<td>an object representing a dispatch operation, i.e.
237
 
a bundle of channels being dispatched</td>
238
 
</tr>
239
 
<tr>
240
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
241
 
<td>callback to be called on success or failure</td>
242
 
</tr>
243
 
<tr>
244
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
245
 
<td>user data for the callback</td>
246
 
</tr>
247
 
</tbody>
248
 
</table></div>
249
 
</div>
250
 
<hr>
251
 
<div class="refsect2">
252
 
<a name="McpDispatchOperationPolicyIface"></a><h3>struct McpDispatchOperationPolicyIface</h3>
253
 
<pre class="programlisting">struct McpDispatchOperationPolicyIface {
254
 
    GTypeInterface parent;
255
 
 
256
 
    McpDispatchOperationPolicyCb check;
257
 
    McpDispatchOperationPolicyHandlerIsSuitableAsync handler_is_suitable_async;
258
 
    McpDispatchOperationPolicyFinisher handler_is_suitable_finish;
259
 
};
260
 
</pre>
261
 
<div class="variablelist"><table border="0">
262
 
<col align="left" valign="top">
263
 
<tbody>
264
 
<tr>
265
 
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.parent"></a>parent</code></em>;</span></p></td>
266
 
<td>the parent type</td>
267
 
</tr>
268
 
<tr>
269
 
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyCb" title="McpDispatchOperationPolicyCb ()"><span class="type">McpDispatchOperationPolicyCb</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.check"></a>check</code></em>;</span></p></td>
270
 
<td>an implementation of <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-check" title="mcp_dispatch_operation_policy_check ()"><code class="function">mcp_dispatch_operation_policy_check()</code></a>;
271
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is equivalent to an implementation that does nothing</td>
272
 
</tr>
273
 
<tr>
274
 
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyHandlerIsSuitableAsync" title="McpDispatchOperationPolicyHandlerIsSuitableAsync ()"><span class="type">McpDispatchOperationPolicyHandlerIsSuitableAsync</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.handler-is-suitable-async"></a>handler_is_suitable_async</code></em>;</span></p></td>
275
 
<td>an implementation of
276
 
<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_async()</code></a>;
277
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is treated as equivalent to an implementation that accepts
278
 
every handler, i.e. always asynchronously returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
279
 
</td>
280
 
</tr>
281
 
<tr>
282
 
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyFinisher" title="McpDispatchOperationPolicyFinisher ()"><span class="type">McpDispatchOperationPolicyFinisher</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.handler-is-suitable-finish"></a>handler_is_suitable_finish</code></em>;</span></p></td>
283
 
<td>an implementation of
284
 
<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-finish" title="mcp_dispatch_operation_policy_handler_is_suitable_finish ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_finish()</code></a>;
285
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is treated as equivalent to an implementation that accepts any
286
 
<a href="http://library.gnome.org/devel/gio/unstable/GSimpleAsyncResult.html"><span class="type">GSimpleAsyncResult</span></a>
287
 
</td>
 
153
<div class="variablelist"><table border="0" class="variablelist">
 
154
<colgroup>
 
155
<col align="left" valign="top">
 
156
<col>
 
157
</colgroup>
 
158
<tbody>
 
159
<tr>
 
160
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
 
161
<td>an implementation of this interface, provided by a plugin</td>
 
162
</tr>
 
163
<tr>
 
164
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
 
165
<td>an object representing a dispatch operation, i.e.
 
166
a bundle of channels being dispatched</td>
288
167
</tr>
289
168
</tbody>
290
169
</table></div>
305
184
Observers, but before Approvers, and without waiting for Observers to
306
185
reply.
307
186
</p>
308
 
<div class="variablelist"><table border="0">
309
 
<col align="left" valign="top">
310
 
<tbody>
311
 
<tr>
312
 
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
313
 
<td>an implementation of this interface, provided by a plugin</td>
314
 
</tr>
315
 
<tr>
316
 
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
317
 
<td>an object representing a dispatch operation, i.e.
318
 
a bundle of channels being dispatched</td>
 
187
<div class="variablelist"><table border="0" class="variablelist">
 
188
<colgroup>
 
189
<col align="left" valign="top">
 
190
<col>
 
191
</colgroup>
 
192
<tbody>
 
193
<tr>
 
194
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
 
195
<td>an implementation of this interface, provided by a plugin</td>
 
196
</tr>
 
197
<tr>
 
198
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
 
199
<td>an object representing a dispatch operation, i.e.
 
200
a bundle of channels being dispatched</td>
 
201
</tr>
 
202
</tbody>
 
203
</table></div>
 
204
</div>
 
205
<hr>
 
206
<div class="refsect2">
 
207
<a name="McpDispatchOperationPolicyHandlerIsSuitableAsync"></a><h3>McpDispatchOperationPolicyHandlerIsSuitableAsync ()</h3>
 
208
<pre class="programlisting"><span class="returnvalue">void</span>                (*McpDispatchOperationPolicyHandlerIsSuitableAsync)
 
209
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
 
210
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.22.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
 
211
                                                         <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> *unique_name</code></em>,
 
212
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
 
213
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
214
                                                         <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>);</pre>
 
215
<p>
 
216
Signature of <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_async()</code></a>
 
217
</p>
 
218
<div class="variablelist"><table border="0" class="variablelist">
 
219
<colgroup>
 
220
<col align="left" valign="top">
 
221
<col>
 
222
</colgroup>
 
223
<tbody>
 
224
<tr>
 
225
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
 
226
<td>an implementation of this interface, provided by a plugin</td>
 
227
</tr>
 
228
<tr>
 
229
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
 
230
<td>a proxy for the Handler's D-Bus API, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the Handler
 
231
is calling Claim (so its well-known name is not immediately obvious)</td>
 
232
</tr>
 
233
<tr>
 
234
<td><p><span class="term"><em class="parameter"><code>unique_name</code></em> :</span></p></td>
 
235
<td>The Handler's unique name, or empty or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it has not yet
 
236
been started</td>
 
237
</tr>
 
238
<tr>
 
239
<td><p><span class="term"><em class="parameter"><code>dispatch_operation</code></em> :</span></p></td>
 
240
<td>an object representing a dispatch operation, i.e.
 
241
a bundle of channels being dispatched</td>
 
242
</tr>
 
243
<tr>
 
244
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
245
<td>callback to be called on success or failure</td>
 
246
</tr>
 
247
<tr>
 
248
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
249
<td>user data for the callback</td>
 
250
</tr>
 
251
</tbody>
 
252
</table></div>
 
253
</div>
 
254
<hr>
 
255
<div class="refsect2">
 
256
<a name="McpDispatchOperationPolicyFinisher"></a><h3>McpDispatchOperationPolicyFinisher ()</h3>
 
257
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*McpDispatchOperationPolicyFinisher)
 
258
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
 
259
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
260
                                                         <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>
 
261
<p>
 
262
Signature of a virtual method used to finish an asynchronous operation
 
263
that succeeds or fails, but does not return any additional value.
 
264
</p>
 
265
<div class="variablelist"><table border="0" class="variablelist">
 
266
<colgroup>
 
267
<col align="left" valign="top">
 
268
<col>
 
269
</colgroup>
 
270
<tbody>
 
271
<tr>
 
272
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
 
273
<td>an implementation of this interface, provided by a plugin</td>
 
274
</tr>
 
275
<tr>
 
276
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 
277
<td>the asynchronous result passed to a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a>
 
278
</td>
 
279
</tr>
 
280
<tr>
 
281
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
282
<td>used to return an error. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
283
</td>
 
284
</tr>
 
285
<tr>
 
286
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
287
<td>
 
288
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</td>
319
289
</tr>
320
290
</tbody>
321
291
</table></div>
325
295
<a name="mcp-dispatch-operation-policy-handler-is-suitable-async"></a><h3>mcp_dispatch_operation_policy_handler_is_suitable_async ()</h3>
326
296
<pre class="programlisting"><span class="returnvalue">void</span>                mcp_dispatch_operation_policy_handler_is_suitable_async
327
297
                                                        (<em class="parameter"><code><span class="type">McpDispatchOperationPolicy</span> *policy</code></em>,
328
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.20.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
 
298
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib-0.22.x/telepathy-glib-client.html#TpClient"><span class="type">TpClient</span></a> *handler</code></em>,
329
299
                                                         <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> *unique_name</code></em>,
330
300
                                                         <em class="parameter"><code><a class="link" href="McpDispatchOperation.html" title="McpDispatchOperation"><span class="type">McpDispatchOperation</span></a> *dispatch_operation</code></em>,
331
301
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
341
311
and waits for them all to return. If any of them raises an error,
342
312
the handler is considered to be unsuitable.
343
313
</p>
344
 
<div class="variablelist"><table border="0">
 
314
<div class="variablelist"><table border="0" class="variablelist">
 
315
<colgroup>
345
316
<col align="left" valign="top">
 
317
<col>
 
318
</colgroup>
346
319
<tbody>
347
320
<tr>
348
321
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
384
357
<p>
385
358
Finish a call to <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_async()</code></a>.
386
359
</p>
387
 
<div class="variablelist"><table border="0">
 
360
<div class="variablelist"><table border="0" class="variablelist">
 
361
<colgroup>
388
362
<col align="left" valign="top">
 
363
<col>
 
364
</colgroup>
389
365
<tbody>
390
366
<tr>
391
367
<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
419
395
<p>
420
396
This method is no longer necessary: just set iface-&gt;check = impl instead.
421
397
</p>
422
 
<div class="variablelist"><table border="0">
 
398
<div class="variablelist"><table border="0" class="variablelist">
 
399
<colgroup>
423
400
<col align="left" valign="top">
 
401
<col>
 
402
</colgroup>
424
403
<tbody>
425
404
<tr>
426
405
<td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td>
435
414
</tbody>
436
415
</table></div>
437
416
</div>
 
417
<hr>
 
418
<div class="refsect2">
 
419
<a name="McpDispatchOperationPolicyIface"></a><h3>struct McpDispatchOperationPolicyIface</h3>
 
420
<pre class="programlisting">struct McpDispatchOperationPolicyIface {
 
421
    GTypeInterface parent;
 
422
 
 
423
    McpDispatchOperationPolicyCb check;
 
424
    McpDispatchOperationPolicyHandlerIsSuitableAsync handler_is_suitable_async;
 
425
    McpDispatchOperationPolicyFinisher handler_is_suitable_finish;
 
426
};
 
427
</pre>
 
428
<div class="variablelist"><table border="0" class="variablelist">
 
429
<colgroup>
 
430
<col align="left" valign="top">
 
431
<col>
 
432
</colgroup>
 
433
<tbody>
 
434
<tr>
 
435
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.parent"></a>parent</code></em>;</span></p></td>
 
436
<td>the parent type</td>
 
437
</tr>
 
438
<tr>
 
439
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyCb" title="McpDispatchOperationPolicyCb ()"><span class="type">McpDispatchOperationPolicyCb</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.check"></a>check</code></em>;</span></p></td>
 
440
<td>an implementation of <a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-check" title="mcp_dispatch_operation_policy_check ()"><code class="function">mcp_dispatch_operation_policy_check()</code></a>;
 
441
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is equivalent to an implementation that does nothing</td>
 
442
</tr>
 
443
<tr>
 
444
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyHandlerIsSuitableAsync" title="McpDispatchOperationPolicyHandlerIsSuitableAsync ()"><span class="type">McpDispatchOperationPolicyHandlerIsSuitableAsync</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.handler-is-suitable-async"></a>handler_is_suitable_async</code></em>;</span></p></td>
 
445
<td>an implementation of
 
446
<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-async" title="mcp_dispatch_operation_policy_handler_is_suitable_async ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_async()</code></a>;
 
447
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is treated as equivalent to an implementation that accepts
 
448
every handler, i.e. always asynchronously returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
 
449
</td>
 
450
</tr>
 
451
<tr>
 
452
<td><p><span class="term"><a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#McpDispatchOperationPolicyFinisher" title="McpDispatchOperationPolicyFinisher ()"><span class="type">McpDispatchOperationPolicyFinisher</span></a> <em class="structfield"><code><a name="McpDispatchOperationPolicyIface.handler-is-suitable-finish"></a>handler_is_suitable_finish</code></em>;</span></p></td>
 
453
<td>an implementation of
 
454
<a class="link" href="mission-control-plugins-McpDispatchOperationPolicy.html#mcp-dispatch-operation-policy-handler-is-suitable-finish" title="mcp_dispatch_operation_policy_handler_is_suitable_finish ()"><code class="function">mcp_dispatch_operation_policy_handler_is_suitable_finish()</code></a>;
 
455
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is treated as equivalent to an implementation that accepts any
 
456
<a href="http://library.gnome.org/devel/gio/unstable/GSimpleAsyncResult.html"><span class="type">GSimpleAsyncResult</span></a>
 
457
</td>
 
458
</tr>
 
459
</tbody>
 
460
</table></div>
 
461
</div>
438
462
</div>
439
463
<div class="refsect1">
440
464
<a name="mission-control-plugins-McpDispatchOperationPolicy.see-also"></a><h2>See Also</h2>
443
467
</div>
444
468
<div class="footer">
445
469
<hr>
446
 
          Generated by GTK-Doc V1.18</div>
 
470
          Generated by GTK-Doc V1.19</div>
447
471
</body>
448
472
</html>
 
 
b'\\ No newline at end of file'