~ubuntu-branches/ubuntu/oneiric/dbus-glib/oneiric-updates

« back to all changes in this revision

Viewing changes to doc/reference/html/dbus-glib-DBusGProxy.html

  • Committer: Bazaar Package Importer
  • Author(s): Michael Biebl
  • Date: 2009-09-29 23:49:03 UTC
  • mfrom: (1.1.7 upstream) (2.1.6 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090929234903-oaprxcpac2lvd9hs
Tags: 0.82-2
* debian/patches/10_support_duplicate_object_registrations.patch
  - Pull patch from upstream git which allows duplicate object registrations
    and fixes a regression introduced in 0.82.
    (Closes: #540421, #541712, #542513, #544174, #546044)
* Bump Standards-Version to 3.8.3. No further changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>DBusGProxy</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
7
7
<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual">
8
8
<link rel="up" href="ch02.html" title="API Reference">
9
9
<link rel="prev" href="dbus-glib-DBusGError.html" title="DBusGError">
10
10
<link rel="next" href="dbus-glib-Specializable-GType-System.html" title="Specializable GType System">
11
 
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Introduction">
14
14
<link rel="chapter" href="ch02.html" title="API Reference">
23
23
<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th>
24
24
<td><a accesskey="n" href="dbus-glib-Specializable-GType-System.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
25
25
</tr>
26
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#dbus-glib-DBusGProxy.synopsis" class="shortcut">Top</a>
27
 
                   | 
28
 
                  <a href="#dbus-glib-DBusGProxy.description" class="shortcut">Description</a></nobr></td></tr>
 
26
<tr><td colspan="5" class="shortcuts">
 
27
<a href="#dbus-glib-DBusGProxy.synopsis" class="shortcut">Top</a>
 
28
                 | 
 
29
                <a href="#dbus-glib-DBusGProxy.description" class="shortcut">Description</a>
 
30
</td></tr>
29
31
</table>
30
32
<div class="refentry" lang="en">
31
33
<a name="dbus-glib-DBusGProxy"></a><div class="titlepage"></div>
53
55
                                                         const char *path,
54
56
                                                         const char *interface,
55
57
                                                         <a
56
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
58
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
57
59
>GError</a> **error);
58
60
<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a>*         <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-from-proxy" title="dbus_g_proxy_new_from_proxy ()">dbus_g_proxy_new_from_proxy</a>         (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
59
61
                                                         const char *interface,
69
71
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-add-signal" title="dbus_g_proxy_add_signal ()">dbus_g_proxy_add_signal</a>             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
70
72
                                                         const char *signal_name,
71
73
                                                         <a
72
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
74
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
73
75
>GType</a> first_type,
74
76
                                                         ...);
75
77
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-connect-signal" title="dbus_g_proxy_connect_signal ()">dbus_g_proxy_connect_signal</a>         (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
76
78
                                                         const char *signal_name,
77
79
                                                         <a
78
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
 
80
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"
79
81
>GCallback</a> handler,
80
82
                                                         void *data,
81
83
                                                         <a
82
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureNotify"
 
84
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureNotify"
83
85
>GClosureNotify</a> free_data_func);
84
86
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-disconnect-signal" title="dbus_g_proxy_disconnect_signal ()">dbus_g_proxy_disconnect_signal</a>      (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
85
87
                                                         const char *signal_name,
86
88
                                                         <a
87
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
 
89
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"
88
90
>GCallback</a> handler,
89
91
                                                         void *data);
90
92
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-send" title="dbus_g_proxy_send ()">dbus_g_proxy_send</a>                   (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
91
93
                                                         DBusMessage *message,
92
94
                                                         dbus_uint32_t *client_serial);
93
95
<a
94
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
96
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
95
97
>gboolean</a>            <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call" title="dbus_g_proxy_call ()">dbus_g_proxy_call</a>                   (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
96
98
                                                         const char *method,
97
99
                                                         <a
98
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
100
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
99
101
>GError</a> **error,
100
102
                                                         <a
101
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
103
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
102
104
>GType</a> first_arg_type,
103
105
                                                         ...);
104
106
<a
105
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
107
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
106
108
>gboolean</a>            <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-with-timeout" title="dbus_g_proxy_call_with_timeout ()">dbus_g_proxy_call_with_timeout</a>      (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
107
109
                                                         const char *method,
108
110
                                                         int timeout,
109
111
                                                         <a
110
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
112
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
111
113
>GError</a> **error,
112
114
                                                         <a
113
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
115
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
114
116
>GType</a> first_arg_type,
115
117
                                                         ...);
116
118
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-call-no-reply" title="dbus_g_proxy_call_no_reply ()">dbus_g_proxy_call_no_reply</a>          (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
117
119
                                                         const char *method,
118
120
                                                         <a
119
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
121
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
120
122
>GType</a> first_arg_type,
121
123
                                                         ...);
122
 
DBusGProxyCall*     <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()">dbus_g_proxy_begin_call</a>             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
 
124
DBusGProxyCall *    <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call" title="dbus_g_proxy_begin_call ()">dbus_g_proxy_begin_call</a>             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
123
125
                                                         const char *method,
124
126
                                                         DBusGProxyCallNotify notify,
125
127
                                                         <a
126
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
128
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
127
129
>gpointer</a> data,
128
130
                                                         <a
129
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
131
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
130
132
>GDestroyNotify</a> destroy,
131
133
                                                         <a
132
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
134
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
133
135
>GType</a> first_arg_type,
134
136
                                                         ...);
135
 
DBusGProxyCall*     <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call-with-timeout" title="dbus_g_proxy_begin_call_with_timeout ()">dbus_g_proxy_begin_call_with_timeout</a>
 
137
DBusGProxyCall *    <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-begin-call-with-timeout" title="dbus_g_proxy_begin_call_with_timeout ()">dbus_g_proxy_begin_call_with_timeout</a>
136
138
                                                        (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
137
139
                                                         const char *method,
138
140
                                                         DBusGProxyCallNotify notify,
139
141
                                                         <a
140
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
142
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
141
143
>gpointer</a> user_data,
142
144
                                                         <a
143
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
145
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
144
146
>GDestroyNotify</a> destroy,
145
147
                                                         int timeout,
146
148
                                                         <a
147
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
149
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
148
150
>GType</a> first_arg_type,
149
151
                                                         ...);
150
152
<a
151
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
153
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
152
154
>gboolean</a>            <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-end-call" title="dbus_g_proxy_end_call ()">dbus_g_proxy_end_call</a>               (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
153
155
                                                         DBusGProxyCall *call,
154
156
                                                         <a
155
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
157
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
156
158
>GError</a> **error,
157
159
                                                         <a
158
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
160
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
159
161
>GType</a> first_arg_type,
160
162
                                                         ...);
161
163
void                <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-cancel-call" title="dbus_g_proxy_cancel_call ()">dbus_g_proxy_cancel_call</a>            (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
169
171
<p>
170
172
A <a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy"><span class="type">DBusGProxy</span></a> is a boxed type abstracting a <span class="type">DBusProxy</span>.</p>
171
173
<p>
172
 
 
173
174
</p>
174
175
</div>
175
176
<div class="refsect1" lang="en">
181
182
} DBusGProxy;
182
183
</pre>
183
184
<p>
184
 
 
185
185
</p>
186
186
</div>
187
187
<hr>
213
213
disappears. If a well-known name changes owner, the proxy will
214
214
still be alive.</p>
215
215
<p>
216
 
 
217
216
</p>
218
217
<div class="variablelist"><table border="0">
219
218
<col align="left" valign="top">
254
253
                                                         const char *path,
255
254
                                                         const char *interface,
256
255
                                                         <a
257
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
256
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
258
257
>GError</a> **error);</pre>
259
258
<p>
260
259
Similar to <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a>, but makes a round-trip
273
272
<a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a> will bind to the unique name
274
273
of that owner rather than the generic name.</p>
275
274
<p>
276
 
 
277
275
</p>
278
276
<div class="variablelist"><table border="0">
279
277
<col align="left" valign="top">
306
304
<tr>
307
305
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
308
306
<td> new proxy object, or <a
309
 
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
307
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
310
308
><span class="type">NULL</span></a> on error
311
309
</td>
312
310
</tr>
323
321
Creates a proxy using an existing proxy as a template, substituting
324
322
the specified interface and path.  Either or both may be NULL.</p>
325
323
<p>
326
 
 
327
324
</p>
328
325
<div class="variablelist"><table border="0">
329
326
<col align="left" valign="top">
364
361
we're doing a simple 1-to-1 communication between two
365
362
applications.</p>
366
363
<p>
367
 
 
368
364
</p>
369
365
<div class="variablelist"><table border="0">
370
366
<col align="left" valign="top">
400
396
<p>
401
397
Sets the object interface proxy is bound to</p>
402
398
<p>
403
 
 
404
399
</p>
405
400
<div class="variablelist"><table border="0">
406
401
<col align="left" valign="top">
425
420
<p>
426
421
</p>
427
422
<p>
428
 
 
429
423
</p>
430
424
<div class="variablelist"><table border="0">
431
425
<col align="left" valign="top">
449
443
<pre class="programlisting">const char*         dbus_g_proxy_get_bus_name           (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy);</pre>
450
444
<p>
451
445
Gets the bus name a proxy is bound to (may be <a
452
 
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
446
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
453
447
><span class="type">NULL</span></a> in some cases).
454
448
If you created the proxy with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name" title="dbus_g_proxy_new_for_name ()"><code class="function">dbus_g_proxy_new_for_name()</code></a>, then
455
449
the name you passed to that will be returned.
456
450
If you created it with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-name-owner" title="dbus_g_proxy_new_for_name_owner ()"><code class="function">dbus_g_proxy_new_for_name_owner()</code></a>, then the
457
451
unique connection name will be returned. If you created it
458
452
with <a class="link" href="dbus-glib-DBusGProxy.html#dbus-g-proxy-new-for-peer" title="dbus_g_proxy_new_for_peer ()"><code class="function">dbus_g_proxy_new_for_peer()</code></a> then <a
459
 
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
453
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
460
454
><span class="type">NULL</span></a> will be returned.</p>
461
455
<p>
462
 
 
463
456
</p>
464
457
<div class="variablelist"><table border="0">
465
458
<col align="left" valign="top">
483
476
<pre class="programlisting">const char*         dbus_g_proxy_get_interface          (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy);</pre>
484
477
<p>
485
478
Gets the object interface proxy is bound to (may be <a
486
 
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
479
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
487
480
><span class="type">NULL</span></a> in some cases).</p>
488
481
<p>
489
 
 
490
482
</p>
491
483
<div class="variablelist"><table border="0">
492
484
<col align="left" valign="top">
510
502
<pre class="programlisting">void                dbus_g_proxy_add_signal             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
511
503
                                                         const char *signal_name,
512
504
                                                         <a
513
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
505
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
514
506
>GType</a> first_type,
515
507
                                                         ...);</pre>
516
508
<p>
518
510
if the remote object does not support introspection.  The arguments
519
511
specified are the GLib types expected.</p>
520
512
<p>
521
 
 
522
513
</p>
523
514
<div class="variablelist"><table border="0">
524
515
<col align="left" valign="top">
541
532
<tr>
542
533
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
543
534
<td>
544
 
 
545
 
 
546
535
</td>
547
536
</tr>
548
537
</tbody>
554
543
<pre class="programlisting">void                dbus_g_proxy_connect_signal         (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
555
544
                                                         const char *signal_name,
556
545
                                                         <a
557
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
 
546
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"
558
547
>GCallback</a> handler,
559
548
                                                         void *data,
560
549
                                                         <a
561
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureNotify"
 
550
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureNotify"
562
551
>GClosureNotify</a> free_data_func);</pre>
563
552
<p>
564
553
Connect a signal handler to a proxy for a remote interface.  When
565
554
the remote interface emits the specified signal, the proxy will
566
555
emit a corresponding GLib signal.</p>
567
556
<p>
568
 
 
569
557
</p>
570
558
<div class="variablelist"><table border="0">
571
559
<col align="left" valign="top">
604
592
<pre class="programlisting">void                dbus_g_proxy_disconnect_signal      (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
605
593
                                                         const char *signal_name,
606
594
                                                         <a
607
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
 
595
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"
608
596
>GCallback</a> handler,
609
597
                                                         void *data);</pre>
610
598
<p>
611
599
Disconnect all signal handlers from a proxy that match the given
612
600
criteria.</p>
613
601
<p>
614
 
 
615
602
</p>
616
603
<div class="variablelist"><table border="0">
617
604
<col align="left" valign="top">
662
649
This function adds a reference to the message, so the caller
663
650
still owns its original reference.</p>
664
651
<p>
665
 
 
666
652
</p>
667
653
<div class="variablelist"><table border="0">
668
654
<col align="left" valign="top">
680
666
<tr>
681
667
<td><p><span class="term"><em class="parameter"><code>client_serial</code></em> :</span></p></td>
682
668
<td> return location for message's serial, or <a
683
 
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
669
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
684
670
><span class="type">NULL</span></a> 
685
671
</td>
686
672
</tr>
691
677
<div class="refsect2" lang="en">
692
678
<a name="dbus-g-proxy-call"></a><h3>dbus_g_proxy_call ()</h3>
693
679
<pre class="programlisting"><a
694
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
680
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
695
681
>gboolean</a>            dbus_g_proxy_call                   (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
696
682
                                                         const char *method,
697
683
                                                         <a
698
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
684
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
699
685
>GError</a> **error,
700
686
                                                         <a
701
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
687
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
702
688
>GType</a> first_arg_type,
703
689
                                                         ...);</pre>
704
690
<p>
709
695
output values, followed by a second G_TYPE_INVALID.  Note that  
710
696
this means you must always specify G_TYPE_INVALID twice.</p>
711
697
<p>
712
 
 
713
698
</p>
714
699
<div class="variablelist"><table border="0">
715
700
<col align="left" valign="top">
741
726
</tr>
742
727
<tr>
743
728
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
744
 
<td> <span class="type">FALSE</span> if an error is set, <span class="type">TRUE</span> otherwise.
 
729
<td> <a
 
730
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 
731
><span class="type">FALSE</span></a> if an error is set, <a
 
732
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 
733
><span class="type">TRUE</span></a> otherwise.
745
734
</td>
746
735
</tr>
747
736
</tbody>
751
740
<div class="refsect2" lang="en">
752
741
<a name="dbus-g-proxy-call-with-timeout"></a><h3>dbus_g_proxy_call_with_timeout ()</h3>
753
742
<pre class="programlisting"><a
754
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
743
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
755
744
>gboolean</a>            dbus_g_proxy_call_with_timeout      (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
756
745
                                                         const char *method,
757
746
                                                         int timeout,
758
747
                                                         <a
759
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
748
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
760
749
>GError</a> **error,
761
750
                                                         <a
762
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
751
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
763
752
>GType</a> first_arg_type,
764
753
                                                         ...);</pre>
765
754
<p>
770
759
output values, followed by a second G_TYPE_INVALID.  Note that
771
760
this means you must always specify G_TYPE_INVALID twice.</p>
772
761
<p>
773
 
 
774
762
</p>
775
763
<div class="variablelist"><table border="0">
776
764
<col align="left" valign="top">
807
795
</tr>
808
796
<tr>
809
797
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
810
 
<td> <span class="type">FALSE</span> if an error is set, <span class="type">TRUE</span> otherwise.
 
798
<td> <a
 
799
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 
800
><span class="type">FALSE</span></a> if an error is set, <a
 
801
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 
802
><span class="type">TRUE</span></a> otherwise.
811
803
</td>
812
804
</tr>
813
805
</tbody>
819
811
<pre class="programlisting">void                dbus_g_proxy_call_no_reply          (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
820
812
                                                         const char *method,
821
813
                                                         <a
822
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
814
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
823
815
>GType</a> first_arg_type,
824
816
                                                         ...);</pre>
825
817
<p>
830
822
TODO: this particular function shouldn't die on out of memory,
831
823
since you should be able to do a call with large arguments.</p>
832
824
<p>
833
 
 
834
825
</p>
835
826
<div class="variablelist"><table border="0">
836
827
<col align="left" valign="top">
853
844
<tr>
854
845
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
855
846
<td>
856
 
 
857
 
 
858
847
</td>
859
848
</tr>
860
849
</tbody>
863
852
<hr>
864
853
<div class="refsect2" lang="en">
865
854
<a name="dbus-g-proxy-begin-call"></a><h3>dbus_g_proxy_begin_call ()</h3>
866
 
<pre class="programlisting">DBusGProxyCall*     dbus_g_proxy_begin_call             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
 
855
<pre class="programlisting">DBusGProxyCall *    dbus_g_proxy_begin_call             (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
867
856
                                                         const char *method,
868
857
                                                         DBusGProxyCallNotify notify,
869
858
                                                         <a
870
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
859
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
871
860
>gpointer</a> data,
872
861
                                                         <a
873
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
862
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
874
863
>GDestroyNotify</a> destroy,
875
864
                                                         <a
876
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
865
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
877
866
>GType</a> first_arg_type,
878
867
                                                         ...);</pre>
879
868
<p>
889
878
TODO this particular function shouldn't die on out of memory,
890
879
since you should be able to do a call with large arguments.</p>
891
880
<p>
892
 
 
893
881
</p>
894
882
<div class="variablelist"><table border="0">
895
883
<col align="left" valign="top">
940
928
<hr>
941
929
<div class="refsect2" lang="en">
942
930
<a name="dbus-g-proxy-begin-call-with-timeout"></a><h3>dbus_g_proxy_begin_call_with_timeout ()</h3>
943
 
<pre class="programlisting">DBusGProxyCall*     dbus_g_proxy_begin_call_with_timeout
 
931
<pre class="programlisting">DBusGProxyCall *    dbus_g_proxy_begin_call_with_timeout
944
932
                                                        (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
945
933
                                                         const char *method,
946
934
                                                         DBusGProxyCallNotify notify,
947
935
                                                         <a
948
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
 
936
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
949
937
>gpointer</a> user_data,
950
938
                                                         <a
951
 
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
 
939
href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"
952
940
>GDestroyNotify</a> destroy,
953
941
                                                         int timeout,
954
942
                                                         <a
955
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
943
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
956
944
>GType</a> first_arg_type,
957
945
                                                         ...);</pre>
958
946
<p>
968
956
TODO this particular function shouldn't die on out of memory,
969
957
since you should be able to do a call with large arguments.</p>
970
958
<p>
971
 
 
972
959
</p>
973
960
<div class="variablelist"><table border="0">
974
961
<col align="left" valign="top">
1025
1012
<div class="refsect2" lang="en">
1026
1013
<a name="dbus-g-proxy-end-call"></a><h3>dbus_g_proxy_end_call ()</h3>
1027
1014
<pre class="programlisting"><a
1028
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
1015
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1029
1016
>gboolean</a>            dbus_g_proxy_end_call               (<a class="link" href="dbus-glib-DBusGProxy.html#DBusGProxy" title="DBusGProxy">DBusGProxy</a> *proxy,
1030
1017
                                                         DBusGProxyCall *call,
1031
1018
                                                         <a
1032
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
 
1019
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1033
1020
>GError</a> **error,
1034
1021
                                                         <a
1035
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
1022
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
1036
1023
>GType</a> first_arg_type,
1037
1024
                                                         ...);</pre>
1038
1025
<p>
1044
1031
</p>
1045
1032
<p>
1046
1033
If the call results in an error, the error is set as normal for
1047
 
GError and the function returns <span class="type">FALSE</span>.
 
1034
GError and the function returns <a
 
1035
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 
1036
><span class="type">FALSE</span></a>.
1048
1037
</p>
1049
1038
<p>
1050
1039
Otherwise, the "out" parameters and return value of the
1051
1040
method are stored in the provided varargs list.
1052
1041
The list should be terminated with G_TYPE_INVALID.</p>
1053
1042
<p>
1054
 
 
1055
1043
</p>
1056
1044
<div class="variablelist"><table border="0">
1057
1045
<col align="left" valign="top">
1083
1071
</tr>
1084
1072
<tr>
1085
1073
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1086
 
<td> <span class="type">FALSE</span> if an error is set.
 
1074
<td> <a
 
1075
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 
1076
><span class="type">FALSE</span></a> if an error is set.
1087
1077
</td>
1088
1078
</tr>
1089
1079
</tbody>
1100
1090
may not be used on pending calls that have already been
1101
1091
ended with dbus_g_proxy_end_call.</p>
1102
1092
<p>
1103
 
 
1104
1093
</p>
1105
1094
<div class="variablelist"><table border="0">
1106
1095
<col align="left" valign="top">
1135
1124
(e.g. immediately) and emits a signal when the operation terminates
1136
1125
(though beware of leaking information with/in the signal return value).</p>
1137
1126
<p>
1138
 
 
1139
1127
</p>
1140
1128
<div class="variablelist"><table border="0">
1141
1129
<col align="left" valign="top">
1152
1140
</tr>
1153
1141
</tbody>
1154
1142
</table></div>
1155
 
<p class="since">Since  0.75
1156
 
</p>
 
1143
<p class="since">Since 0.75</p>
1157
1144
</div>
1158
1145
</div>
1159
1146
<div class="refsect1" lang="en">
1160
1147
<a name="dbus-glib-DBusGProxy.see-also"></a><h2>See Also</h2>
1161
 
<span class="type">DBusProxy</span>
 
1148
#DBusProxy
1162
1149
</div>
1163
1150
</div>
1164
1151
<div class="footer">
1165
1152
<hr>
1166
 
          Generated by GTK-Doc V1.10</div>
 
1153
          Generated by GTK-Doc V1.11</div>
1167
1154
</body>
1168
1155
</html>