~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed
» Revision
203
: docs/reference/gio/html/GDBusMessage.html
« back to all changes in this revision
Viewing changes to docs/reference/gio/html/GDBusMessage.html
- browse files at revision 203
- compare with another revision
- download diff
- download tarball
- view history from revision 203
- Committer: Package Import Robot
- Author(s): Andreas Henriksson
- Date: 2014-03-24 20:58:34 UTC
- mfrom: (1.66.13)
- Revision ID: package-import@ubuntu.com-20140324205834-8hsgok8k36ftocqa
Tags: 2.40.0-1
New upstream release.
- files modified:
- .pc/07_disable_tests_on_slow_archs.patch/gio/tests/socket.c
added
removed
docs/reference/gio/html/GDBusMessage.html
99
99
</tr>
100
100
<tr>
101
101
<td class="function_type">
102
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
103
103
</td>
104
104
<td class="function_name">
105
105
<a class="link" href="GDBusMessage.html#g-dbus-message-print" title="g_dbus_message_print ()">g_dbus_message_print</a> <span class="c_punctuation">()</span>
107
107
</tr>
108
108
<tr>
109
109
<td class="function_type">
110
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
111
111
</td>
112
112
<td class="function_name">
113
113
<a class="link" href="GDBusMessage.html#g-dbus-message-get-locked" title="g_dbus_message_get_locked ()">g_dbus_message_get_locked</a> <span class="c_punctuation">()</span>
163
163
</tr>
164
164
<tr>
165
165
<td class="function_type">
166
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
166
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
167
167
</td>
168
168
<td class="function_name">
169
169
<a class="link" href="GDBusMessage.html#g-dbus-message-get-serial" title="g_dbus_message_get_serial ()">g_dbus_message_get_serial</a> <span class="c_punctuation">()</span>
195
195
</tr>
196
196
<tr>
197
197
<td class="function_type">
198
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
198
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
199
199
</td>
200
200
<td class="function_name">
201
201
<a class="link" href="GDBusMessage.html#g-dbus-message-get-body" title="g_dbus_message_get_body ()">g_dbus_message_get_body</a> <span class="c_punctuation">()</span>
227
227
</tr>
228
228
<tr>
229
229
<td class="function_type">
230
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
230
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
231
231
</td>
232
232
<td class="function_name">
233
233
<a class="link" href="GDBusMessage.html#g-dbus-message-get-num-unix-fds" title="g_dbus_message_get_num_unix_fds ()">g_dbus_message_get_num_unix_fds</a> <span class="c_punctuation">()</span>
243
243
</tr>
244
244
<tr>
245
245
<td class="function_type">
246
<a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
246
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
247
247
</td>
248
248
<td class="function_name">
249
249
<a class="link" href="GDBusMessage.html#g-dbus-message-get-header-fields" title="g_dbus_message_get_header_fields ()">g_dbus_message_get_header_fields</a> <span class="c_punctuation">()</span>
251
251
</tr>
252
252
<tr>
253
253
<td class="function_type">
254
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
254
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
255
255
</td>
256
256
<td class="function_name">
257
257
<a class="link" href="GDBusMessage.html#g-dbus-message-get-header" title="g_dbus_message_get_header ()">g_dbus_message_get_header</a> <span class="c_punctuation">()</span>
266
266
</td>
267
267
</tr>
268
268
<tr>
269
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
269
<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> *
270
270
</td>
271
271
<td class="function_name">
272
272
<a class="link" href="GDBusMessage.html#g-dbus-message-get-destination" title="g_dbus_message_get_destination ()">g_dbus_message_get_destination</a> <span class="c_punctuation">()</span>
281
281
</td>
282
282
</tr>
283
283
<tr>
284
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
284
<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> *
285
285
</td>
286
286
<td class="function_name">
287
287
<a class="link" href="GDBusMessage.html#g-dbus-message-get-error-name" title="g_dbus_message_get_error_name ()">g_dbus_message_get_error_name</a> <span class="c_punctuation">()</span>
296
296
</td>
297
297
</tr>
298
298
<tr>
299
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
299
<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> *
300
300
</td>
301
301
<td class="function_name">
302
302
<a class="link" href="GDBusMessage.html#g-dbus-message-get-interface" title="g_dbus_message_get_interface ()">g_dbus_message_get_interface</a> <span class="c_punctuation">()</span>
311
311
</td>
312
312
</tr>
313
313
<tr>
314
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
314
<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> *
315
315
</td>
316
316
<td class="function_name">
317
317
<a class="link" href="GDBusMessage.html#g-dbus-message-get-member" title="g_dbus_message_get_member ()">g_dbus_message_get_member</a> <span class="c_punctuation">()</span>
326
326
</td>
327
327
</tr>
328
328
<tr>
329
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
329
<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> *
330
330
</td>
331
331
<td class="function_name">
332
332
<a class="link" href="GDBusMessage.html#g-dbus-message-get-path" title="g_dbus_message_get_path ()">g_dbus_message_get_path</a> <span class="c_punctuation">()</span>
342
342
</tr>
343
343
<tr>
344
344
<td class="function_type">
345
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
345
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
346
346
</td>
347
347
<td class="function_name">
348
348
<a class="link" href="GDBusMessage.html#g-dbus-message-get-reply-serial" title="g_dbus_message_get_reply_serial ()">g_dbus_message_get_reply_serial</a> <span class="c_punctuation">()</span>
357
357
</td>
358
358
</tr>
359
359
<tr>
360
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
360
<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> *
361
361
</td>
362
362
<td class="function_name">
363
363
<a class="link" href="GDBusMessage.html#g-dbus-message-get-sender" title="g_dbus_message_get_sender ()">g_dbus_message_get_sender</a> <span class="c_punctuation">()</span>
372
372
</td>
373
373
</tr>
374
374
<tr>
375
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
375
<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> *
376
376
</td>
377
377
<td class="function_name">
378
378
<a class="link" href="GDBusMessage.html#g-dbus-message-get-signature" title="g_dbus_message_get_signature ()">g_dbus_message_get_signature</a> <span class="c_punctuation">()</span>
387
387
</td>
388
388
</tr>
389
389
<tr>
390
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
390
<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> *
391
391
</td>
392
392
<td class="function_name">
393
393
<a class="link" href="GDBusMessage.html#g-dbus-message-get-arg0" title="g_dbus_message_get_arg0 ()">g_dbus_message_get_arg0</a> <span class="c_punctuation">()</span>
395
395
</tr>
396
396
<tr>
397
397
<td class="function_type">
398
<a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
398
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
399
399
</td>
400
400
<td class="function_name">
401
401
<a class="link" href="GDBusMessage.html#g-dbus-message-to-blob" title="g_dbus_message_to_blob ()">g_dbus_message_to_blob</a> <span class="c_punctuation">()</span>
403
403
</tr>
404
404
<tr>
405
405
<td class="function_type">
406
<a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
406
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
407
407
</td>
408
408
<td class="function_name">
409
409
<a class="link" href="GDBusMessage.html#g-dbus-message-bytes-needed" title="g_dbus_message_bytes_needed ()">g_dbus_message_bytes_needed</a> <span class="c_punctuation">()</span>
419
419
</tr>
420
420
<tr>
421
421
<td class="function_type">
422
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
422
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
423
423
</td>
424
424
<td class="function_name">
425
425
<a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()">g_dbus_message_to_gerror</a> <span class="c_punctuation">()</span>
437
437
<col width="200px" class="properties_flags">
438
438
</colgroup>
439
439
<tbody><tr>
440
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
440
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
441
441
<td class="property_name"><a class="link" href="GDBusMessage.html#GDBusMessage--locked" title="The “locked” property">locked</a></td>
442
442
<td class="property_flags">Read</td>
443
443
</tr></tbody>
476
476
</div>
477
477
<div class="refsect1">
478
478
<a name="GDBusMessage.object-hierarchy"></a><h2>Object Hierarchy</h2>
479
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
479
<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
480
480
<span class="lineart">╰──</span> GDBusMessage
481
481
</pre>
482
482
</div>
499
499
<p>Creates a new empty <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</p>
500
500
<div class="refsect3">
501
501
<a name="id-1.4.17.6.9.2.5"></a><h4>Returns</h4>
502
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
502
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
503
503
<p></p>
504
504
</div>
505
505
<p class="since">Since 2.26</p>
508
508
<div class="refsect2">
509
509
<a name="g-dbus-message-new-signal"></a><h3>g_dbus_message_new_signal ()</h3>
510
510
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
511
g_dbus_message_new_signal (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>,
512
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
513
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal</code></em>);</pre>
511
g_dbus_message_new_signal (<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> *path</code></em>,
512
<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_</code></em>,
513
<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> *signal</code></em>);</pre>
514
514
<p>Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> for a signal emission.</p>
515
515
<div class="refsect3">
516
516
<a name="id-1.4.17.6.9.3.5"></a><h4>Parameters</h4>
541
541
</div>
542
542
<div class="refsect3">
543
543
<a name="id-1.4.17.6.9.3.6"></a><h4>Returns</h4>
544
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
544
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
545
545
<p></p>
546
546
</div>
547
547
<p class="since">Since 2.26</p>
550
550
<div class="refsect2">
551
551
<a name="g-dbus-message-new-method-call"></a><h3>g_dbus_message_new_method_call ()</h3>
552
552
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
553
g_dbus_message_new_method_call (<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> *path</code></em>,
555
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
556
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);</pre>
553
g_dbus_message_new_method_call (<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> *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_</code></em>,
556
<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</code></em>);</pre>
557
557
<p>Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> for a method call.</p>
558
558
<div class="refsect3">
559
559
<a name="id-1.4.17.6.9.4.5"></a><h4>Parameters</h4>
566
566
<tbody>
567
567
<tr>
568
568
<td class="parameter_name"><p>name</p></td>
569
<td class="parameter_description"><p> A valid D-Bus name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
569
<td class="parameter_description"><p> A valid D-Bus name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
570
570
<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>
571
571
</tr>
572
572
<tr>
576
576
</tr>
577
577
<tr>
578
578
<td class="parameter_name"><p>interface_</p></td>
579
<td class="parameter_description"><p> A valid D-Bus interface name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
579
<td class="parameter_description"><p> A valid D-Bus interface name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
580
580
<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>
581
581
</tr>
582
582
<tr>
589
589
</div>
590
590
<div class="refsect3">
591
591
<a name="id-1.4.17.6.9.4.6"></a><h4>Returns</h4>
592
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
592
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
593
593
<p></p>
594
594
</div>
595
595
<p class="since">Since 2.26</p>
619
619
</div>
620
620
<div class="refsect3">
621
621
<a name="id-1.4.17.6.9.5.6"></a><h4>Returns</h4>
622
<p> <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
622
<p> <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
623
623
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
624
624
</div>
625
625
<p class="since">Since 2.26</p>
629
629
<a name="g-dbus-message-new-method-error"></a><h3>g_dbus_message_new_method_error ()</h3>
630
630
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
631
631
g_dbus_message_new_method_error (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
632
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
633
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
632
<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> *error_name</code></em>,
633
<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> *error_message_format</code></em>,
634
634
<em class="parameter"><code>...</code></em>);</pre>
635
635
<p>Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> that is an error reply to <em class="parameter"><code>method_call_message</code></em>
636
636
.</p>
670
670
</div>
671
671
<div class="refsect3">
672
672
<a name="id-1.4.17.6.9.6.6"></a><h4>Returns</h4>
673
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
673
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
674
674
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
675
675
</div>
676
676
<p class="since">Since 2.26</p>
681
681
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
682
682
g_dbus_message_new_method_error_valist
683
683
(<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
684
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
685
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
684
<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> *error_name</code></em>,
685
<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> *error_message_format</code></em>,
686
686
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
687
687
<p>Like <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-error" title="g_dbus_message_new_method_error ()"><code class="function">g_dbus_message_new_method_error()</code></a> but intended for language bindings.</p>
688
688
<div class="refsect3">
721
721
</div>
722
722
<div class="refsect3">
723
723
<a name="id-1.4.17.6.9.7.6"></a><h4>Returns</h4>
724
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
724
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
725
725
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
726
726
</div>
727
727
<p class="since">Since 2.26</p>
732
732
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
733
733
g_dbus_message_new_method_error_literal
734
734
(<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
735
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
736
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message</code></em>);</pre>
735
<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> *error_name</code></em>,
736
<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> *error_message</code></em>);</pre>
737
737
<p>Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> that is an error reply to <em class="parameter"><code>method_call_message</code></em>
738
738
.</p>
739
739
<div class="refsect3">
766
766
</div>
767
767
<div class="refsect3">
768
768
<a name="id-1.4.17.6.9.8.6"></a><h4>Returns</h4>
769
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
769
<p> A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. 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>
770
770
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
771
771
</div>
772
772
<p class="since">Since 2.26</p>
774
774
<hr>
775
775
<div class="refsect2">
776
776
<a name="g-dbus-message-print"></a><h3>g_dbus_message_print ()</h3>
777
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
777
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
778
778
g_dbus_message_print (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
779
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> indent</code></em>);</pre>
779
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> indent</code></em>);</pre>
780
780
<p>Produces a human-readable multi-line description of <em class="parameter"><code>message</code></em>
781
781
.</p>
782
782
<p>The contents of the description has no ABI guarantees, the contents
875
875
</div>
876
876
<div class="refsect3">
877
877
<a name="id-1.4.17.6.9.9.11"></a><h4>Returns</h4>
878
<p> A string that should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
878
<p> A string that should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
879
879
<p></p>
880
880
</div>
881
881
<p class="since">Since 2.26</p>
883
883
<hr>
884
884
<div class="refsect2">
885
885
<a name="g-dbus-message-get-locked"></a><h3>g_dbus_message_get_locked ()</h3>
886
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
886
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
887
887
g_dbus_message_get_locked (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
888
888
<p>Checks whether <em class="parameter"><code>message</code></em>
889
889
is locked. To monitor changes to this
890
value, conncet to the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal to listen for changes
890
value, conncet 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 listen for changes
891
891
on the <a class="link" href="GDBusMessage.html#GDBusMessage--locked" title="The “locked” property"><span class="type">“locked”</span></a> property.</p>
892
892
<div class="refsect3">
893
893
<a name="id-1.4.17.6.9.10.5"></a><h4>Parameters</h4>
906
906
</div>
907
907
<div class="refsect3">
908
908
<a name="id-1.4.17.6.9.10.6"></a><h4>Returns</h4>
909
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>message</code></em>
910
is locked, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
909
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>message</code></em>
910
is locked, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
911
911
<p></p>
912
912
</div>
913
913
<p class="since">Since 2.26</p>
941
941
<a name="g-dbus-message-copy"></a><h3>g_dbus_message_copy ()</h3>
942
942
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
943
943
g_dbus_message_copy (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
944
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
944
<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>
945
945
<p>Copies <em class="parameter"><code>message</code></em>
946
946
. The copy is a deep copy and the returned
947
947
<a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> is completely identical except that it is guaranteed
965
965
</tr>
966
966
<tr>
967
967
<td class="parameter_name"><p>error</p></td>
968
<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>
968
<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>
969
969
<td class="parameter_annotations"> </td>
970
970
</tr>
971
971
</tbody>
973
973
</div>
974
974
<div class="refsect3">
975
975
<a name="id-1.4.17.6.9.12.7"></a><h4>Returns</h4>
976
<p> A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</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>
976
<p> A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</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>
977
977
is set.
978
Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
978
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>
979
979
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
980
980
</div>
981
981
<p class="since">Since 2.26</p>
1104
1104
<hr>
1105
1105
<div class="refsect2">
1106
1106
<a name="g-dbus-message-get-serial"></a><h3>g_dbus_message_get_serial ()</h3>
1107
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1107
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1108
1108
g_dbus_message_get_serial (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1109
1109
<p>Gets the serial for <em class="parameter"><code>message</code></em>
1110
1110
.</p>
1125
1125
</div>
1126
1126
<div class="refsect3">
1127
1127
<a name="id-1.4.17.6.9.17.6"></a><h4>Returns</h4>
1128
<p> A <a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</p>
1128
<p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</p>
1129
1129
<p></p>
1130
1130
</div>
1131
1131
<p class="since">Since 2.26</p>
1135
1135
<a name="g-dbus-message-set-serial"></a><h3>g_dbus_message_set_serial ()</h3>
1136
1136
<pre class="programlisting"><span class="returnvalue">void</span>
1137
1137
g_dbus_message_set_serial (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1138
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> serial</code></em>);</pre>
1138
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> serial</code></em>);</pre>
1139
1139
<p>Sets the serial for <em class="parameter"><code>message</code></em>
1140
1140
.</p>
1141
1141
<div class="refsect3">
1154
1154
</tr>
1155
1155
<tr>
1156
1156
<td class="parameter_name"><p>serial</p></td>
1157
<td class="parameter_description"><p>A <a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</p></td>
1157
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</p></td>
1158
1158
<td class="parameter_annotations"> </td>
1159
1159
</tr>
1160
1160
</tbody>
1228
1228
<hr>
1229
1229
<div class="refsect2">
1230
1230
<a name="g-dbus-message-get-body"></a><h3>g_dbus_message_get_body ()</h3>
1231
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1231
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1232
1232
g_dbus_message_get_body (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1233
1233
<p>Gets the body of a message.</p>
1234
1234
<div class="refsect3">
1248
1248
</div>
1249
1249
<div class="refsect3">
1250
1250
<a name="id-1.4.17.6.9.21.6"></a><h4>Returns</h4>
1251
<p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the body is empty. Do not free, it is owned by <em class="parameter"><code>message</code></em>
1251
<p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</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 the body is empty. Do not free, it is owned by <em class="parameter"><code>message</code></em>
1252
1252
.</p>
1253
1253
<p></p>
1254
1254
</div>
1259
1259
<a name="g-dbus-message-set-body"></a><h3>g_dbus_message_set_body ()</h3>
1260
1260
<pre class="programlisting"><span class="returnvalue">void</span>
1261
1261
g_dbus_message_set_body (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1262
<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *body</code></em>);</pre>
1262
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *body</code></em>);</pre>
1263
1263
<p>Sets the body <em class="parameter"><code>message</code></em>
1264
1264
. As a side-effect the
1265
1265
<a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-SIGNATURE:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE</code></a> header field is set to the
1266
1266
type string of <em class="parameter"><code>body</code></em>
1267
1267
(or cleared if <em class="parameter"><code>body</code></em>
1268
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1268
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1269
1269
<p>If <em class="parameter"><code>body</code></em>
1270
1270
is floating, <em class="parameter"><code>message</code></em>
1271
1271
assumes ownership of <em class="parameter"><code>body</code></em>
1286
1286
</tr>
1287
1287
<tr>
1288
1288
<td class="parameter_name"><p>body</p></td>
1289
<td class="parameter_description"><p>Either <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> that is a tuple.</p></td>
1289
<td class="parameter_description"><p>Either <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> that is a tuple.</p></td>
1290
1290
<td class="parameter_annotations"> </td>
1291
1291
</tr>
1292
1292
</tbody>
1319
1319
</div>
1320
1320
<div class="refsect3">
1321
1321
<a name="id-1.4.17.6.9.23.7"></a><h4>Returns</h4>
1322
<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> if no file descriptors are
1322
<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> if no file descriptors are
1323
1323
associated. Do not free, this object is owned by <em class="parameter"><code>message</code></em>
1324
1324
. </p>
1325
1325
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1338
1338
field is set to the number of fds in <em class="parameter"><code>fd_list</code></em>
1339
1339
(or cleared if
1340
1340
<em class="parameter"><code>fd_list</code></em>
1341
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1341
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1342
1342
<p>This method is only available on UNIX.</p>
1343
1343
<div class="refsect3">
1344
1344
<a name="id-1.4.17.6.9.24.6"></a><h4>Parameters</h4>
1356
1356
</tr>
1357
1357
<tr>
1358
1358
<td class="parameter_name"><p>fd_list</p></td>
1359
<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>
1359
<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>
1360
1360
<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>
1361
1361
</tr>
1362
1362
</tbody>
1367
1367
<hr>
1368
1368
<div class="refsect2">
1369
1369
<a name="g-dbus-message-get-num-unix-fds"></a><h3>g_dbus_message_get_num_unix_fds ()</h3>
1370
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1370
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1371
1371
g_dbus_message_get_num_unix_fds (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1372
1372
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-NUM-UNIX-FDS:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS</code></a> header field.</p>
1373
1373
<div class="refsect3">
1397
1397
<a name="g-dbus-message-set-num-unix-fds"></a><h3>g_dbus_message_set_num_unix_fds ()</h3>
1398
1398
<pre class="programlisting"><span class="returnvalue">void</span>
1399
1399
g_dbus_message_set_num_unix_fds (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1400
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1400
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1401
1401
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-NUM-UNIX-FDS:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS</code></a> header field.</p>
1402
1402
<div class="refsect3">
1403
1403
<a name="id-1.4.17.6.9.26.5"></a><h4>Parameters</h4>
1426
1426
<hr>
1427
1427
<div class="refsect2">
1428
1428
<a name="g-dbus-message-get-header-fields"></a><h3>g_dbus_message_get_header_fields ()</h3>
1429
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
1429
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
1430
1430
g_dbus_message_get_header_fields (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1431
1431
<p>Gets an array of all header fields on <em class="parameter"><code>message</code></em>
1432
1432
that are set.</p>
1449
1449
<a name="id-1.4.17.6.9.27.6"></a><h4>Returns</h4>
1450
1450
<p> An array of header fields
1451
1451
terminated by <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-INVALID:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_INVALID</code></a>. Each element
1452
is a <a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
1452
is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>. 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>
1453
1453
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p>
1454
1454
</div>
1455
1455
<p class="since">Since 2.26</p>
1457
1457
<hr>
1458
1458
<div class="refsect2">
1459
1459
<a name="g-dbus-message-get-header"></a><h3>g_dbus_message_get_header ()</h3>
1460
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1460
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1461
1461
g_dbus_message_get_header (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1462
1462
<em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>);</pre>
1463
1463
<p>Gets a header field on <em class="parameter"><code>message</code></em>
1486
1486
</div>
1487
1487
<div class="refsect3">
1488
1488
<a name="id-1.4.17.6.9.28.6"></a><h4>Returns</h4>
1489
<p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> with the value if the header was found, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1489
<p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> with the value if the header was found, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1490
1490
otherwise. Do not free, it is owned by <em class="parameter"><code>message</code></em>
1491
1491
.</p>
1492
1492
<p></p>
1499
1499
<pre class="programlisting"><span class="returnvalue">void</span>
1500
1500
g_dbus_message_set_header (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1501
1501
<em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>,
1502
<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1502
<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>
1503
1503
<p>Sets a header field on <em class="parameter"><code>message</code></em>
1504
1504
.</p>
1505
1505
<p>If <em class="parameter"><code>value</code></em>
1527
1527
</tr>
1528
1528
<tr>
1529
1529
<td class="parameter_name"><p>value</p></td>
1530
<td class="parameter_description"><p> A <a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to set the header field or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the header field. </p></td>
1530
<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> to set the header field or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the header field. </p></td>
1531
1531
<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>
1532
1532
</tr>
1533
1533
</tbody>
1538
1538
<hr>
1539
1539
<div class="refsect2">
1540
1540
<a name="g-dbus-message-get-destination"></a><h3>g_dbus_message_get_destination ()</h3>
1541
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1541
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1542
1542
g_dbus_message_get_destination (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1543
1543
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-DESTINATION:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION</code></a> header field.</p>
1544
1544
<div class="refsect3">
1568
1568
<a name="g-dbus-message-set-destination"></a><h3>g_dbus_message_set_destination ()</h3>
1569
1569
<pre class="programlisting"><span class="returnvalue">void</span>
1570
1570
g_dbus_message_set_destination (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1571
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1571
<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> *value</code></em>);</pre>
1572
1572
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-DESTINATION:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION</code></a> header field.</p>
1573
1573
<div class="refsect3">
1574
1574
<a name="id-1.4.17.6.9.31.5"></a><h4>Parameters</h4>
1597
1597
<hr>
1598
1598
<div class="refsect2">
1599
1599
<a name="g-dbus-message-get-error-name"></a><h3>g_dbus_message_get_error_name ()</h3>
1600
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1600
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1601
1601
g_dbus_message_get_error_name (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1602
1602
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-ERROR-NAME:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME</code></a> header field.</p>
1603
1603
<div class="refsect3">
1627
1627
<a name="g-dbus-message-set-error-name"></a><h3>g_dbus_message_set_error_name ()</h3>
1628
1628
<pre class="programlisting"><span class="returnvalue">void</span>
1629
1629
g_dbus_message_set_error_name (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1630
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1630
<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> *value</code></em>);</pre>
1631
1631
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-ERROR-NAME:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME</code></a> header field.</p>
1632
1632
<div class="refsect3">
1633
1633
<a name="id-1.4.17.6.9.33.5"></a><h4>Parameters</h4>
1656
1656
<hr>
1657
1657
<div class="refsect2">
1658
1658
<a name="g-dbus-message-get-interface"></a><h3>g_dbus_message_get_interface ()</h3>
1659
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1659
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1660
1660
g_dbus_message_get_interface (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1661
1661
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-INTERFACE:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE</code></a> header field.</p>
1662
1662
<div class="refsect3">
1686
1686
<a name="g-dbus-message-set-interface"></a><h3>g_dbus_message_set_interface ()</h3>
1687
1687
<pre class="programlisting"><span class="returnvalue">void</span>
1688
1688
g_dbus_message_set_interface (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1689
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1689
<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> *value</code></em>);</pre>
1690
1690
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-INTERFACE:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE</code></a> header field.</p>
1691
1691
<div class="refsect3">
1692
1692
<a name="id-1.4.17.6.9.35.5"></a><h4>Parameters</h4>
1715
1715
<hr>
1716
1716
<div class="refsect2">
1717
1717
<a name="g-dbus-message-get-member"></a><h3>g_dbus_message_get_member ()</h3>
1718
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1718
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1719
1719
g_dbus_message_get_member (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1720
1720
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-MEMBER:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_MEMBER</code></a> header field.</p>
1721
1721
<div class="refsect3">
1745
1745
<a name="g-dbus-message-set-member"></a><h3>g_dbus_message_set_member ()</h3>
1746
1746
<pre class="programlisting"><span class="returnvalue">void</span>
1747
1747
g_dbus_message_set_member (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1748
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1748
<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> *value</code></em>);</pre>
1749
1749
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-MEMBER:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_MEMBER</code></a> header field.</p>
1750
1750
<div class="refsect3">
1751
1751
<a name="id-1.4.17.6.9.37.5"></a><h4>Parameters</h4>
1774
1774
<hr>
1775
1775
<div class="refsect2">
1776
1776
<a name="g-dbus-message-get-path"></a><h3>g_dbus_message_get_path ()</h3>
1777
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1777
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1778
1778
g_dbus_message_get_path (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1779
1779
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-PATH:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_PATH</code></a> header field.</p>
1780
1780
<div class="refsect3">
1804
1804
<a name="g-dbus-message-set-path"></a><h3>g_dbus_message_set_path ()</h3>
1805
1805
<pre class="programlisting"><span class="returnvalue">void</span>
1806
1806
g_dbus_message_set_path (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1807
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1807
<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> *value</code></em>);</pre>
1808
1808
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-PATH:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_PATH</code></a> header field.</p>
1809
1809
<div class="refsect3">
1810
1810
<a name="id-1.4.17.6.9.39.5"></a><h4>Parameters</h4>
1833
1833
<hr>
1834
1834
<div class="refsect2">
1835
1835
<a name="g-dbus-message-get-reply-serial"></a><h3>g_dbus_message_get_reply_serial ()</h3>
1836
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1836
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1837
1837
g_dbus_message_get_reply_serial (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1838
1838
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-REPLY-SERIAL:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL</code></a> header field.</p>
1839
1839
<div class="refsect3">
1863
1863
<a name="g-dbus-message-set-reply-serial"></a><h3>g_dbus_message_set_reply_serial ()</h3>
1864
1864
<pre class="programlisting"><span class="returnvalue">void</span>
1865
1865
g_dbus_message_set_reply_serial (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1866
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1866
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1867
1867
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-REPLY-SERIAL:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL</code></a> header field.</p>
1868
1868
<div class="refsect3">
1869
1869
<a name="id-1.4.17.6.9.41.5"></a><h4>Parameters</h4>
1892
1892
<hr>
1893
1893
<div class="refsect2">
1894
1894
<a name="g-dbus-message-get-sender"></a><h3>g_dbus_message_get_sender ()</h3>
1895
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1895
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1896
1896
g_dbus_message_get_sender (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1897
1897
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-SENDER:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SENDER</code></a> header field.</p>
1898
1898
<div class="refsect3">
1922
1922
<a name="g-dbus-message-set-sender"></a><h3>g_dbus_message_set_sender ()</h3>
1923
1923
<pre class="programlisting"><span class="returnvalue">void</span>
1924
1924
g_dbus_message_set_sender (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1925
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1925
<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> *value</code></em>);</pre>
1926
1926
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-SENDER:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SENDER</code></a> header field.</p>
1927
1927
<div class="refsect3">
1928
1928
<a name="id-1.4.17.6.9.43.5"></a><h4>Parameters</h4>
1951
1951
<hr>
1952
1952
<div class="refsect2">
1953
1953
<a name="g-dbus-message-get-signature"></a><h3>g_dbus_message_get_signature ()</h3>
1954
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1954
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1955
1955
g_dbus_message_get_signature (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
1956
1956
<p>Convenience getter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-SIGNATURE:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE</code></a> header field.</p>
1957
1957
<div class="refsect3">
1981
1981
<a name="g-dbus-message-set-signature"></a><h3>g_dbus_message_set_signature ()</h3>
1982
1982
<pre class="programlisting"><span class="returnvalue">void</span>
1983
1983
g_dbus_message_set_signature (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
1984
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1984
<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> *value</code></em>);</pre>
1985
1985
<p>Convenience setter for the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-SIGNATURE:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE</code></a> header field.</p>
1986
1986
<div class="refsect3">
1987
1987
<a name="id-1.4.17.6.9.45.5"></a><h4>Parameters</h4>
2010
2010
<hr>
2011
2011
<div class="refsect2">
2012
2012
<a name="g-dbus-message-get-arg0"></a><h3>g_dbus_message_get_arg0 ()</h3>
2013
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2013
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2014
2014
g_dbus_message_get_arg0 (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
2015
2015
<p>Convenience to get the first item in the body of <em class="parameter"><code>message</code></em>
2016
2016
.</p>
2031
2031
</div>
2032
2032
<div class="refsect3">
2033
2033
<a name="id-1.4.17.6.9.46.6"></a><h4>Returns</h4>
2034
<p> The string item or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the first item in the body of
2034
<p> The string item or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the first item in the body of
2035
2035
<em class="parameter"><code>message</code></em>
2036
2036
is not a string.</p>
2037
2037
<p></p>
2041
2041
<hr>
2042
2042
<div class="refsect2">
2043
2043
<a name="g-dbus-message-to-blob"></a><h3>g_dbus_message_to_blob ()</h3>
2044
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
2044
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
2045
2045
g_dbus_message_to_blob (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
2046
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *out_size</code></em>,
2046
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *out_size</code></em>,
2047
2047
<em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
2048
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2048
<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>
2049
2049
<p>Serializes <em class="parameter"><code>message</code></em>
2050
2050
to a blob. The byte order returned by
2051
2051
<a class="link" href="GDBusMessage.html#g-dbus-message-get-byte-order" title="g_dbus_message_get_byte_order ()"><code class="function">g_dbus_message_get_byte_order()</code></a> will be used.</p>
2086
2086
<p> A pointer to a
2087
2087
valid binary D-Bus message of <em class="parameter"><code>out_size</code></em>
2088
2088
bytes generated by <em class="parameter"><code>message</code></em>
2089
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
2090
is set. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
2089
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>
2090
is set. 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>
2091
2091
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=out_size][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
2092
2092
</div>
2093
2093
<p class="since">Since 2.26</p>
2095
2095
<hr>
2096
2096
<div class="refsect2">
2097
2097
<a name="g-dbus-message-bytes-needed"></a><h3>g_dbus_message_bytes_needed ()</h3>
2098
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
2099
g_dbus_message_bytes_needed (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
2100
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2101
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2098
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
2099
g_dbus_message_bytes_needed (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
2100
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2101
<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>
2102
2102
<p>Utility function to calculate how many bytes are needed to
2103
2103
completely deserialize the D-Bus message stored at <em class="parameter"><code>blob</code></em>
2104
2104
.</p>
2124
2124
</tr>
2125
2125
<tr>
2126
2126
<td class="parameter_name"><p>error</p></td>
2127
<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>
2127
<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>
2128
2128
<td class="parameter_annotations"> </td>
2129
2129
</tr>
2130
2130
</tbody>
2145
2145
<div class="refsect2">
2146
2146
<a name="g-dbus-message-new-from-blob"></a><h3>g_dbus_message_new_from_blob ()</h3>
2147
2147
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
2148
g_dbus_message_new_from_blob (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
2149
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2148
g_dbus_message_new_from_blob (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
2149
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2150
2150
<em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
2151
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2151
<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>
2152
2152
<p>Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> from the data stored at <em class="parameter"><code>blob</code></em>
2153
2153
. The byte
2154
2154
order that the message was in can be retrieved using
2180
2180
</tr>
2181
2181
<tr>
2182
2182
<td class="parameter_name"><p>error</p></td>
2183
<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>
2183
<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>
2184
2184
<td class="parameter_annotations"> </td>
2185
2185
</tr>
2186
2186
</tbody>
2188
2188
</div>
2189
2189
<div class="refsect3">
2190
2190
<a name="id-1.4.17.6.9.49.6"></a><h4>Returns</h4>
2191
<p> A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</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>
2191
<p> A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</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>
2192
2192
is set. Free with
2193
<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
2193
<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>
2194
2194
<p></p>
2195
2195
</div>
2196
2196
<p class="since">Since 2.26</p>
2198
2198
<hr>
2199
2199
<div class="refsect2">
2200
2200
<a name="g-dbus-message-to-gerror"></a><h3>g_dbus_message_to_gerror ()</h3>
2201
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2201
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2202
2202
g_dbus_message_to_gerror (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
2203
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2203
<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>
2204
2204
<p>If <em class="parameter"><code>message</code></em>
2205
2205
is not of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-ERROR:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_ERROR</code></a> does
2206
nothing and returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
2206
nothing and returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
2207
2207
<p>Otherwise this method encodes the error in <em class="parameter"><code>message</code></em>
2208
as a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
2208
as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
2209
2209
using <a class="link" href="gio-GDBusError.html#g-dbus-error-set-dbus-error" title="g_dbus_error_set_dbus_error ()"><code class="function">g_dbus_error_set_dbus_error()</code></a> using the information in the
2210
2210
<a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-HEADER-FIELD-ERROR-NAME:CAPS"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME</code></a> header field of <em class="parameter"><code>message</code></em>
2211
2211
as
2227
2227
</tr>
2228
2228
<tr>
2229
2229
<td class="parameter_name"><p>error</p></td>
2230
<td class="parameter_description"><p>The <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to set.</p></td>
2230
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to set.</p></td>
2231
2231
<td class="parameter_annotations"> </td>
2232
2232
</tr>
2233
2233
</tbody>
2235
2235
</div>
2236
2236
<div class="refsect3">
2237
2237
<a name="id-1.4.17.6.9.50.7"></a><h4>Returns</h4>
2238
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em>
2239
was set, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2238
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em>
2239
was set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2240
2240
<p></p>
2241
2241
</div>
2242
2242
<p class="since">Since 2.26</p>
2469
2469
<a name="GDBusMessage.property-details"></a><h2>Property Details</h2>
2470
2470
<div class="refsect2">
2471
2471
<a name="GDBusMessage--locked"></a><h3>The <code class="literal">“locked”</code> property</h3>
2472
<pre class="programlisting"> “locked” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
2472
<pre class="programlisting"> “locked” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
2473
2473
<p>Whether the message is locked.</p>
2474
2474
<p>Flags: Read</p>
2475
2475
<p>Default value: FALSE</p>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1