101
101
<td class="function_type">
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
102
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
109
109
<td class="function_type">
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
110
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
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>
165
165
<td class="function_type">
166
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
166
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
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>
197
197
<td class="function_type">
198
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
198
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
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>
229
229
<td class="function_type">
230
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
230
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
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>
245
245
<td class="function_type">
246
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
246
<a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
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>
253
253
<td class="function_type">
254
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
254
<a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
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>
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> *
269
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
284
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
299
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
314
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
329
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
344
344
<td class="function_type">
345
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
345
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
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>
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> *
360
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
375
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
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> *
390
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
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>
397
397
<td class="function_type">
398
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
398
<a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
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>
405
405
<td class="function_type">
406
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
406
<a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
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>
421
421
<td class="function_type">
422
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
422
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
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">
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>
440
<td class="property_type"><a href="../glib/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>
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="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>
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>
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="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>
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>
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>
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="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>
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>
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="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>
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>
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>
568
568
<td class="parameter_name"><p>name</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>
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>
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>
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="http://library.gnome.org/devel/glib/unstable/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="../glib/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>
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="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>
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>
595
595
<p class="since">Since 2.26</p>
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="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>
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>
623
623
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
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="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>,
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>,
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>
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="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>
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>
674
674
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
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="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>,
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>,
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">
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="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>
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>
725
725
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
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="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>
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>
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>
739
739
<div class="refsect3">
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="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>
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>
770
770
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
772
772
<p class="since">Since 2.26</p>
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
777
<pre class="programlisting"><a href="../glib/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> indent</code></em>);</pre>
779
<em class="parameter"><code><a href="../glib/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>
782
782
<p>The contents of the description has no ABI guarantees, the contents
801
<td class="listing_code"><pre class="programlisting"><span class="normal">Type</span><span class="symbol">:</span><span class="normal"> method</span><span class="symbol">-</span><span class="normal">call</span>
802
<span class="normal">Flags</span><span class="symbol">:</span><span class="normal"> none</span>
803
<span class="normal">Version</span><span class="symbol">:</span><span class="normal"> </span><span class="number">0</span>
804
<span class="normal">Serial</span><span class="symbol">:</span><span class="normal"> </span><span class="number">4</span>
805
<span class="label">Headers:</span>
806
<span class="normal"> path </span><span class="symbol">-></span><span class="normal"> objectpath </span><span class="string">'/org/gtk/GDBus/TestObject'</span>
807
<span class="normal"> interface </span><span class="symbol">-></span><span class="normal"> </span><span class="string">'org.gtk.GDBus.TestInterface'</span>
808
<span class="normal"> member </span><span class="symbol">-></span><span class="normal"> </span><span class="string">'GimmeStdout'</span>
809
<span class="normal"> destination </span><span class="symbol">-></span><span class="normal"> </span><span class="string">':1.146'</span>
810
<span class="normal">Body</span><span class="symbol">:</span><span class="normal"> </span><span class="symbol">()</span>
811
<span class="normal">UNIX </span><span class="usertype">File</span><span class="normal"> Descriptors</span><span class="symbol">:</span>
812
<span class="normal"> </span><span class="symbol">(</span><span class="normal">none</span><span class="symbol">)</span></pre></td>
801
<td class="listing_code"><pre class="programlisting">Type<span class="gtkdoc opt">:</span> method<span class="gtkdoc opt">-</span>call
802
Flags<span class="gtkdoc opt">:</span> none
803
Version<span class="gtkdoc opt">:</span> <span class="number">0</span>
804
Serial<span class="gtkdoc opt">:</span> <span class="number">4</span>
805
Headers<span class="gtkdoc opt">:</span>
806
path <span class="gtkdoc opt">-></span> objectpath <span class="string">'/org/gtk/GDBus/TestObject'</span>
807
interface <span class="gtkdoc opt">-></span> <span class="string">'org.gtk.GDBus.TestInterface'</span>
808
member <span class="gtkdoc opt">-></span> <span class="string">'GimmeStdout'</span>
809
destination <span class="gtkdoc opt">-></span> <span class="string">':1.146'</span>
810
Body<span class="gtkdoc opt">: ()</span>
811
UNIX File Descriptors<span class="gtkdoc opt">:</span>
812
<span class="gtkdoc opt">(</span>none<span class="gtkdoc opt">)</span></pre></td>
836
<td class="listing_code"><pre class="programlisting"><span class="normal">Type</span><span class="symbol">:</span><span class="normal"> method</span><span class="symbol">-</span><span class="keyword">return</span>
837
<span class="normal">Flags</span><span class="symbol">:</span><span class="normal"> no</span><span class="symbol">-</span><span class="normal">reply</span><span class="symbol">-</span><span class="normal">expected</span>
838
<span class="normal">Version</span><span class="symbol">:</span><span class="normal"> </span><span class="number">0</span>
839
<span class="normal">Serial</span><span class="symbol">:</span><span class="normal"> </span><span class="number">477</span>
840
<span class="label">Headers:</span>
841
<span class="normal"> reply</span><span class="symbol">-</span><span class="normal">serial </span><span class="symbol">-></span><span class="normal"> uint32 </span><span class="number">4</span>
842
<span class="normal"> destination </span><span class="symbol">-></span><span class="normal"> </span><span class="string">':1.159'</span>
843
<span class="normal"> sender </span><span class="symbol">-></span><span class="normal"> </span><span class="string">':1.146'</span>
844
<span class="normal"> num</span><span class="symbol">-</span><span class="normal">unix</span><span class="symbol">-</span><span class="normal">fds </span><span class="symbol">-></span><span class="normal"> uint32 </span><span class="number">1</span>
845
<span class="normal">Body</span><span class="symbol">:</span><span class="normal"> </span><span class="symbol">()</span>
846
<span class="normal">UNIX </span><span class="usertype">File</span><span class="normal"> Descriptors</span><span class="symbol">:</span>
847
<span class="normal"> fd </span><span class="number">12</span><span class="symbol">:</span><span class="normal"> dev</span><span class="symbol">=</span><span class="number">0</span><span class="symbol">:</span><span class="number">10</span><span class="symbol">,</span><span class="normal">mode</span><span class="symbol">=</span><span class="number">020620</span><span class="symbol">,</span><span class="normal">ino</span><span class="symbol">=</span><span class="number">5</span><span class="symbol">,</span><span class="normal">uid</span><span class="symbol">=</span><span class="number">500</span><span class="symbol">,</span><span class="normal">gid</span><span class="symbol">=</span><span class="number">5</span><span class="symbol">,</span><span class="normal">rdev</span><span class="symbol">=</span><span class="number">136</span><span class="symbol">:</span><span class="number">2</span><span class="symbol">,</span><span class="normal">size</span><span class="symbol">=</span><span class="number">0</span><span class="symbol">,</span><span class="normal">atime</span><span class="symbol">=</span><span class="number">1273085037</span><span class="symbol">,</span><span class="normal">mtime</span><span class="symbol">=</span><span class="number">1273085851</span><span class="symbol">,</span><span class="normal">ctime</span><span class="symbol">=</span><span class="number">1272982635</span></pre></td>
836
<td class="listing_code"><pre class="programlisting">Type<span class="gtkdoc opt">:</span> method<span class="gtkdoc opt">-</span><span class="keyword">return</span>
837
Flags<span class="gtkdoc opt">:</span> no<span class="gtkdoc opt">-</span>reply<span class="gtkdoc opt">-</span>expected
838
Version<span class="gtkdoc opt">:</span> <span class="number">0</span>
839
Serial<span class="gtkdoc opt">:</span> <span class="number">477</span>
840
Headers<span class="gtkdoc opt">:</span>
841
reply<span class="gtkdoc opt">-</span>serial <span class="gtkdoc opt">-></span> uint32 <span class="number">4</span>
842
destination <span class="gtkdoc opt">-></span> <span class="string">':1.159'</span>
843
sender <span class="gtkdoc opt">-></span> <span class="string">':1.146'</span>
844
num<span class="gtkdoc opt">-</span>unix<span class="gtkdoc opt">-</span>fds <span class="gtkdoc opt">-></span> uint32 <span class="number">1</span>
845
Body<span class="gtkdoc opt">: ()</span>
846
UNIX File Descriptors<span class="gtkdoc opt">:</span>
847
fd <span class="number">12</span><span class="gtkdoc opt">:</span> dev<span class="gtkdoc opt">=</span><span class="number">0</span><span class="gtkdoc opt">:</span><span class="number">10</span><span class="gtkdoc opt">,</span>mode<span class="gtkdoc opt">=</span><span class="number">020620</span><span class="gtkdoc opt">,</span>ino<span class="gtkdoc opt">=</span><span class="number">5</span><span class="gtkdoc opt">,</span>uid<span class="gtkdoc opt">=</span><span class="number">500</span><span class="gtkdoc opt">,</span>gid<span class="gtkdoc opt">=</span><span class="number">5</span><span class="gtkdoc opt">,</span>rdev<span class="gtkdoc opt">=</span><span class="number">136</span><span class="gtkdoc opt">:</span><span class="number">2</span><span class="gtkdoc opt">,</span>size<span class="gtkdoc opt">=</span><span class="number">0</span><span class="gtkdoc opt">,</span>atime<span class="gtkdoc opt">=</span><span class="number">1273085037</span><span class="gtkdoc opt">,</span>mtime<span class="gtkdoc opt">=</span><span class="number">1273085851</span><span class="gtkdoc opt">,</span>ctime<span class="gtkdoc opt">=</span><span class="number">1272982635</span></pre></td>
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="http://library.gnome.org/devel/glib/unstable/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="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
881
881
<p class="since">Since 2.26</p>
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
886
<pre class="programlisting"><a href="../glib/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="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
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
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>
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="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>
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>
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="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
944
<em class="parameter"><code><a href="../glib/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
967
967
<td class="parameter_name"><p>error</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>
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>
969
969
<td class="parameter_annotations"> </td>
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="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>
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>
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>
978
Free with <a href="../gobject/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>
981
981
<p class="since">Since 2.26</p>
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1107
<pre class="programlisting"><a href="../glib/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>
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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> serial</code></em>);</pre>
1138
<em class="parameter"><code><a href="../glib/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>
1141
1141
<div class="refsect3">
1156
1156
<td class="parameter_name"><p>serial</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>
1157
<td class="parameter_description"><p>A <a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</p></td>
1158
1158
<td class="parameter_annotations"> </td>
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="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1231
<pre class="programlisting"><a href="../glib/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">
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="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
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
1252
1252
empty. Do not free, it is owned by <em class="parameter"><code>message</code></em>
1254
1254
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1260
1260
<a name="g-dbus-message-set-body"></a><h3>g_dbus_message_set_body ()</h3>
1261
1261
<pre class="programlisting"><span class="returnvalue">void</span>
1262
1262
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>,
1263
<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
<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *body</code></em>);</pre>
1264
1264
<p>Sets the body <em class="parameter"><code>message</code></em>
1265
1265
. As a side-effect the
1266
1266
<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
1267
1267
type string of <em class="parameter"><code>body</code></em>
1268
1268
(or cleared if <em class="parameter"><code>body</code></em>
1269
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1269
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1270
1270
<p>If <em class="parameter"><code>body</code></em>
1271
1271
is floating, <em class="parameter"><code>message</code></em>
1272
1272
assumes ownership of <em class="parameter"><code>body</code></em>
1289
1289
<td class="parameter_name"><p>body</p></td>
1290
<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
<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>
1291
1291
<td class="parameter_annotations"> </td>
1321
1321
<div class="refsect3">
1322
1322
<a name="id-1.4.17.6.9.23.7"></a><h4>Returns</h4>
1323
<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
<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
1324
1324
associated. Do not free, this object is owned by <em class="parameter"><code>message</code></em>
1326
1326
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1339
1339
field is set to the number of fds in <em class="parameter"><code>fd_list</code></em>
1341
1341
<em class="parameter"><code>fd_list</code></em>
1342
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1342
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
1343
1343
<p>This method is only available on UNIX.</p>
1344
1344
<div class="refsect3">
1345
1345
<a name="id-1.4.17.6.9.24.6"></a><h4>Parameters</h4>
1359
1359
<td class="parameter_name"><p>fd_list</p></td>
1360
<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
<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>
1361
1361
<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>
1369
1369
<div class="refsect2">
1370
1370
<a name="g-dbus-message-get-num-unix-fds"></a><h3>g_dbus_message_get_num_unix_fds ()</h3>
1371
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1371
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1372
1372
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>
1373
1373
<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>
1374
1374
<div class="refsect3">
1398
1398
<a name="g-dbus-message-set-num-unix-fds"></a><h3>g_dbus_message_set_num_unix_fds ()</h3>
1399
1399
<pre class="programlisting"><span class="returnvalue">void</span>
1400
1400
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>,
1401
<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
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1402
1402
<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>
1403
1403
<div class="refsect3">
1404
1404
<a name="id-1.4.17.6.9.26.5"></a><h4>Parameters</h4>
1428
1428
<div class="refsect2">
1429
1429
<a name="g-dbus-message-get-header-fields"></a><h3>g_dbus_message_get_header_fields ()</h3>
1430
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
1430
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
1431
1431
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>
1432
1432
<p>Gets an array of all header fields on <em class="parameter"><code>message</code></em>
1433
1433
that are set.</p>
1450
1450
<a name="id-1.4.17.6.9.27.6"></a><h4>Returns</h4>
1451
1451
<p> An array of header fields
1452
1452
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
1453
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
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>
1454
1454
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p>
1456
1456
<p class="since">Since 2.26</p>
1459
1459
<div class="refsect2">
1460
1460
<a name="g-dbus-message-get-header"></a><h3>g_dbus_message_get_header ()</h3>
1461
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1461
<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
1462
1462
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>,
1463
1463
<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>
1464
1464
<p>Gets a header field on <em class="parameter"><code>message</code></em>
1488
1488
<div class="refsect3">
1489
1489
<a name="id-1.4.17.6.9.28.6"></a><h4>Returns</h4>
1490
<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
<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>
1491
1491
otherwise. Do not free, it is owned by <em class="parameter"><code>message</code></em>
1500
1500
<pre class="programlisting"><span class="returnvalue">void</span>
1501
1501
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>,
1502
1502
<em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>,
1503
<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
<em class="parameter"><code><a href="../glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1504
1504
<p>Sets a header field on <em class="parameter"><code>message</code></em>
1506
1506
<p>If <em class="parameter"><code>value</code></em>
1530
1530
<td class="parameter_name"><p>value</p></td>
1531
<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
<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>
1532
1532
<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>
1540
1540
<div class="refsect2">
1541
1541
<a name="g-dbus-message-get-destination"></a><h3>g_dbus_message_get_destination ()</h3>
1542
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1543
1543
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>
1544
1544
<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>
1545
1545
<div class="refsect3">
1569
1569
<a name="g-dbus-message-set-destination"></a><h3>g_dbus_message_set_destination ()</h3>
1570
1570
<pre class="programlisting"><span class="returnvalue">void</span>
1571
1571
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>,
1572
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1573
1573
<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>
1574
1574
<div class="refsect3">
1575
1575
<a name="id-1.4.17.6.9.31.5"></a><h4>Parameters</h4>
1599
1599
<div class="refsect2">
1600
1600
<a name="g-dbus-message-get-error-name"></a><h3>g_dbus_message_get_error_name ()</h3>
1601
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1602
1602
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>
1603
1603
<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>
1604
1604
<div class="refsect3">
1628
1628
<a name="g-dbus-message-set-error-name"></a><h3>g_dbus_message_set_error_name ()</h3>
1629
1629
<pre class="programlisting"><span class="returnvalue">void</span>
1630
1630
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>,
1631
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1632
1632
<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>
1633
1633
<div class="refsect3">
1634
1634
<a name="id-1.4.17.6.9.33.5"></a><h4>Parameters</h4>
1658
1658
<div class="refsect2">
1659
1659
<a name="g-dbus-message-get-interface"></a><h3>g_dbus_message_get_interface ()</h3>
1660
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1661
1661
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>
1662
1662
<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>
1663
1663
<div class="refsect3">
1687
1687
<a name="g-dbus-message-set-interface"></a><h3>g_dbus_message_set_interface ()</h3>
1688
1688
<pre class="programlisting"><span class="returnvalue">void</span>
1689
1689
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>,
1690
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1691
1691
<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>
1692
1692
<div class="refsect3">
1693
1693
<a name="id-1.4.17.6.9.35.5"></a><h4>Parameters</h4>
1717
1717
<div class="refsect2">
1718
1718
<a name="g-dbus-message-get-member"></a><h3>g_dbus_message_get_member ()</h3>
1719
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1720
1720
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>
1721
1721
<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>
1722
1722
<div class="refsect3">
1746
1746
<a name="g-dbus-message-set-member"></a><h3>g_dbus_message_set_member ()</h3>
1747
1747
<pre class="programlisting"><span class="returnvalue">void</span>
1748
1748
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>,
1749
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1750
1750
<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>
1751
1751
<div class="refsect3">
1752
1752
<a name="id-1.4.17.6.9.37.5"></a><h4>Parameters</h4>
1776
1776
<div class="refsect2">
1777
1777
<a name="g-dbus-message-get-path"></a><h3>g_dbus_message_get_path ()</h3>
1778
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1779
1779
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>
1780
1780
<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>
1781
1781
<div class="refsect3">
1805
1805
<a name="g-dbus-message-set-path"></a><h3>g_dbus_message_set_path ()</h3>
1806
1806
<pre class="programlisting"><span class="returnvalue">void</span>
1807
1807
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>,
1808
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1809
1809
<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>
1810
1810
<div class="refsect3">
1811
1811
<a name="id-1.4.17.6.9.39.5"></a><h4>Parameters</h4>
1835
1835
<div class="refsect2">
1836
1836
<a name="g-dbus-message-get-reply-serial"></a><h3>g_dbus_message_get_reply_serial ()</h3>
1837
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1837
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
1838
1838
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>
1839
1839
<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>
1840
1840
<div class="refsect3">
1864
1864
<a name="g-dbus-message-set-reply-serial"></a><h3>g_dbus_message_set_reply_serial ()</h3>
1865
1865
<pre class="programlisting"><span class="returnvalue">void</span>
1866
1866
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>,
1867
<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
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1868
1868
<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>
1869
1869
<div class="refsect3">
1870
1870
<a name="id-1.4.17.6.9.41.5"></a><h4>Parameters</h4>
1894
1894
<div class="refsect2">
1895
1895
<a name="g-dbus-message-get-sender"></a><h3>g_dbus_message_get_sender ()</h3>
1896
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1897
1897
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>
1898
1898
<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>
1899
1899
<div class="refsect3">
1923
1923
<a name="g-dbus-message-set-sender"></a><h3>g_dbus_message_set_sender ()</h3>
1924
1924
<pre class="programlisting"><span class="returnvalue">void</span>
1925
1925
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>,
1926
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1927
1927
<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>
1928
1928
<div class="refsect3">
1929
1929
<a name="id-1.4.17.6.9.43.5"></a><h4>Parameters</h4>
1953
1953
<div class="refsect2">
1954
1954
<a name="g-dbus-message-get-signature"></a><h3>g_dbus_message_get_signature ()</h3>
1955
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1956
1956
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>
1957
1957
<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>
1958
1958
<div class="refsect3">
1982
1982
<a name="g-dbus-message-set-signature"></a><h3>g_dbus_message_set_signature ()</h3>
1983
1983
<pre class="programlisting"><span class="returnvalue">void</span>
1984
1984
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>,
1985
<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
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1986
1986
<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>
1987
1987
<div class="refsect3">
1988
1988
<a name="id-1.4.17.6.9.45.5"></a><h4>Parameters</h4>
2012
2012
<div class="refsect2">
2013
2013
<a name="g-dbus-message-get-arg0"></a><h3>g_dbus_message_get_arg0 ()</h3>
2014
<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
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2015
2015
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>
2016
2016
<p>Convenience to get the first item in the body of <em class="parameter"><code>message</code></em>
2033
2033
<div class="refsect3">
2034
2034
<a name="id-1.4.17.6.9.46.6"></a><h4>Returns</h4>
2035
<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
<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
2036
2036
<em class="parameter"><code>message</code></em>
2037
2037
is not a string.</p>
2043
2043
<div class="refsect2">
2044
2044
<a name="g-dbus-message-to-blob"></a><h3>g_dbus_message_to_blob ()</h3>
2045
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
2045
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
2046
2046
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>,
2047
<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
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *out_size</code></em>,
2048
2048
<em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
2049
<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
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2050
2050
<p>Serializes <em class="parameter"><code>message</code></em>
2051
2051
to a blob. The byte order returned by
2052
2052
<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>
2087
2087
<p> A pointer to a
2088
2088
valid binary D-Bus message of <em class="parameter"><code>out_size</code></em>
2089
2089
bytes generated by <em class="parameter"><code>message</code></em>
2090
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>
2091
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>
2090
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
2091
is set. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
2092
2092
<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>
2094
2094
<p class="since">Since 2.26</p>
2097
2097
<div class="refsect2">
2098
2098
<a name="g-dbus-message-bytes-needed"></a><h3>g_dbus_message_bytes_needed ()</h3>
2099
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
2100
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>,
2101
<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>,
2102
<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>
2099
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
2100
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>,
2101
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2102
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2103
2103
<p>Utility function to calculate how many bytes are needed to
2104
2104
completely deserialize the D-Bus message stored at <em class="parameter"><code>blob</code></em>
2127
2127
<td class="parameter_name"><p>error</p></td>
2128
<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
<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>
2129
2129
<td class="parameter_annotations"> </td>
2146
2146
<div class="refsect2">
2147
2147
<a name="g-dbus-message-new-from-blob"></a><h3>g_dbus_message_new_from_blob ()</h3>
2148
2148
<pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> *
2149
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>,
2150
<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>,
2149
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>,
2150
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
2151
2151
<em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
2152
<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
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2153
2153
<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>
2155
2155
order that the message was in can be retrieved using
2183
2183
<td class="parameter_name"><p>error</p></td>
2184
<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
<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>
2185
2185
<td class="parameter_annotations"> </td>
2190
2190
<div class="refsect3">
2191
2191
<a name="id-1.4.17.6.9.49.6"></a><h4>Returns</h4>
2192
<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
<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>
2193
2193
is set. Free with
2194
<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
<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
2197
2197
<p class="since">Since 2.26</p>
2200
2200
<div class="refsect2">
2201
2201
<a name="g-dbus-message-to-gerror"></a><h3>g_dbus_message_to_gerror ()</h3>
2202
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2202
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2203
2203
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>,
2204
<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
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2205
2205
<p>If <em class="parameter"><code>message</code></em>
2206
2206
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
2207
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
nothing and returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
2208
2208
<p>Otherwise this method encodes the error in <em class="parameter"><code>message</code></em>
2209
as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
2209
as a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
2210
2210
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
2211
2211
<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>
2230
2230
<td class="parameter_name"><p>error</p></td>
2231
<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
<td class="parameter_description"><p>The <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to set.</p></td>
2232
2232
<td class="parameter_annotations"> </td>
2237
2237
<div class="refsect3">
2238
2238
<a name="id-1.4.17.6.9.50.7"></a><h4>Returns</h4>
2239
<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>
2240
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>
2239
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em>
2240
was set, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2243
2243
<p class="since">Since 2.26</p>
2470
2470
<a name="GDBusMessage.property-details"></a><h2>Property Details</h2>
2471
2471
<div class="refsect2">
2472
2472
<a name="GDBusMessage--locked"></a><h3>The <code class="literal">“locked”</code> property</h3>
2473
<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
<pre class="programlisting"> “locked” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
2474
2474
<p>Whether the message is locked.</p>
2475
2475
<p>Flags: Read</p>
2476
2476
<p>Default value: FALSE</p>