~ubuntu-branches/debian/jessie/glib2.0/jessie

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GDBusProxy.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-09-23 10:12:15 UTC
  • mto: This revision was merged to the branch mainline in revision 120.
  • Revision ID: package-import@ubuntu.com-20140923101215-kg4894xy8gz996q1
Tags: upstream-2.42.0
Import upstream version 2.42.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
108
108
</td>
109
109
</tr>
110
110
<tr>
111
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
111
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
112
112
</td>
113
113
<td class="function_name">
114
114
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-name" title="g_dbus_proxy_get_name ()">g_dbus_proxy_get_name</a> <span class="c_punctuation">()</span>
116
116
</tr>
117
117
<tr>
118
118
<td class="function_type">
119
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
119
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
120
120
</td>
121
121
<td class="function_name">
122
122
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-name-owner" title="g_dbus_proxy_get_name_owner ()">g_dbus_proxy_get_name_owner</a> <span class="c_punctuation">()</span>
123
123
</td>
124
124
</tr>
125
125
<tr>
126
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
126
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
127
127
</td>
128
128
<td class="function_name">
129
129
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-object-path" title="g_dbus_proxy_get_object_path ()">g_dbus_proxy_get_object_path</a> <span class="c_punctuation">()</span>
130
130
</td>
131
131
</tr>
132
132
<tr>
133
 
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
133
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
134
134
</td>
135
135
<td class="function_name">
136
136
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-interface-name" title="g_dbus_proxy_get_interface_name ()">g_dbus_proxy_get_interface_name</a> <span class="c_punctuation">()</span>
138
138
</tr>
139
139
<tr>
140
140
<td class="function_type">
141
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 
141
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
142
142
</td>
143
143
<td class="function_name">
144
144
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-default-timeout" title="g_dbus_proxy_get_default_timeout ()">g_dbus_proxy_get_default_timeout</a> <span class="c_punctuation">()</span>
154
154
</tr>
155
155
<tr>
156
156
<td class="function_type">
157
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
157
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
158
158
</td>
159
159
<td class="function_name">
160
160
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-cached-property" title="g_dbus_proxy_get_cached_property ()">g_dbus_proxy_get_cached_property</a> <span class="c_punctuation">()</span>
170
170
</tr>
171
171
<tr>
172
172
<td class="function_type">
173
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
 
173
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
174
174
</td>
175
175
<td class="function_name">
176
176
<a class="link" href="GDBusProxy.html#g-dbus-proxy-get-cached-property-names" title="g_dbus_proxy_get_cached_property_names ()">g_dbus_proxy_get_cached_property_names</a> <span class="c_punctuation">()</span>
202
202
</tr>
203
203
<tr>
204
204
<td class="function_type">
205
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
205
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
206
206
</td>
207
207
<td class="function_name">
208
208
<a class="link" href="GDBusProxy.html#g-dbus-proxy-call-finish" title="g_dbus_proxy_call_finish ()">g_dbus_proxy_call_finish</a> <span class="c_punctuation">()</span>
210
210
</tr>
211
211
<tr>
212
212
<td class="function_type">
213
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
213
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
214
214
</td>
215
215
<td class="function_name">
216
216
<a class="link" href="GDBusProxy.html#g-dbus-proxy-call-sync" title="g_dbus_proxy_call_sync ()">g_dbus_proxy_call_sync</a> <span class="c_punctuation">()</span>
226
226
</tr>
227
227
<tr>
228
228
<td class="function_type">
229
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
229
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
230
230
</td>
231
231
<td class="function_name">
232
232
<a class="link" href="GDBusProxy.html#g-dbus-proxy-call-with-unix-fd-list-finish" title="g_dbus_proxy_call_with_unix_fd_list_finish ()">g_dbus_proxy_call_with_unix_fd_list_finish</a> <span class="c_punctuation">()</span>
234
234
</tr>
235
235
<tr>
236
236
<td class="function_type">
237
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
237
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
238
238
</td>
239
239
<td class="function_name">
240
240
<a class="link" href="GDBusProxy.html#g-dbus-proxy-call-with-unix-fd-list-sync" title="g_dbus_proxy_call_with_unix_fd_list_sync ()">g_dbus_proxy_call_with_unix_fd_list_sync</a> <span class="c_punctuation">()</span>
264
264
<td class="property_flags">Read / Write / Construct Only</td>
265
265
</tr>
266
266
<tr>
267
 
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
 
267
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
268
268
<td class="property_name"><a class="link" href="GDBusProxy.html#GDBusProxy--g-default-timeout" title="The “g-default-timeout” property">g-default-timeout</a></td>
269
269
<td class="property_flags">Read / Write / Construct</td>
270
270
</tr>
281
281
</tr>
282
282
<tr>
283
283
<td class="property_type">
284
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
284
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
285
285
<td class="property_name"><a class="link" href="GDBusProxy.html#GDBusProxy--g-interface-name" title="The “g-interface-name” property">g-interface-name</a></td>
286
286
<td class="property_flags">Read / Write / Construct Only</td>
287
287
</tr>
288
288
<tr>
289
289
<td class="property_type">
290
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
290
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
291
291
<td class="property_name"><a class="link" href="GDBusProxy.html#GDBusProxy--g-name" title="The “g-name” property">g-name</a></td>
292
292
<td class="property_flags">Read / Write / Construct Only</td>
293
293
</tr>
294
294
<tr>
295
295
<td class="property_type">
296
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
296
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
297
297
<td class="property_name"><a class="link" href="GDBusProxy.html#GDBusProxy--g-name-owner" title="The “g-name-owner” property">g-name-owner</a></td>
298
298
<td class="property_flags">Read</td>
299
299
</tr>
300
300
<tr>
301
301
<td class="property_type">
302
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
302
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
303
303
<td class="property_name"><a class="link" href="GDBusProxy.html#GDBusProxy--g-object-path" title="The “g-object-path” property">g-object-path</a></td>
304
304
<td class="property_flags">Read / Write / Construct Only</td>
305
305
</tr>
353
353
</div>
354
354
<div class="refsect1">
355
355
<a name="GDBusProxy.object-hierarchy"></a><h2>Object Hierarchy</h2>
356
 
<pre class="screen">    GFlags
 
356
<pre class="screen">    <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a>
357
357
    <span class="lineart">╰──</span> GDBusProxyFlags
358
 
    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
358
    <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
359
359
    <span class="lineart">╰──</span> GDBusProxy
360
360
</pre>
361
361
</div>
383
383
vanishes and reloaded when a name owner appears.</p>
384
384
<p>If a <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> is used for a well-known name, the owner of the
385
385
name is tracked and can be read from
386
 
<a class="link" href="GDBusProxy.html#GDBusProxy--g-name-owner" title="The “g-name-owner” property"><span class="type">“g-name-owner”</span></a>. Connect to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to
 
386
<a class="link" href="GDBusProxy.html#GDBusProxy--g-name-owner" title="The “g-name-owner” property"><span class="type">“g-name-owner”</span></a>. Connect to the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to
387
387
get notified of changes. Additionally, only signals and property
388
388
changes emitted from the current name owner are considered and
389
389
calls are always sent to the current name owner. This avoids a
400
400
easily be done using the <a href="gdbus-codegen.html">gdbus-codegen</a> tool.</p>
401
401
<p>A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> instance can be used from multiple threads but note
402
402
that all signals (e.g. <a class="link" href="GDBusProxy.html#GDBusProxy-g-signal" title="The “g-signal” signal"><span class="type">“g-signal”</span></a>, <a class="link" href="GDBusProxy.html#GDBusProxy-g-properties-changed" title="The “g-properties-changed” signal"><span class="type">“g-properties-changed”</span></a>
403
 
and <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a>) are emitted in the
404
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
 
403
and <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a>) are emitted in the
 
404
<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
405
405
of the thread where the instance was constructed.</p>
406
406
<p>An example using a proxy for a well-known name can be found in
407
407
<a class="ulink" href="https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-watch-proxy.c" target="_top">gdbus-example-watch-proxy.c</a></p>
414
414
g_dbus_proxy_new (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
415
415
                  <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
416
416
                  <em class="parameter"><code><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> *info</code></em>,
417
 
                  <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> *name</code></em>,
418
 
                  <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>,
419
 
                  <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> *interface_name</code></em>,
 
417
                  <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
418
                  <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
419
                  <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
420
420
                  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
421
421
                  <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
422
 
                  <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>
 
422
                  <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
423
423
<p>Creates a proxy for accessing <em class="parameter"><code>interface_name</code></em>
424
424
 on the remote object
425
425
at <em class="parameter"><code>object_path</code></em>
466
466
<tr>
467
467
<td class="parameter_name"><p>info</p></td>
468
468
<td class="parameter_description"><p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> specifying the minimal interface that <em class="parameter"><code>proxy</code></em>
469
 
conforms to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
469
conforms to or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
470
470
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
471
471
</tr>
472
472
<tr>
473
473
<td class="parameter_name"><p>name</p></td>
474
 
<td class="parameter_description"><p> A bus name (well-known or unique) 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>connection</code></em>
 
474
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
475
475
is not a message bus connection. </p></td>
476
476
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
477
477
</tr>
487
487
</tr>
488
488
<tr>
489
489
<td class="parameter_name"><p>cancellable</p></td>
490
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
490
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
491
491
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
492
492
</tr>
493
493
<tr>
511
511
<a name="g-dbus-proxy-new-finish"></a><h3>g_dbus_proxy_new_finish ()</h3>
512
512
<pre class="programlisting"><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="returnvalue">GDBusProxy</span></a> *
513
513
g_dbus_proxy_new_finish (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
514
 
                         <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>
 
514
                         <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
515
515
<p>Finishes creating a <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a>.</p>
516
516
<div class="refsect3">
517
517
<a name="id-1.4.18.6.11.3.5"></a><h4>Parameters</h4>
529
529
</tr>
530
530
<tr>
531
531
<td class="parameter_name"><p>error</p></td>
532
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
532
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
533
533
<td class="parameter_annotations"> </td>
534
534
</tr>
535
535
</tbody>
537
537
</div>
538
538
<div class="refsect3">
539
539
<a name="id-1.4.18.6.11.3.6"></a><h4>Returns</h4>
540
 
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> 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>error</code></em>
541
 
is set. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 
540
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
541
is set. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
542
542
<p></p>
543
543
</div>
544
544
<p class="since">Since 2.26</p>
550
550
g_dbus_proxy_new_sync (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
551
551
                       <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
552
552
                       <em class="parameter"><code><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> *info</code></em>,
553
 
                       <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> *name</code></em>,
554
 
                       <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>,
555
 
                       <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> *interface_name</code></em>,
 
553
                       <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
554
                       <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
555
                       <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
556
556
                       <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
557
 
                       <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>
 
557
                       <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
558
558
<p>Creates a proxy for accessing <em class="parameter"><code>interface_name</code></em>
559
559
 on the remote object
560
560
at <em class="parameter"><code>object_path</code></em>
596
596
<tr>
597
597
<td class="parameter_name"><p>info</p></td>
598
598
<td class="parameter_description"><p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> specifying the minimal interface that <em class="parameter"><code>proxy</code></em>
599
 
conforms to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
599
conforms to or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
600
600
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
601
601
</tr>
602
602
<tr>
603
603
<td class="parameter_name"><p>name</p></td>
604
 
<td class="parameter_description"><p> A bus name (well-known or unique) 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>connection</code></em>
 
604
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
605
605
is not a message bus connection. </p></td>
606
606
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
607
607
</tr>
617
617
</tr>
618
618
<tr>
619
619
<td class="parameter_name"><p>cancellable</p></td>
620
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
620
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
621
621
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
622
622
</tr>
623
623
<tr>
624
624
<td class="parameter_name"><p>error</p></td>
625
 
<td class="parameter_description"><p> Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
625
<td class="parameter_description"><p> Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
626
626
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
627
627
</tr>
628
628
</tbody>
630
630
</div>
631
631
<div class="refsect3">
632
632
<a name="id-1.4.18.6.11.4.10"></a><h4>Returns</h4>
633
 
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if error is set. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 
633
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if error is set. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
634
634
<p></p>
635
635
</div>
636
636
<p class="since">Since 2.26</p>
642
642
g_dbus_proxy_new_for_bus (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
643
643
                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
644
644
                          <em class="parameter"><code><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> *info</code></em>,
645
 
                          <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> *name</code></em>,
646
 
                          <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>,
647
 
                          <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> *interface_name</code></em>,
 
645
                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
646
                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
647
                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
648
648
                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
649
649
                          <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
650
 
                          <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>
 
650
                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
651
651
<p>Like <a class="link" href="GDBusProxy.html#g-dbus-proxy-new" title="g_dbus_proxy_new ()"><code class="function">g_dbus_proxy_new()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</p>
652
652
<p><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> is used in this example.</p>
653
653
<div class="refsect3">
672
672
<tr>
673
673
<td class="parameter_name"><p>info</p></td>
674
674
<td class="parameter_description"><p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> specifying the minimal interface that <em class="parameter"><code>proxy</code></em>
675
 
conforms to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
675
conforms to or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
676
676
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
677
677
</tr>
678
678
<tr>
692
692
</tr>
693
693
<tr>
694
694
<td class="parameter_name"><p>cancellable</p></td>
695
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
695
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
696
696
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
697
697
</tr>
698
698
<tr>
716
716
<a name="g-dbus-proxy-new-for-bus-finish"></a><h3>g_dbus_proxy_new_for_bus_finish ()</h3>
717
717
<pre class="programlisting"><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="returnvalue">GDBusProxy</span></a> *
718
718
g_dbus_proxy_new_for_bus_finish (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
719
 
                                 <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>
 
719
                                 <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
720
720
<p>Finishes creating a <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a>.</p>
721
721
<div class="refsect3">
722
722
<a name="id-1.4.18.6.11.6.5"></a><h4>Parameters</h4>
734
734
</tr>
735
735
<tr>
736
736
<td class="parameter_name"><p>error</p></td>
737
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
737
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
738
738
<td class="parameter_annotations"> </td>
739
739
</tr>
740
740
</tbody>
742
742
</div>
743
743
<div class="refsect3">
744
744
<a name="id-1.4.18.6.11.6.6"></a><h4>Returns</h4>
745
 
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> 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>error</code></em>
746
 
is set. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 
745
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
746
is set. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
747
747
<p></p>
748
748
</div>
749
749
<p class="since">Since 2.26</p>
755
755
g_dbus_proxy_new_for_bus_sync (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
756
756
                               <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
757
757
                               <em class="parameter"><code><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> *info</code></em>,
758
 
                               <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> *name</code></em>,
759
 
                               <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>,
760
 
                               <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> *interface_name</code></em>,
 
758
                               <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 
759
                               <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
 
760
                               <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
761
761
                               <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
762
 
                               <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>
 
762
                               <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
763
763
<p>Like <a class="link" href="GDBusProxy.html#g-dbus-proxy-new-sync" title="g_dbus_proxy_new_sync ()"><code class="function">g_dbus_proxy_new_sync()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</p>
764
764
<p><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> is used in this example.</p>
765
765
<div class="refsect3">
785
785
<td class="parameter_name"><p>info</p></td>
786
786
<td class="parameter_description"><p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> specifying the minimal interface
787
787
that <em class="parameter"><code>proxy</code></em>
788
 
conforms to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
788
conforms to or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
789
789
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
790
790
</tr>
791
791
<tr>
805
805
</tr>
806
806
<tr>
807
807
<td class="parameter_name"><p>cancellable</p></td>
808
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
808
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
809
809
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
810
810
</tr>
811
811
<tr>
812
812
<td class="parameter_name"><p>error</p></td>
813
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
813
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
814
814
<td class="parameter_annotations"> </td>
815
815
</tr>
816
816
</tbody>
818
818
</div>
819
819
<div class="refsect3">
820
820
<a name="id-1.4.18.6.11.7.7"></a><h4>Returns</h4>
821
 
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if error is set. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 
821
<p> A <a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if error is set. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
822
822
<p></p>
823
823
</div>
824
824
<p class="since">Since 2.26</p>
885
885
<hr>
886
886
<div class="refsect2">
887
887
<a name="g-dbus-proxy-get-name"></a><h3>g_dbus_proxy_get_name ()</h3>
888
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
888
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
889
889
g_dbus_proxy_get_name (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
890
890
<p>Gets the name that <em class="parameter"><code>proxy</code></em>
891
891
 was constructed for.</p>
915
915
<hr>
916
916
<div class="refsect2">
917
917
<a name="g-dbus-proxy-get-name-owner"></a><h3>g_dbus_proxy_get_name_owner ()</h3>
918
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
918
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
919
919
g_dbus_proxy_get_name_owner (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
920
920
<p>The unique name that owns the name that <em class="parameter"><code>proxy</code></em>
921
 
 is for or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
921
 is for or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
922
922
no-one currently owns that name. You may connect to the
923
 
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to track changes to the
 
923
<a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to track changes to the
924
924
<a class="link" href="GDBusProxy.html#GDBusProxy--g-name-owner" title="The “g-name-owner” property"><span class="type">“g-name-owner”</span></a> property.</p>
925
925
<div class="refsect3">
926
926
<a name="id-1.4.18.6.11.11.5"></a><h4>Parameters</h4>
939
939
</div>
940
940
<div class="refsect3">
941
941
<a name="id-1.4.18.6.11.11.6"></a><h4>Returns</h4>
942
 
<p> The name owner or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no name owner exists. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
 
942
<p> The name owner or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no name owner exists. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
943
943
<p></p>
944
944
</div>
945
945
<p class="since">Since 2.26</p>
947
947
<hr>
948
948
<div class="refsect2">
949
949
<a name="g-dbus-proxy-get-object-path"></a><h3>g_dbus_proxy_get_object_path ()</h3>
950
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
950
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
951
951
g_dbus_proxy_get_object_path (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
952
952
<p>Gets the object path <em class="parameter"><code>proxy</code></em>
953
953
 is for.</p>
977
977
<hr>
978
978
<div class="refsect2">
979
979
<a name="g-dbus-proxy-get-interface-name"></a><h3>g_dbus_proxy_get_interface_name ()</h3>
980
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
980
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
981
981
g_dbus_proxy_get_interface_name (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
982
982
<p>Gets the D-Bus interface name <em class="parameter"><code>proxy</code></em>
983
983
 is for.</p>
1007
1007
<hr>
1008
1008
<div class="refsect2">
1009
1009
<a name="g-dbus-proxy-get-default-timeout"></a><h3>g_dbus_proxy_get_default_timeout ()</h3>
1010
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 
1010
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
1011
1011
g_dbus_proxy_get_default_timeout (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
1012
1012
<p>Gets the timeout to use if -1 (specifying default timeout) is
1013
1013
passed as <em class="parameter"><code>timeout_msec</code></em>
1042
1042
<a name="g-dbus-proxy-set-default-timeout"></a><h3>g_dbus_proxy_set_default_timeout ()</h3>
1043
1043
<pre class="programlisting"><span class="returnvalue">void</span>
1044
1044
g_dbus_proxy_set_default_timeout (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1045
 
                                  <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_msec</code></em>);</pre>
 
1045
                                  <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_msec</code></em>);</pre>
1046
1046
<p>Sets the timeout to use if -1 (specifying default timeout) is
1047
1047
passed as <em class="parameter"><code>timeout_msec</code></em>
1048
1048
 in the <a class="link" href="GDBusProxy.html#g-dbus-proxy-call" title="g_dbus_proxy_call ()"><code class="function">g_dbus_proxy_call()</code></a> and
1075
1075
<hr>
1076
1076
<div class="refsect2">
1077
1077
<a name="g-dbus-proxy-get-cached-property"></a><h3>g_dbus_proxy_get_cached_property ()</h3>
1078
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
1078
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1079
1079
g_dbus_proxy_get_cached_property (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1080
 
                                  <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> *property_name</code></em>);</pre>
 
1080
                                  <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
1081
1081
<p>Looks up the value for a property from the cache. This call does no
1082
1082
blocking IO.</p>
1083
1083
<p>If <em class="parameter"><code>proxy</code></em>
1110
1110
</div>
1111
1111
<div class="refsect3">
1112
1112
<a name="id-1.4.18.6.11.16.7"></a><h4>Returns</h4>
1113
 
<p> A reference to the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance that holds the value
 
1113
<p> A reference to the <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> instance that holds the value
1114
1114
for <em class="parameter"><code>property_name</code></em>
1115
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the value is not in the cache. The
1116
 
returned reference must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
 
1115
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the value is not in the cache. The
 
1116
returned reference must be freed with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
1117
1117
<p></p>
1118
1118
</div>
1119
1119
<p class="since">Since 2.26</p>
1123
1123
<a name="g-dbus-proxy-set-cached-property"></a><h3>g_dbus_proxy_set_cached_property ()</h3>
1124
1124
<pre class="programlisting"><span class="returnvalue">void</span>
1125
1125
g_dbus_proxy_set_cached_property (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1126
 
                                  <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> *property_name</code></em>,
1127
 
                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
 
1126
                                  <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
 
1127
                                  <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1128
1128
<p>If <em class="parameter"><code>value</code></em>
1129
 
 is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, sets the cached value for the property with
 
1129
 is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, sets the cached value for the property with
1130
1130
name <em class="parameter"><code>property_name</code></em>
1131
1131
 to the value in <em class="parameter"><code>value</code></em>
1132
1132
.</p>
1133
1133
<p>If <em class="parameter"><code>value</code></em>
1134
 
 is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the cached value is removed from the
 
1134
 is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the cached value is removed from the
1135
1135
property cache.</p>
1136
1136
<p>If <em class="parameter"><code>proxy</code></em>
1137
1137
 has an expected interface (see
1140
1140
it, then <em class="parameter"><code>value</code></em>
1141
1141
 is checked against the type of the property.</p>
1142
1142
<p>If the <em class="parameter"><code>value</code></em>
1143
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
1144
 
convenient 'inline' use of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.</p>
 
1143
 <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
 
1144
convenient 'inline' use of <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.</p>
1145
1145
<div class="informalexample">
1146
1146
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1147
1147
    <tbody>
1151
1151
3
1152
1152
4
1153
1153
5</pre></td>
1154
 
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-set-cached-property">g_dbus_proxy_set_cached_property</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">proxy</span><span class="symbol">,</span>
1155
 
<span class="normal">                                  </span><span class="string">"SomeProperty"</span><span class="symbol">,</span>
1156
 
<span class="normal">                                  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new">g_variant_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"(si)"</span><span class="symbol">,</span>
1157
 
<span class="normal">                                                </span><span class="string">"A String"</span><span class="symbol">,</span>
1158
 
<span class="normal">                                                </span><span class="number">42</span><span class="symbol">));</span></pre></td>
 
1154
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-set-cached-property">g_dbus_proxy_set_cached_property</a></span> <span class="gtkdoc opt">(</span>proxy<span class="gtkdoc opt">,</span>
 
1155
                                  <span class="string">&quot;SomeProperty&quot;</span><span class="gtkdoc opt">,</span>
 
1156
                                  <span class="function"><a href="../glib/glib-GVariant.html#g-variant-new">g_variant_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;(si)&quot;</span><span class="gtkdoc opt">,</span>
 
1157
                                                <span class="string">&quot;A String&quot;</span><span class="gtkdoc opt">,</span>
 
1158
                                                <span class="number">42</span><span class="gtkdoc opt">));</span></pre></td>
1159
1159
      </tr>
1160
1160
    </tbody>
1161
1161
  </table>
1196
1196
</tr>
1197
1197
<tr>
1198
1198
<td class="parameter_name"><p>value</p></td>
1199
 
<td class="parameter_description"><p> Value for the property or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove it from the cache. </p></td>
 
1199
<td class="parameter_description"><p> Value for the property or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove it from the cache. </p></td>
1200
1200
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1201
1201
</tr>
1202
1202
</tbody>
1207
1207
<hr>
1208
1208
<div class="refsect2">
1209
1209
<a name="g-dbus-proxy-get-cached-property-names"></a><h3>g_dbus_proxy_get_cached_property_names ()</h3>
1210
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
 
1210
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
1211
1211
g_dbus_proxy_get_cached_property_names
1212
1212
                               (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>);</pre>
1213
1213
<p>Gets the names of all cached properties on <em class="parameter"><code>proxy</code></em>
1229
1229
</div>
1230
1230
<div class="refsect3">
1231
1231
<a name="id-1.4.18.6.11.18.6"></a><h4>Returns</h4>
1232
 
<p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
1232
<p> A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
1233
1233
<em class="parameter"><code>proxy</code></em>
1234
1234
has no cached properties. Free the returned array with
1235
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. </p>
 
1235
<a href="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. </p>
1236
1236
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1237
1237
</div>
1238
1238
<p class="since">Since 2.26</p>
1263
1263
</tr>
1264
1264
<tr>
1265
1265
<td class="parameter_name"><p>info</p></td>
1266
 
<td class="parameter_description"><p> Minimum interface this proxy conforms to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
 
1266
<td class="parameter_description"><p> Minimum interface this proxy conforms to or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset. </p></td>
1267
1267
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1268
1268
</tr>
1269
1269
</tbody>
1297
1297
</div>
1298
1298
<div class="refsect3">
1299
1299
<a name="id-1.4.18.6.11.20.6"></a><h4>Returns</h4>
1300
 
<p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Do not unref the returned
 
1300
<p> A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Do not unref the returned
1301
1301
object, it is owned by <em class="parameter"><code>proxy</code></em>
1302
1302
.</p>
1303
1303
<p></p>
1309
1309
<a name="g-dbus-proxy-call"></a><h3>g_dbus_proxy_call ()</h3>
1310
1310
<pre class="programlisting"><span class="returnvalue">void</span>
1311
1311
g_dbus_proxy_call (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1312
 
                   <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> *method_name</code></em>,
1313
 
                   <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
 
1312
                   <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method_name</code></em>,
 
1313
                   <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1314
1314
                   <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCallFlags" title="enum GDBusCallFlags"><span class="type">GDBusCallFlags</span></a> flags</code></em>,
1315
 
                   <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_msec</code></em>,
 
1315
                   <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_msec</code></em>,
1316
1316
                   <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1317
1317
                   <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1318
 
                   <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>
 
1318
                   <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1319
1319
<p>Asynchronously invokes the <em class="parameter"><code>method_name</code></em>
1320
1320
 method on <em class="parameter"><code>proxy</code></em>
1321
1321
.</p>
1335
1335
compatible with the D-Bus protocol, the operation fails with
1336
1336
<a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.</p>
1337
1337
<p>If the <em class="parameter"><code>parameters</code></em>
1338
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
1339
 
convenient 'inline' use of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:</p>
 
1338
 <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
 
1339
convenient 'inline' use of <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:</p>
1340
1340
<div class="informalexample">
1341
1341
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1342
1342
    <tbody>
1351
1351
8
1352
1352
9
1353
1353
10</pre></td>
1354
 
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-call">g_dbus_proxy_call</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">proxy</span><span class="symbol">,</span>
1355
 
<span class="normal">                   </span><span class="string">"TwoStrings"</span><span class="symbol">,</span>
1356
 
<span class="normal">                   </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new">g_variant_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"(ss)"</span><span class="symbol">,</span>
1357
 
<span class="normal">                                  </span><span class="string">"Thing One"</span><span class="symbol">,</span>
1358
 
<span class="normal">                                  </span><span class="string">"Thing Two"</span><span class="symbol">),</span>
1359
 
<span class="normal">                   G_DBUS_CALL_FLAGS_NONE</span><span class="symbol">,</span>
1360
 
<span class="normal">                   </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">,</span>
1361
 
<span class="normal">                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
1362
 
<span class="normal">                   </span><span class="symbol">(</span><span class="normal"><a href="GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a></span><span class="symbol">)</span><span class="normal"> two_strings_done</span><span class="symbol">,</span>
1363
 
<span class="normal">                   </span><span class="symbol">&amp;</span><span class="normal">data</span><span class="symbol">);</span></pre></td>
 
1354
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-call">g_dbus_proxy_call</a></span> <span class="gtkdoc opt">(</span>proxy<span class="gtkdoc opt">,</span>
 
1355
                   <span class="string">&quot;TwoStrings&quot;</span><span class="gtkdoc opt">,</span>
 
1356
                   <span class="function"><a href="../glib/glib-GVariant.html#g-variant-new">g_variant_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;(ss)&quot;</span><span class="gtkdoc opt">,</span>
 
1357
                                  <span class="string">&quot;Thing One&quot;</span><span class="gtkdoc opt">,</span>
 
1358
                                  <span class="string">&quot;Thing Two&quot;</span><span class="gtkdoc opt">),</span>
 
1359
                   G_DBUS_CALL_FLAGS_NONE<span class="gtkdoc opt">,</span>
 
1360
                   <span class="gtkdoc opt">-</span><span class="number">1</span><span class="gtkdoc opt">,</span>
 
1361
                   NULL<span class="gtkdoc opt">,</span>
 
1362
                   <span class="gtkdoc opt">(</span>GAsyncReadyCallback<span class="gtkdoc opt">)</span> two_strings_done<span class="gtkdoc opt">,</span>
 
1363
                   <span class="gtkdoc opt">&amp;</span>data<span class="gtkdoc opt">);</span></pre></td>
1364
1364
      </tr>
1365
1365
    </tbody>
1366
1366
  </table>
1375
1375
<p>This is an asynchronous method. When the operation is finished,
1376
1376
<em class="parameter"><code>callback</code></em>
1377
1377
 will be invoked in the
1378
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
 
1378
<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
1379
1379
of the thread you are calling this method from.
1380
1380
You can then call <a class="link" href="GDBusProxy.html#g-dbus-proxy-call-finish" title="g_dbus_proxy_call_finish ()"><code class="function">g_dbus_proxy_call_finish()</code></a> to get the result of
1381
1381
the operation. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-call-sync" title="g_dbus_proxy_call_sync ()"><code class="function">g_dbus_proxy_call_sync()</code></a> for the synchronous
1382
1382
version of this method.</p>
1383
1383
<p>If <em class="parameter"><code>callback</code></em>
1384
 
 is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the D-Bus method call message will be sent with
 
1384
 is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the D-Bus method call message will be sent with
1385
1385
the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-FLAGS-NO-REPLY-EXPECTED:CAPS"><code class="literal">G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED</code></a> flag set.</p>
1386
1386
<div class="refsect3">
1387
1387
<a name="id-1.4.18.6.11.21.13"></a><h4>Parameters</h4>
1404
1404
</tr>
1405
1405
<tr>
1406
1406
<td class="parameter_name"><p>parameters</p></td>
1407
 
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for 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 not passing parameters. </p></td>
 
1407
<td class="parameter_description"><p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
1408
1408
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1409
1409
</tr>
1410
1410
<tr>
1414
1414
</tr>
1415
1415
<tr>
1416
1416
<td class="parameter_name"><p>timeout_msec</p></td>
1417
 
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
 
1417
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
1418
1418
"infinite") or -1 to use the proxy default timeout.</p></td>
1419
1419
<td class="parameter_annotations"> </td>
1420
1420
</tr>
1421
1421
<tr>
1422
1422
<td class="parameter_name"><p>cancellable</p></td>
1423
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1423
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1424
1424
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1425
1425
</tr>
1426
1426
<tr>
1427
1427
<td class="parameter_name"><p>callback</p></td>
1428
 
<td class="parameter_description"><p> A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't
 
1428
<td class="parameter_description"><p> A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't
1429
1429
care about the result of the method invocation. </p></td>
1430
1430
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1431
1431
</tr>
1443
1443
<hr>
1444
1444
<div class="refsect2">
1445
1445
<a name="g-dbus-proxy-call-finish"></a><h3>g_dbus_proxy_call_finish ()</h3>
1446
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
1446
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1447
1447
g_dbus_proxy_call_finish (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1448
1448
                          <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
1449
 
                          <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>
 
1449
                          <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1450
1450
<p>Finishes an operation started with <a class="link" href="GDBusProxy.html#g-dbus-proxy-call" title="g_dbus_proxy_call ()"><code class="function">g_dbus_proxy_call()</code></a>.</p>
1451
1451
<div class="refsect3">
1452
1452
<a name="id-1.4.18.6.11.22.5"></a><h4>Parameters</h4>
1469
1469
</tr>
1470
1470
<tr>
1471
1471
<td class="parameter_name"><p>error</p></td>
1472
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
1472
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
1473
1473
<td class="parameter_annotations"> </td>
1474
1474
</tr>
1475
1475
</tbody>
1477
1477
</div>
1478
1478
<div class="refsect3">
1479
1479
<a name="id-1.4.18.6.11.22.6"></a><h4>Returns</h4>
1480
 
<p> <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>error</code></em>
1481
 
is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
1482
 
return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
 
1480
<p> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
1481
is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
 
1482
return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
1483
1483
<p></p>
1484
1484
</div>
1485
1485
<p class="since">Since 2.26</p>
1487
1487
<hr>
1488
1488
<div class="refsect2">
1489
1489
<a name="g-dbus-proxy-call-sync"></a><h3>g_dbus_proxy_call_sync ()</h3>
1490
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
1490
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1491
1491
g_dbus_proxy_call_sync (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1492
 
                        <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> *method_name</code></em>,
1493
 
                        <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
 
1492
                        <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method_name</code></em>,
 
1493
                        <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1494
1494
                        <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCallFlags" title="enum GDBusCallFlags"><span class="type">GDBusCallFlags</span></a> flags</code></em>,
1495
 
                        <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_msec</code></em>,
 
1495
                        <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_msec</code></em>,
1496
1496
                        <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1497
 
                        <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>
 
1497
                        <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1498
1498
<p>Synchronously invokes the <em class="parameter"><code>method_name</code></em>
1499
1499
 method on <em class="parameter"><code>proxy</code></em>
1500
1500
.</p>
1514
1514
compatible with the D-Bus protocol, the operation fails with
1515
1515
<a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.</p>
1516
1516
<p>If the <em class="parameter"><code>parameters</code></em>
1517
 
 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
1518
 
convenient 'inline' use of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:</p>
 
1517
 <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> is floating, it is consumed. This allows
 
1518
convenient 'inline' use of <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:</p>
1519
1519
<div class="informalexample">
1520
1520
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1521
1521
    <tbody>
1529
1529
7
1530
1530
8
1531
1531
9</pre></td>
1532
 
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-call-sync">g_dbus_proxy_call_sync</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">proxy</span><span class="symbol">,</span>
1533
 
<span class="normal">                        </span><span class="string">"TwoStrings"</span><span class="symbol">,</span>
1534
 
<span class="normal">                        </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new">g_variant_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"(ss)"</span><span class="symbol">,</span>
1535
 
<span class="normal">                                       </span><span class="string">"Thing One"</span><span class="symbol">,</span>
1536
 
<span class="normal">                                       </span><span class="string">"Thing Two"</span><span class="symbol">),</span>
1537
 
<span class="normal">                        G_DBUS_CALL_FLAGS_NONE</span><span class="symbol">,</span>
1538
 
<span class="normal">                        </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">,</span>
1539
 
<span class="normal">                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
1540
 
<span class="normal">                        </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span></pre></td>
 
1532
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GDBusProxy.html#g-dbus-proxy-call-sync">g_dbus_proxy_call_sync</a></span> <span class="gtkdoc opt">(</span>proxy<span class="gtkdoc opt">,</span>
 
1533
                        <span class="string">&quot;TwoStrings&quot;</span><span class="gtkdoc opt">,</span>
 
1534
                        <span class="function"><a href="../glib/glib-GVariant.html#g-variant-new">g_variant_new</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;(ss)&quot;</span><span class="gtkdoc opt">,</span>
 
1535
                                       <span class="string">&quot;Thing One&quot;</span><span class="gtkdoc opt">,</span>
 
1536
                                       <span class="string">&quot;Thing Two&quot;</span><span class="gtkdoc opt">),</span>
 
1537
                        G_DBUS_CALL_FLAGS_NONE<span class="gtkdoc opt">,</span>
 
1538
                        <span class="gtkdoc opt">-</span><span class="number">1</span><span class="gtkdoc opt">,</span>
 
1539
                        NULL<span class="gtkdoc opt">,</span>
 
1540
                        <span class="gtkdoc opt">&amp;</span>error<span class="gtkdoc opt">);</span></pre></td>
1541
1541
      </tr>
1542
1542
    </tbody>
1543
1543
  </table>
1573
1573
</tr>
1574
1574
<tr>
1575
1575
<td class="parameter_name"><p>parameters</p></td>
1576
 
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal
1577
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
 
1576
<td class="parameter_description"><p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal
 
1577
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
1578
1578
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1579
1579
</tr>
1580
1580
<tr>
1584
1584
</tr>
1585
1585
<tr>
1586
1586
<td class="parameter_name"><p>timeout_msec</p></td>
1587
 
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
 
1587
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
1588
1588
"infinite") or -1 to use the proxy default timeout.</p></td>
1589
1589
<td class="parameter_annotations"> </td>
1590
1590
</tr>
1591
1591
<tr>
1592
1592
<td class="parameter_name"><p>cancellable</p></td>
1593
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1593
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1594
1594
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1595
1595
</tr>
1596
1596
<tr>
1597
1597
<td class="parameter_name"><p>error</p></td>
1598
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
1598
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
1599
1599
<td class="parameter_annotations"> </td>
1600
1600
</tr>
1601
1601
</tbody>
1603
1603
</div>
1604
1604
<div class="refsect3">
1605
1605
<a name="id-1.4.18.6.11.23.13"></a><h4>Returns</h4>
1606
 
<p> <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>error</code></em>
1607
 
is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
1608
 
return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
 
1606
<p> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
1607
is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
 
1608
return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
1609
1609
<p></p>
1610
1610
</div>
1611
1611
<p class="since">Since 2.26</p>
1615
1615
<a name="g-dbus-proxy-call-with-unix-fd-list"></a><h3>g_dbus_proxy_call_with_unix_fd_list ()</h3>
1616
1616
<pre class="programlisting"><span class="returnvalue">void</span>
1617
1617
g_dbus_proxy_call_with_unix_fd_list (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1618
 
                                     <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> *method_name</code></em>,
1619
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
 
1618
                                     <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method_name</code></em>,
 
1619
                                     <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1620
1620
                                     <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCallFlags" title="enum GDBusCallFlags"><span class="type">GDBusCallFlags</span></a> flags</code></em>,
1621
 
                                     <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_msec</code></em>,
 
1621
                                     <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_msec</code></em>,
1622
1622
                                     <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> *fd_list</code></em>,
1623
1623
                                     <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1624
1624
                                     <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1625
 
                                     <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>
 
1625
                                     <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1626
1626
<p>Like <a class="link" href="GDBusProxy.html#g-dbus-proxy-call" title="g_dbus_proxy_call ()"><code class="function">g_dbus_proxy_call()</code></a> but also takes a <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> object.</p>
1627
1627
<p>This method is only available on UNIX.</p>
1628
1628
<div class="refsect3">
1646
1646
</tr>
1647
1647
<tr>
1648
1648
<td class="parameter_name"><p>parameters</p></td>
1649
 
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for 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 not passing parameters. </p></td>
 
1649
<td class="parameter_description"><p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
1650
1650
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1651
1651
</tr>
1652
1652
<tr>
1656
1656
</tr>
1657
1657
<tr>
1658
1658
<td class="parameter_name"><p>timeout_msec</p></td>
1659
 
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
 
1659
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
1660
1660
"infinite") or -1 to use the proxy default timeout.</p></td>
1661
1661
<td class="parameter_annotations"> </td>
1662
1662
</tr>
1663
1663
<tr>
1664
1664
<td class="parameter_name"><p>fd_list</p></td>
1665
 
<td class="parameter_description"><p> A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1665
<td class="parameter_description"><p> A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1666
1666
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1667
1667
</tr>
1668
1668
<tr>
1669
1669
<td class="parameter_name"><p>cancellable</p></td>
1670
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1670
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1671
1671
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1672
1672
</tr>
1673
1673
<tr>
1674
1674
<td class="parameter_name"><p>callback</p></td>
1675
 
<td class="parameter_description"><p> A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't
 
1675
<td class="parameter_description"><p> A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't
1676
1676
care about the result of the method invocation. </p></td>
1677
1677
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1678
1678
</tr>
1690
1690
<hr>
1691
1691
<div class="refsect2">
1692
1692
<a name="g-dbus-proxy-call-with-unix-fd-list-finish"></a><h3>g_dbus_proxy_call_with_unix_fd_list_finish ()</h3>
1693
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
1693
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1694
1694
g_dbus_proxy_call_with_unix_fd_list_finish
1695
1695
                               (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1696
1696
                                <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> **out_fd_list</code></em>,
1697
1697
                                <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
1698
 
                                <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>
 
1698
                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1699
1699
<p>Finishes an operation started with <a class="link" href="GDBusProxy.html#g-dbus-proxy-call-with-unix-fd-list" title="g_dbus_proxy_call_with_unix_fd_list ()"><code class="function">g_dbus_proxy_call_with_unix_fd_list()</code></a>.</p>
1700
1700
<div class="refsect3">
1701
1701
<a name="id-1.4.18.6.11.25.5"></a><h4>Parameters</h4>
1713
1713
</tr>
1714
1714
<tr>
1715
1715
<td class="parameter_name"><p>out_fd_list</p></td>
1716
 
<td class="parameter_description"><p> Return location for a <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1716
<td class="parameter_description"><p> Return location for a <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1717
1717
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1718
1718
</tr>
1719
1719
<tr>
1723
1723
</tr>
1724
1724
<tr>
1725
1725
<td class="parameter_name"><p>error</p></td>
1726
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
1726
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
1727
1727
<td class="parameter_annotations"> </td>
1728
1728
</tr>
1729
1729
</tbody>
1731
1731
</div>
1732
1732
<div class="refsect3">
1733
1733
<a name="id-1.4.18.6.11.25.6"></a><h4>Returns</h4>
1734
 
<p> <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>error</code></em>
1735
 
is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
1736
 
return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
 
1734
<p> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
1735
is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
 
1736
return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
1737
1737
<p></p>
1738
1738
</div>
1739
1739
<p class="since">Since 2.30</p>
1741
1741
<hr>
1742
1742
<div class="refsect2">
1743
1743
<a name="g-dbus-proxy-call-with-unix-fd-list-sync"></a><h3>g_dbus_proxy_call_with_unix_fd_list_sync ()</h3>
1744
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 
1744
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1745
1745
g_dbus_proxy_call_with_unix_fd_list_sync
1746
1746
                               (<em class="parameter"><code><a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy</code></em>,
1747
 
                                <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> *method_name</code></em>,
1748
 
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
 
1747
                                <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method_name</code></em>,
 
1748
                                <em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *parameters</code></em>,
1749
1749
                                <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCallFlags" title="enum GDBusCallFlags"><span class="type">GDBusCallFlags</span></a> flags</code></em>,
1750
 
                                <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_msec</code></em>,
 
1750
                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_msec</code></em>,
1751
1751
                                <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> *fd_list</code></em>,
1752
1752
                                <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> **out_fd_list</code></em>,
1753
1753
                                <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1754
 
                                <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>
 
1754
                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1755
1755
<p>Like <a class="link" href="GDBusProxy.html#g-dbus-proxy-call-sync" title="g_dbus_proxy_call_sync ()"><code class="function">g_dbus_proxy_call_sync()</code></a> but also takes and returns <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> objects.</p>
1756
1756
<p>This method is only available on UNIX.</p>
1757
1757
<div class="refsect3">
1775
1775
</tr>
1776
1776
<tr>
1777
1777
<td class="parameter_name"><p>parameters</p></td>
1778
 
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal
1779
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
 
1778
<td class="parameter_description"><p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal
 
1779
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </p></td>
1780
1780
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1781
1781
</tr>
1782
1782
<tr>
1786
1786
</tr>
1787
1787
<tr>
1788
1788
<td class="parameter_name"><p>timeout_msec</p></td>
1789
 
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
 
1789
<td class="parameter_description"><p>The timeout in milliseconds (with <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> meaning
1790
1790
"infinite") or -1 to use the proxy default timeout.</p></td>
1791
1791
<td class="parameter_annotations"> </td>
1792
1792
</tr>
1793
1793
<tr>
1794
1794
<td class="parameter_name"><p>fd_list</p></td>
1795
 
<td class="parameter_description"><p> A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1795
<td class="parameter_description"><p> A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1796
1796
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1797
1797
</tr>
1798
1798
<tr>
1799
1799
<td class="parameter_name"><p>out_fd_list</p></td>
1800
 
<td class="parameter_description"><p> Return location for a <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1800
<td class="parameter_description"><p> Return location for a <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1801
1801
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1802
1802
</tr>
1803
1803
<tr>
1804
1804
<td class="parameter_name"><p>cancellable</p></td>
1805
 
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
1805
<td class="parameter_description"><p> A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1806
1806
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1807
1807
</tr>
1808
1808
<tr>
1809
1809
<td class="parameter_name"><p>error</p></td>
1810
 
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
 
1810
<td class="parameter_description"><p>Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
1811
1811
<td class="parameter_annotations"> </td>
1812
1812
</tr>
1813
1813
</tbody>
1815
1815
</div>
1816
1816
<div class="refsect3">
1817
1817
<a name="id-1.4.18.6.11.26.7"></a><h4>Returns</h4>
1818
 
<p> <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>error</code></em>
1819
 
is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
1820
 
return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
 
1818
<p> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
 
1819
is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with
 
1820
return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</p>
1821
1821
<p></p>
1822
1822
</div>
1823
1823
<p class="since">Since 2.30</p>
1943
1943
<a name="GDBusProxy--g-bus-type"></a><h3>The <code class="literal">“g-bus-type”</code> property</h3>
1944
1944
<pre class="programlisting">  “g-bus-type”               <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a></pre>
1945
1945
<p>If this property is not <a class="link" href="GDBusConnection.html#G-BUS-TYPE-NONE:CAPS"><code class="literal">G_BUS_TYPE_NONE</code></a>, then
1946
 
<a class="link" href="GDBusProxy.html#GDBusProxy--g-connection" title="The “g-connection” property"><span class="type">“g-connection”</span></a> must be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and will be set to the
 
1946
<a class="link" href="GDBusProxy.html#GDBusProxy--g-connection" title="The “g-connection” property"><span class="type">“g-connection”</span></a> must be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and will be set to the
1947
1947
<a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> obtained by calling <a class="link" href="GDBusConnection.html#g-bus-get" title="g_bus_get ()"><code class="function">g_bus_get()</code></a> with the value
1948
1948
of this property.</p>
1949
1949
<p>Flags: Write / Construct Only</p>
1961
1961
<hr>
1962
1962
<div class="refsect2">
1963
1963
<a name="GDBusProxy--g-default-timeout"></a><h3>The <code class="literal">“g-default-timeout”</code> property</h3>
1964
 
<pre class="programlisting">  “g-default-timeout”        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
 
1964
<pre class="programlisting">  “g-default-timeout”        <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
1965
1965
<p>The timeout to use if -1 (specifying default timeout) is passed
1966
1966
as <em class="parameter"><code>timeout_msec</code></em>
1967
1967
 in the <a class="link" href="GDBusProxy.html#g-dbus-proxy-call" title="g_dbus_proxy_call ()"><code class="function">g_dbus_proxy_call()</code></a> and
1969
1969
<p>This allows applications to set a proxy-wide timeout for all
1970
1970
remote method invocations on the proxy. If this property is -1,
1971
1971
the default timeout (typically 25 seconds) is used. If set to
1972
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>, then no timeout is used.</p>
 
1972
<a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>, then no timeout is used.</p>
1973
1973
<p>Flags: Read / Write / Construct</p>
1974
1974
<p>Allowed values: &gt;= -1</p>
1975
1975
<p>Default value: -1</p>
1995
1995
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
1996
1996
<li class="listitem"><p>When completing a method call, if the type signature of
1997
1997
the reply message isn't what's expected, the reply is
1998
 
discarded and the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> is set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.</p></li>
 
1998
discarded and the <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> is set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.</p></li>
1999
1999
<li class="listitem"><p>Received signals that have a type signature mismatch are dropped and
2000
 
a warning is logged via <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a>.</p></li>
 
2000
a warning is logged via <a href="../glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a>.</p></li>
2001
2001
<li class="listitem"><p>Properties received via the initial <code class="literal"><code class="function">GetAll()</code></code> call or via the
2002
2002
 
2003
2003
<code class="literal">::PropertiesChanged</code> signal (on the
2004
2004
<a class="ulink" href="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties" target="_top">org.freedesktop.DBus.Properties</a>
2005
2005
interface) or set using <a class="link" href="GDBusProxy.html#g-dbus-proxy-set-cached-property" title="g_dbus_proxy_set_cached_property ()"><code class="function">g_dbus_proxy_set_cached_property()</code></a>
2006
2006
with a type signature mismatch are ignored and a warning is
2007
 
logged via <a href="http://library.gnome.org/devel/glib/unstable/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a>.</p></li>
 
2007
logged via <a href="../glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a>.</p></li>
2008
2008
</ul></div>
2009
2009
<p>Note that these checks are never done on methods, signals and
2010
2010
properties that are not referenced in the given
2016
2016
<hr>
2017
2017
<div class="refsect2">
2018
2018
<a name="GDBusProxy--g-interface-name"></a><h3>The <code class="literal">“g-interface-name”</code> property</h3>
2019
 
<pre class="programlisting">  “g-interface-name”         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
2019
<pre class="programlisting">  “g-interface-name”         <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
2020
2020
<p>The D-Bus interface name the proxy is for.</p>
2021
2021
<p>Flags: Read / Write / Construct Only</p>
2022
2022
<p>Default value: NULL</p>
2025
2025
<hr>
2026
2026
<div class="refsect2">
2027
2027
<a name="GDBusProxy--g-name"></a><h3>The <code class="literal">“g-name”</code> property</h3>
2028
 
<pre class="programlisting">  “g-name”                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
2028
<pre class="programlisting">  “g-name”                   <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
2029
2029
<p>The well-known or unique name that the proxy is for.</p>
2030
2030
<p>Flags: Read / Write / Construct Only</p>
2031
2031
<p>Default value: NULL</p>
2034
2034
<hr>
2035
2035
<div class="refsect2">
2036
2036
<a name="GDBusProxy--g-name-owner"></a><h3>The <code class="literal">“g-name-owner”</code> property</h3>
2037
 
<pre class="programlisting">  “g-name-owner”             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
2038
 
<p>The unique name that owns <a class="link" href="GDBusProxy.html#GDBusProxy--g-name" title="The “g-name” property"><span class="type">“g-name”</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no-one
2039
 
currently owns that name. You may connect to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to
 
2037
<pre class="programlisting">  “g-name-owner”             <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
2038
<p>The unique name that owns <a class="link" href="GDBusProxy.html#GDBusProxy--g-name" title="The “g-name” property"><span class="type">“g-name”</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no-one
 
2039
currently owns that name. You may connect to <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to
2040
2040
track changes to this property.</p>
2041
2041
<p>Flags: Read</p>
2042
2042
<p>Default value: NULL</p>
2045
2045
<hr>
2046
2046
<div class="refsect2">
2047
2047
<a name="GDBusProxy--g-object-path"></a><h3>The <code class="literal">“g-object-path”</code> property</h3>
2048
 
<pre class="programlisting">  “g-object-path”            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
2048
<pre class="programlisting">  “g-object-path”            <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
2049
2049
<p>The object path the proxy is for.</p>
2050
2050
<p>Flags: Read / Write / Construct Only</p>
2051
2051
<p>Default value: NULL</p>
2058
2058
<a name="GDBusProxy-g-properties-changed"></a><h3>The <code class="literal">“g-properties-changed”</code> signal</h3>
2059
2059
<pre class="programlisting"><span class="returnvalue">void</span>
2060
2060
user_function (<a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy,
2061
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>   *changed_properties,
2062
 
               <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>       invalidated_properties,
2063
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)</pre>
 
2061
               <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>   *changed_properties,
 
2062
               <a href="../gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>       invalidated_properties,
 
2063
               <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)</pre>
2064
2064
<p>Emitted when one or more D-Bus properties on <em class="parameter"><code>proxy</code></em>
2065
2065
 changes. The
2066
2066
local cache has already been updated when this signal fires. Note
2067
2067
that both <em class="parameter"><code>changed_properties</code></em>
2068
2068
 and <em class="parameter"><code>invalidated_properties</code></em>
2069
2069
 are
2070
 
guaranteed to never be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (either may be empty though).</p>
 
2070
guaranteed to never be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (either may be empty though).</p>
2071
2071
<p>If the proxy has the flag
2072
2072
<a class="link" href="GDBusProxy.html#G-DBUS-PROXY-FLAGS-GET-INVALIDATED-PROPERTIES:CAPS"><code class="literal">G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES</code></a> set, then
2073
2073
<em class="parameter"><code>invalidated_properties</code></em>
2091
2091
</tr>
2092
2092
<tr>
2093
2093
<td class="parameter_name"><p>changed_properties</p></td>
2094
 
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing the properties that changed</p></td>
 
2094
<td class="parameter_description"><p>A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing the properties that changed</p></td>
2095
2095
<td class="parameter_annotations"> </td>
2096
2096
</tr>
2097
2097
<tr>
2098
2098
<td class="parameter_name"><p>invalidated_properties</p></td>
2099
 
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated array of properties that was invalidated</p></td>
 
2099
<td class="parameter_description"><p>A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated array of properties that was invalidated</p></td>
2100
2100
<td class="parameter_annotations"> </td>
2101
2101
</tr>
2102
2102
<tr>
2115
2115
<a name="GDBusProxy-g-signal"></a><h3>The <code class="literal">“g-signal”</code> signal</h3>
2116
2116
<pre class="programlisting"><span class="returnvalue">void</span>
2117
2117
user_function (<a class="link" href="GDBusProxy.html" title="GDBusProxy"><span class="type">GDBusProxy</span></a> *proxy,
2118
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>      *sender_name,
2119
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>      *signal_name,
2120
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>   *parameters,
2121
 
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)</pre>
 
2118
               <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>      *sender_name,
 
2119
               <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>      *signal_name,
 
2120
               <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>   *parameters,
 
2121
               <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)</pre>
2122
2122
<p>Emitted when a signal from the remote object and interface that <em class="parameter"><code>proxy</code></em>
2123
2123
 is for, has been received.</p>
2124
2124
<div class="refsect3">
2137
2137
</tr>
2138
2138
<tr>
2139
2139
<td class="parameter_name"><p>sender_name</p></td>
2140
 
<td class="parameter_description"><p> The sender of 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 connection is not a bus connection. </p></td>
 
2140
<td class="parameter_description"><p> The sender of the signal or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the connection is not a bus connection. </p></td>
2141
2141
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2142
2142
</tr>
2143
2143
<tr>
2147
2147
</tr>
2148
2148
<tr>
2149
2149
<td class="parameter_name"><p>parameters</p></td>
2150
 
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal.</p></td>
 
2150
<td class="parameter_description"><p>A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> tuple with parameters for the signal.</p></td>
2151
2151
<td class="parameter_annotations"> </td>
2152
2152
</tr>
2153
2153
<tr>