1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GDBusMessage</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="gdbus-lowlevel.html" title="Lowlevel D-Bus Support">
9 <link rel="prev" href="gio-GDBusError.html" title="GDBusError">
10 <link rel="next" href="GDBusConnection.html" title="GDBusConnection">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="gio-GDBusError.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="gdbus-lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GIO Reference Manual</th>
21 <td><a accesskey="n" href="GDBusConnection.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GDBusMessage.synopsis" class="shortcut">Top</a>
26 <a href="#GDBusMessage.description" class="shortcut">Description</a>
28 <a href="#GDBusMessage.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GDBusMessage.properties" class="shortcut">Properties</a>
33 <div class="refentry">
34 <a name="GDBusMessage"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
37 <h2><span class="refentrytitle"><a name="GDBusMessage.top_of_page"></a>GDBusMessage</span></h2>
38 <p>GDBusMessage — D-Bus Message</p>
40 <td valign="top" align="right"></td>
42 <div class="refsynopsisdiv">
43 <a name="GDBusMessage.synopsis"></a><h2>Synopsis</h2>
44 <pre class="synopsis">
45 #include <gio/gio.h>
47 <a class="link" href="GDBusMessage.html#GDBusMessage-struct" title="GDBusMessage">GDBusMessage</a>;
48 enum <a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType">GDBusMessageType</a>;
49 enum <a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags">GDBusMessageFlags</a>;
50 enum <a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField">GDBusMessageHeaderField</a>;
51 enum <a class="link" href="GDBusMessage.html#GDBusMessageByteOrder" title="enum GDBusMessageByteOrder">GDBusMessageByteOrder</a>;
52 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new" title="g_dbus_message_new ()">g_dbus_message_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
53 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-signal" title="g_dbus_message_new_signal ()">g_dbus_message_new_signal</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>,
54 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
55 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal</code></em>);
56 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-call" title="g_dbus_message_new_method_call ()">g_dbus_message_new_method_call</a> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
57 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>,
58 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
59 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);
60 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-reply" title="g_dbus_message_new_method_reply ()">g_dbus_message_new_method_reply</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>);
61 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-error" title="g_dbus_message_new_method_error ()">g_dbus_message_new_method_error</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
62 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
63 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
64 <em class="parameter"><code>...</code></em>);
65 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-error-valist" title="g_dbus_message_new_method_error_valist ()">g_dbus_message_new_method_error_valist</a>
66 (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
67 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
68 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
69 <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
70 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-method-error-literal" title="g_dbus_message_new_method_error_literal ()">g_dbus_message_new_method_error_literal</a>
71 (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
72 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
73 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message</code></em>);
74 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-print" title="g_dbus_message_print ()">g_dbus_message_print</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
75 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> indent</code></em>);
76 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-get-locked" title="g_dbus_message_get_locked ()">g_dbus_message_get_locked</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
77 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-lock" title="g_dbus_message_lock ()">g_dbus_message_lock</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
78 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-copy" title="g_dbus_message_copy ()">g_dbus_message_copy</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
79 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
80 <a class="link" href="GDBusMessage.html#GDBusMessageByteOrder" title="enum GDBusMessageByteOrder"><span class="returnvalue">GDBusMessageByteOrder</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-get-byte-order" title="g_dbus_message_get_byte_order ()">g_dbus_message_get_byte_order</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
81 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-byte-order" title="g_dbus_message_set_byte_order ()">g_dbus_message_set_byte_order</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
82 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageByteOrder" title="enum GDBusMessageByteOrder"><span class="type">GDBusMessageByteOrder</span></a> byte_order</code></em>);
83 <a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="returnvalue">GDBusMessageType</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-get-message-type" title="g_dbus_message_get_message_type ()">g_dbus_message_get_message_type</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
84 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-message-type" title="g_dbus_message_set_message_type ()">g_dbus_message_set_message_type</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
85 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="type">GDBusMessageType</span></a> type</code></em>);
86 <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-get-serial" title="g_dbus_message_get_serial ()">g_dbus_message_get_serial</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
87 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-serial" title="g_dbus_message_set_serial ()">g_dbus_message_set_serial</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
88 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> serial</code></em>);
89 <a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="returnvalue">GDBusMessageFlags</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-get-flags" title="g_dbus_message_get_flags ()">g_dbus_message_get_flags</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
90 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-flags" title="g_dbus_message_set_flags ()">g_dbus_message_set_flags</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
91 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="type">GDBusMessageFlags</span></a> flags</code></em>);
92 <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-body" title="g_dbus_message_get_body ()">g_dbus_message_get_body</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
93 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-body" title="g_dbus_message_set_body ()">g_dbus_message_set_body</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
94 <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *body</code></em>);
95 <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="returnvalue">GUnixFDList</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-unix-fd-list" title="g_dbus_message_get_unix_fd_list ()">g_dbus_message_get_unix_fd_list</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
96 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-unix-fd-list" title="g_dbus_message_set_unix_fd_list ()">g_dbus_message_set_unix_fd_list</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
97 <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> *fd_list</code></em>);
98 <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> <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> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
99 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-num-unix-fds" title="g_dbus_message_set_num_unix_fds ()">g_dbus_message_set_num_unix_fds</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
100 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);
101 <a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <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> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
102 <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-header" title="g_dbus_message_get_header ()">g_dbus_message_get_header</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
103 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>);
104 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-header" title="g_dbus_message_set_header ()">g_dbus_message_set_header</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
105 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>,
106 <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);
107 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-destination" title="g_dbus_message_get_destination ()">g_dbus_message_get_destination</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
108 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-destination" title="g_dbus_message_set_destination ()">g_dbus_message_set_destination</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
109 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
110 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <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> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
111 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-error-name" title="g_dbus_message_set_error_name ()">g_dbus_message_set_error_name</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
112 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
113 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-interface" title="g_dbus_message_get_interface ()">g_dbus_message_get_interface</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
114 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-interface" title="g_dbus_message_set_interface ()">g_dbus_message_set_interface</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
115 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
116 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-member" title="g_dbus_message_get_member ()">g_dbus_message_get_member</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
117 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-member" title="g_dbus_message_set_member ()">g_dbus_message_set_member</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
118 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
119 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-path" title="g_dbus_message_get_path ()">g_dbus_message_get_path</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
120 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-path" title="g_dbus_message_set_path ()">g_dbus_message_set_path</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
121 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
122 <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> <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> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
123 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-reply-serial" title="g_dbus_message_set_reply_serial ()">g_dbus_message_set_reply_serial</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
124 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);
125 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-sender" title="g_dbus_message_get_sender ()">g_dbus_message_get_sender</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
126 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-sender" title="g_dbus_message_set_sender ()">g_dbus_message_set_sender</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
127 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
128 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-signature" title="g_dbus_message_get_signature ()">g_dbus_message_get_signature</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
129 <span class="returnvalue">void</span> <a class="link" href="GDBusMessage.html#g-dbus-message-set-signature" title="g_dbus_message_set_signature ()">g_dbus_message_set_signature</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
130 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
131 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-get-arg0" title="g_dbus_message_get_arg0 ()">g_dbus_message_get_arg0</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);
132 <a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-to-blob" title="g_dbus_message_to_blob ()">g_dbus_message_to_blob</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
133 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *out_size</code></em>,
134 <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
135 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
136 <a href="./../glib/glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-bytes-needed" title="g_dbus_message_bytes_needed ()">g_dbus_message_bytes_needed</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
137 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
138 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
139 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * <a class="link" href="GDBusMessage.html#g-dbus-message-new-from-blob" title="g_dbus_message_new_from_blob ()">g_dbus_message_new_from_blob</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
140 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
141 <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
142 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
143 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()">g_dbus_message_to_gerror</a> (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
144 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
147 <div class="refsect1">
148 <a name="GDBusMessage.object-hierarchy"></a><h2>Object Hierarchy</h2>
149 <pre class="synopsis">
150 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
154 <div class="refsect1">
155 <a name="GDBusMessage.properties"></a><h2>Properties</h2>
156 <pre class="synopsis">
157 "<a class="link" href="GDBusMessage.html#GDBusMessage--locked" title='The "locked" property'>locked</a>" <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
160 <div class="refsect1">
161 <a name="GDBusMessage.description"></a><h2>Description</h2>
163 A type for representing D-Bus messages that can be sent or received
164 on a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.
167 <div class="refsect1">
168 <a name="GDBusMessage.details"></a><h2>Details</h2>
169 <div class="refsect2">
170 <a name="GDBusMessage-struct"></a><h3>GDBusMessage</h3>
171 <pre class="programlisting">typedef struct _GDBusMessage GDBusMessage;</pre>
173 The <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> structure contains only private data and should
174 only be accessed using the provided API.
176 <p class="since">Since 2.26</p>
179 <div class="refsect2">
180 <a name="GDBusMessageType"></a><h3>enum GDBusMessageType</h3>
181 <pre class="programlisting">typedef enum {
182 G_DBUS_MESSAGE_TYPE_INVALID,
183 G_DBUS_MESSAGE_TYPE_METHOD_CALL,
184 G_DBUS_MESSAGE_TYPE_METHOD_RETURN,
185 G_DBUS_MESSAGE_TYPE_ERROR,
186 G_DBUS_MESSAGE_TYPE_SIGNAL
190 Message types used in <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.
192 <div class="variablelist"><table border="0">
193 <col align="left" valign="top">
196 <td><p><a name="G-DBUS-MESSAGE-TYPE-INVALID:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_TYPE_INVALID</code></span></p></td>
197 <td>Message is of invalid type.
201 <td><p><a name="G-DBUS-MESSAGE-TYPE-METHOD-CALL:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_CALL</code></span></p></td>
206 <td><p><a name="G-DBUS-MESSAGE-TYPE-METHOD-RETURN:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_RETURN</code></span></p></td>
211 <td><p><a name="G-DBUS-MESSAGE-TYPE-ERROR:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_TYPE_ERROR</code></span></p></td>
216 <td><p><a name="G-DBUS-MESSAGE-TYPE-SIGNAL:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_TYPE_SIGNAL</code></span></p></td>
222 <p class="since">Since 2.26</p>
225 <div class="refsect2">
226 <a name="GDBusMessageFlags"></a><h3>enum GDBusMessageFlags</h3>
227 <pre class="programlisting">typedef enum {
228 G_DBUS_MESSAGE_FLAGS_NONE = 0,
229 G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED = (1<<0),
230 G_DBUS_MESSAGE_FLAGS_NO_AUTO_START = (1<<1)
234 Message flags used in <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.
236 <div class="variablelist"><table border="0">
237 <col align="left" valign="top">
240 <td><p><a name="G-DBUS-MESSAGE-FLAGS-NONE:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_FLAGS_NONE</code></span></p></td>
245 <td><p><a name="G-DBUS-MESSAGE-FLAGS-NO-REPLY-EXPECTED:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED</code></span></p></td>
246 <td>A reply is not expected.
250 <td><p><a name="G-DBUS-MESSAGE-FLAGS-NO-AUTO-START:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_FLAGS_NO_AUTO_START</code></span></p></td>
251 <td>The bus must not launch an
252 owner for the destination name in response to this message.
257 <p class="since">Since 2.26</p>
260 <div class="refsect2">
261 <a name="GDBusMessageHeaderField"></a><h3>enum GDBusMessageHeaderField</h3>
262 <pre class="programlisting">typedef enum {
263 G_DBUS_MESSAGE_HEADER_FIELD_INVALID,
264 G_DBUS_MESSAGE_HEADER_FIELD_PATH,
265 G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE,
266 G_DBUS_MESSAGE_HEADER_FIELD_MEMBER,
267 G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME,
268 G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL,
269 G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION,
270 G_DBUS_MESSAGE_HEADER_FIELD_SENDER,
271 G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE,
272 G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS
273 } GDBusMessageHeaderField;
276 Header fields used in <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.
278 <div class="variablelist"><table border="0">
279 <col align="left" valign="top">
282 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-INVALID:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_INVALID</code></span></p></td>
283 <td>Not a valid header field.
287 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-PATH:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_PATH</code></span></p></td>
292 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-INTERFACE:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE</code></span></p></td>
293 <td>The interface name.
297 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-MEMBER:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_MEMBER</code></span></p></td>
298 <td>The method or signal name.
302 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-ERROR-NAME:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME</code></span></p></td>
303 <td>The name of the error that occurred.
307 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-REPLY-SERIAL:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL</code></span></p></td>
308 <td>The serial number the message is a reply to.
312 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-DESTINATION:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION</code></span></p></td>
313 <td>The name the message is intended for.
317 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-SENDER:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SENDER</code></span></p></td>
318 <td>Unique name of the sender of the message (filled in by the bus).
322 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-SIGNATURE:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE</code></span></p></td>
323 <td>The signature of the message body.
327 <td><p><a name="G-DBUS-MESSAGE-HEADER-FIELD-NUM-UNIX-FDS:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS</code></span></p></td>
328 <td>The number of UNIX file descriptors that accompany the message.
333 <p class="since">Since 2.26</p>
336 <div class="refsect2">
337 <a name="GDBusMessageByteOrder"></a><h3>enum GDBusMessageByteOrder</h3>
338 <pre class="programlisting">typedef enum {
339 G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN = 'B',
340 G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN = 'l'
341 } GDBusMessageByteOrder;
344 Enumeration used to describe the byte order of a D-Bus message.
346 <div class="variablelist"><table border="0">
347 <col align="left" valign="top">
350 <td><p><a name="G-DBUS-MESSAGE-BYTE-ORDER-BIG-ENDIAN:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN</code></span></p></td>
351 <td>The byte order is big endian.
355 <td><p><a name="G-DBUS-MESSAGE-BYTE-ORDER-LITTLE-ENDIAN:CAPS"></a><span class="term"><code class="literal">G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN</code></span></p></td>
356 <td>The byte order is little endian.
361 <p class="since">Since 2.26</p>
364 <div class="refsect2">
365 <a name="g-dbus-message-new"></a><h3>g_dbus_message_new ()</h3>
366 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
368 Creates a new empty <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.
370 <div class="variablelist"><table border="0">
371 <col align="left" valign="top">
373 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
374 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
377 <p class="since">Since 2.26</p>
380 <div class="refsect2">
381 <a name="g-dbus-message-new-signal"></a><h3>g_dbus_message_new_signal ()</h3>
382 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_signal (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>,
383 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
384 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal</code></em>);</pre>
386 Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> for a signal emission.
388 <div class="variablelist"><table border="0">
389 <col align="left" valign="top">
392 <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
393 <td>A valid object path.</td>
396 <td><p><span class="term"><em class="parameter"><code>interface_</code></em> :</span></p></td>
397 <td>A valid D-Bus interface name.</td>
400 <td><p><span class="term"><em class="parameter"><code>signal</code></em> :</span></p></td>
401 <td>A valid signal name.</td>
404 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
405 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
409 <p class="since">Since 2.26</p>
412 <div class="refsect2">
413 <a name="g-dbus-message-new-method-call"></a><h3>g_dbus_message_new_method_call ()</h3>
414 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_method_call (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
415 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>,
416 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_</code></em>,
417 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *method</code></em>);</pre>
419 Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> for a method call.
421 <div class="variablelist"><table border="0">
422 <col align="left" valign="top">
425 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
426 <td>A valid D-Bus name or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
430 <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
431 <td>A valid object path.</td>
434 <td><p><span class="term"><em class="parameter"><code>interface_</code></em> :</span></p></td>
435 <td>A valid D-Bus interface name or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
439 <td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
440 <td>A valid method name.</td>
443 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
444 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
448 <p class="since">Since 2.26</p>
451 <div class="refsect2">
452 <a name="g-dbus-message-new-method-reply"></a><h3>g_dbus_message_new_method_reply ()</h3>
453 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_method_reply (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>);</pre>
455 Creates a new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> that is a reply to <em class="parameter"><code>method_call_message</code></em>.
457 <div class="variablelist"><table border="0">
458 <col align="left" valign="top">
461 <td><p><span class="term"><em class="parameter"><code>method_call_message</code></em> :</span></p></td>
462 <td>A message of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-METHOD-CALL:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_CALL</code></a> to
463 create a reply message to.</td>
466 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
468 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
473 <p class="since">Since 2.26</p>
476 <div class="refsect2">
477 <a name="g-dbus-message-new-method-error"></a><h3>g_dbus_message_new_method_error ()</h3>
478 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * 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>,
479 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
480 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
481 <em class="parameter"><code>...</code></em>);</pre>
483 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>.
485 <div class="variablelist"><table border="0">
486 <col align="left" valign="top">
489 <td><p><span class="term"><em class="parameter"><code>method_call_message</code></em> :</span></p></td>
490 <td>A message of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-METHOD-CALL:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_CALL</code></a> to
491 create a reply message to.</td>
494 <td><p><span class="term"><em class="parameter"><code>error_name</code></em> :</span></p></td>
495 <td>A valid D-Bus error name.</td>
498 <td><p><span class="term"><em class="parameter"><code>error_message_format</code></em> :</span></p></td>
499 <td>The D-Bus error message in a <code class="function">printf()</code> format.</td>
502 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
503 <td>Arguments for <em class="parameter"><code>error_message_format</code></em>.</td>
506 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
507 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
512 <p class="since">Since 2.26</p>
515 <div class="refsect2">
516 <a name="g-dbus-message-new-method-error-valist"></a><h3>g_dbus_message_new_method_error_valist ()</h3>
517 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_method_error_valist
518 (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
519 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
520 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message_format</code></em>,
521 <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
523 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.
525 <div class="variablelist"><table border="0">
526 <col align="left" valign="top">
529 <td><p><span class="term"><em class="parameter"><code>method_call_message</code></em> :</span></p></td>
530 <td>A message of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-METHOD-CALL:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_CALL</code></a> to
531 create a reply message to.</td>
534 <td><p><span class="term"><em class="parameter"><code>error_name</code></em> :</span></p></td>
535 <td>A valid D-Bus error name.</td>
538 <td><p><span class="term"><em class="parameter"><code>error_message_format</code></em> :</span></p></td>
539 <td>The D-Bus error message in a <code class="function">printf()</code> format.</td>
542 <td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
543 <td>Arguments for <em class="parameter"><code>error_message_format</code></em>.</td>
546 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
547 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
552 <p class="since">Since 2.26</p>
555 <div class="refsect2">
556 <a name="g-dbus-message-new-method-error-literal"></a><h3>g_dbus_message_new_method_error_literal ()</h3>
557 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_method_error_literal
558 (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *method_call_message</code></em>,
559 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_name</code></em>,
560 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *error_message</code></em>);</pre>
562 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>.
564 <div class="variablelist"><table border="0">
565 <col align="left" valign="top">
568 <td><p><span class="term"><em class="parameter"><code>method_call_message</code></em> :</span></p></td>
569 <td>A message of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-METHOD-CALL:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_METHOD_CALL</code></a> to
570 create a reply message to.</td>
573 <td><p><span class="term"><em class="parameter"><code>error_name</code></em> :</span></p></td>
574 <td>A valid D-Bus error name.</td>
577 <td><p><span class="term"><em class="parameter"><code>error_message</code></em> :</span></p></td>
578 <td>The D-Bus error message.</td>
581 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
582 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>. Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
587 <p class="since">Since 2.26</p>
590 <div class="refsect2">
591 <a name="g-dbus-message-print"></a><h3>g_dbus_message_print ()</h3>
592 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>,
593 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> indent</code></em>);</pre>
595 Produces a human-readable multi-line description of <em class="parameter"><code>message</code></em>.
598 The contents of the description has no ABI guarantees, the contents
599 and formatting is subject to change at any time. Typical output
600 looks something like this:
602 <pre class="programlisting">
608 path -> objectpath '/org/gtk/GDBus/TestObject'
609 interface -> 'org.gtk.GDBus.TestInterface'
610 member -> 'GimmeStdout'
611 destination -> ':1.146'
613 UNIX File Descriptors:
619 <pre class="programlisting">
621 Flags: no-reply-expected
625 reply-serial -> uint32 4
626 destination -> ':1.159'
627 sender -> ':1.146'
628 num-unix-fds -> uint32 1
630 UNIX File Descriptors:
631 fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
635 <div class="variablelist"><table border="0">
636 <col align="left" valign="top">
639 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
640 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
643 <td><p><span class="term"><em class="parameter"><code>indent</code></em> :</span></p></td>
644 <td>Indentation level.</td>
647 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
648 <td>A string that should be freed with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
652 <p class="since">Since 2.26</p>
655 <div class="refsect2">
656 <a name="g-dbus-message-get-locked"></a><h3>g_dbus_message_get_locked ()</h3>
657 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 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>
659 Checks whether <em class="parameter"><code>message</code></em> is locked. To monitor changes to this
660 value, conncet to the <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal to listen for changes
661 on the <a class="link" href="GDBusMessage.html#GDBusMessage--locked" title='The "locked" property'><span class="type">"locked"</span></a> property.
663 <div class="variablelist"><table border="0">
664 <col align="left" valign="top">
667 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
668 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
671 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
673 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>message</code></em> is locked, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
677 <p class="since">Since 2.26</p>
680 <div class="refsect2">
681 <a name="g-dbus-message-lock"></a><h3>g_dbus_message_lock ()</h3>
682 <pre class="programlisting"><span class="returnvalue">void</span> g_dbus_message_lock (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
684 If <em class="parameter"><code>message</code></em> is locked, does nothing. Otherwise locks the message.
686 <div class="variablelist"><table border="0">
687 <col align="left" valign="top">
689 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
690 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
693 <p class="since">Since 2.26</p>
696 <div class="refsect2">
697 <a name="g-dbus-message-copy"></a><h3>g_dbus_message_copy ()</h3>
698 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * 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>,
699 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
701 Copies <em class="parameter"><code>message</code></em>. The copy is a deep copy and the returned
702 <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> is completely identical except that it is guaranteed
706 This operation can fail if e.g. <em class="parameter"><code>message</code></em> contains file descriptors
707 and the per-process or system-wide open files limit is reached.
709 <div class="variablelist"><table border="0">
710 <col align="left" valign="top">
713 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
714 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
717 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
718 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
721 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
722 <td>A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set.
723 Free with <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
728 <p class="since">Since 2.26</p>
731 <div class="refsect2">
732 <a name="g-dbus-message-get-byte-order"></a><h3>g_dbus_message_get_byte_order ()</h3>
733 <pre class="programlisting"><a class="link" href="GDBusMessage.html#GDBusMessageByteOrder" title="enum GDBusMessageByteOrder"><span class="returnvalue">GDBusMessageByteOrder</span></a> g_dbus_message_get_byte_order (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
735 Gets the byte order of <em class="parameter"><code>message</code></em>.
737 <div class="variablelist"><table border="0">
738 <col align="left" valign="top">
741 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
742 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
745 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
746 <td>The byte order.</td>
752 <div class="refsect2">
753 <a name="g-dbus-message-set-byte-order"></a><h3>g_dbus_message_set_byte_order ()</h3>
754 <pre class="programlisting"><span class="returnvalue">void</span> g_dbus_message_set_byte_order (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
755 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageByteOrder" title="enum GDBusMessageByteOrder"><span class="type">GDBusMessageByteOrder</span></a> byte_order</code></em>);</pre>
757 Sets the byte order of <em class="parameter"><code>message</code></em>.
759 <div class="variablelist"><table border="0">
760 <col align="left" valign="top">
763 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
764 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
767 <td><p><span class="term"><em class="parameter"><code>byte_order</code></em> :</span></p></td>
768 <td>The byte order.</td>
774 <div class="refsect2">
775 <a name="g-dbus-message-get-message-type"></a><h3>g_dbus_message_get_message_type ()</h3>
776 <pre class="programlisting"><a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="returnvalue">GDBusMessageType</span></a> g_dbus_message_get_message_type (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
778 Gets the type of <em class="parameter"><code>message</code></em>.
780 <div class="variablelist"><table border="0">
781 <col align="left" valign="top">
784 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
785 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
788 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
789 <td>A 8-bit unsigned integer (typically a value from the <a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="type">GDBusMessageType</span></a> enumeration).</td>
793 <p class="since">Since 2.26</p>
796 <div class="refsect2">
797 <a name="g-dbus-message-set-message-type"></a><h3>g_dbus_message_set_message_type ()</h3>
798 <pre class="programlisting"><span class="returnvalue">void</span> g_dbus_message_set_message_type (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
799 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="type">GDBusMessageType</span></a> type</code></em>);</pre>
801 Sets <em class="parameter"><code>message</code></em> to be of <em class="parameter"><code>type</code></em>.
803 <div class="variablelist"><table border="0">
804 <col align="left" valign="top">
807 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
808 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
811 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
812 <td>A 8-bit unsigned integer (typically a value from the <a class="link" href="GDBusMessage.html#GDBusMessageType" title="enum GDBusMessageType"><span class="type">GDBusMessageType</span></a> enumeration).</td>
816 <p class="since">Since 2.26</p>
819 <div class="refsect2">
820 <a name="g-dbus-message-get-serial"></a><h3>g_dbus_message_get_serial ()</h3>
821 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> 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>
823 Gets the serial for <em class="parameter"><code>message</code></em>.
825 <div class="variablelist"><table border="0">
826 <col align="left" valign="top">
829 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
830 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
833 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
834 <td>A <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</td>
838 <p class="since">Since 2.26</p>
841 <div class="refsect2">
842 <a name="g-dbus-message-set-serial"></a><h3>g_dbus_message_set_serial ()</h3>
843 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
844 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> serial</code></em>);</pre>
846 Sets the serial for <em class="parameter"><code>message</code></em>.
848 <div class="variablelist"><table border="0">
849 <col align="left" valign="top">
852 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
853 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
856 <td><p><span class="term"><em class="parameter"><code>serial</code></em> :</span></p></td>
857 <td>A <a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a>.</td>
861 <p class="since">Since 2.26</p>
864 <div class="refsect2">
865 <a name="g-dbus-message-get-flags"></a><h3>g_dbus_message_get_flags ()</h3>
866 <pre class="programlisting"><a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="returnvalue">GDBusMessageFlags</span></a> g_dbus_message_get_flags (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
868 Gets the flags for <em class="parameter"><code>message</code></em>.
870 <div class="variablelist"><table border="0">
871 <col align="left" valign="top">
874 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
875 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
878 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
879 <td>Flags that are set (typically values from the <a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="type">GDBusMessageFlags</span></a> enumeration bitwise ORed together).</td>
883 <p class="since">Since 2.26</p>
886 <div class="refsect2">
887 <a name="g-dbus-message-set-flags"></a><h3>g_dbus_message_set_flags ()</h3>
888 <pre class="programlisting"><span class="returnvalue">void</span> g_dbus_message_set_flags (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
889 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="type">GDBusMessageFlags</span></a> flags</code></em>);</pre>
891 Sets the flags to set on <em class="parameter"><code>message</code></em>.
893 <div class="variablelist"><table border="0">
894 <col align="left" valign="top">
897 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
898 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
901 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
902 <td>Flags for <em class="parameter"><code>message</code></em> that are set (typically values from the <a class="link" href="GDBusMessage.html#GDBusMessageFlags" title="enum GDBusMessageFlags"><span class="type">GDBusMessageFlags</span></a>
903 enumeration bitwise ORed together).</td>
907 <p class="since">Since 2.26</p>
910 <div class="refsect2">
911 <a name="g-dbus-message-get-body"></a><h3>g_dbus_message_get_body ()</h3>
912 <pre class="programlisting"><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * 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>
914 Gets the body of a message.
916 <div class="variablelist"><table border="0">
917 <col align="left" valign="top">
920 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
921 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
924 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
925 <td>A <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> or <a href="./../glib/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>.</td>
929 <p class="since">Since 2.26</p>
932 <div class="refsect2">
933 <a name="g-dbus-message-set-body"></a><h3>g_dbus_message_set_body ()</h3>
934 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
935 <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *body</code></em>);</pre>
937 Sets the body <em class="parameter"><code>message</code></em>. As a side-effect the
938 <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
939 type string of <em class="parameter"><code>body</code></em> (or cleared if <em class="parameter"><code>body</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).
942 If <em class="parameter"><code>body</code></em> is floating, <em class="parameter"><code>message</code></em> assumes ownership of <em class="parameter"><code>body</code></em>.
944 <div class="variablelist"><table border="0">
945 <col align="left" valign="top">
948 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
949 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
952 <td><p><span class="term"><em class="parameter"><code>body</code></em> :</span></p></td>
953 <td>Either <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> that is a tuple.</td>
957 <p class="since">Since 2.26</p>
960 <div class="refsect2">
961 <a name="g-dbus-message-get-unix-fd-list"></a><h3>g_dbus_message_get_unix_fd_list ()</h3>
962 <pre class="programlisting"><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="returnvalue">GUnixFDList</span></a> * g_dbus_message_get_unix_fd_list (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>);</pre>
964 Gets the UNIX file descriptors associated with <em class="parameter"><code>message</code></em>, if any.
967 This method is only available on UNIX.
969 <div class="variablelist"><table border="0">
970 <col align="left" valign="top">
973 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
974 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
977 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
978 <td>A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file descriptors are
979 associated. Do not free, this object is owned by <em class="parameter"><code>message</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
984 <p class="since">Since 2.26</p>
987 <div class="refsect2">
988 <a name="g-dbus-message-set-unix-fd-list"></a><h3>g_dbus_message_set_unix_fd_list ()</h3>
989 <pre class="programlisting"><span class="returnvalue">void</span> g_dbus_message_set_unix_fd_list (<em class="parameter"><code><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> *message</code></em>,
990 <em class="parameter"><code><a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> *fd_list</code></em>);</pre>
992 Sets the UNIX file descriptors associated with <em class="parameter"><code>message</code></em>. As a
993 side-effect 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
994 field is set to the number of fds in <em class="parameter"><code>fd_list</code></em> (or cleared if
995 <em class="parameter"><code>fd_list</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).
998 This method is only available on UNIX.
1000 <div class="variablelist"><table border="0">
1001 <col align="left" valign="top">
1004 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1005 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1008 <td><p><span class="term"><em class="parameter"><code>fd_list</code></em> :</span></p></td>
1009 <td>A <a class="link" href="GUnixFDList.html" title="GUnixFDList"><span class="type">GUnixFDList</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1014 <p class="since">Since 2.26</p>
1017 <div class="refsect2">
1018 <a name="g-dbus-message-get-num-unix-fds"></a><h3>g_dbus_message_get_num_unix_fds ()</h3>
1019 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> 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>
1021 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.
1023 <div class="variablelist"><table border="0">
1024 <col align="left" valign="top">
1027 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1028 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1031 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1036 <p class="since">Since 2.26</p>
1039 <div class="refsect2">
1040 <a name="g-dbus-message-set-num-unix-fds"></a><h3>g_dbus_message_set_num_unix_fds ()</h3>
1041 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1042 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1044 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.
1046 <div class="variablelist"><table border="0">
1047 <col align="left" valign="top">
1050 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1051 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1054 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1055 <td>The value to set.</td>
1059 <p class="since">Since 2.26</p>
1062 <div class="refsect2">
1063 <a name="g-dbus-message-get-header-fields"></a><h3>g_dbus_message_get_header_fields ()</h3>
1064 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * 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>
1066 Gets an array of all header fields on <em class="parameter"><code>message</code></em> that are set.
1068 <div class="variablelist"><table border="0">
1069 <col align="left" valign="top">
1072 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1073 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1076 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1077 <td>An array of header fields
1078 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
1079 is a <a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a>. Free with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
1084 <p class="since">Since 2.26</p>
1087 <div class="refsect2">
1088 <a name="g-dbus-message-get-header"></a><h3>g_dbus_message_get_header ()</h3>
1089 <pre class="programlisting"><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * 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>,
1090 <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>
1092 Gets a header field on <em class="parameter"><code>message</code></em>.
1094 <div class="variablelist"><table border="0">
1095 <col align="left" valign="top">
1098 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1099 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1102 <td><p><span class="term"><em class="parameter"><code>header_field</code></em> :</span></p></td>
1103 <td>A 8-bit unsigned integer (typically a value from the <a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> enumeration)</td>
1106 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1107 <td>A <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> with the value if the header was found, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1108 otherwise. Do not free, it is owned by <em class="parameter"><code>message</code></em>.</td>
1112 <p class="since">Since 2.26</p>
1115 <div class="refsect2">
1116 <a name="g-dbus-message-set-header"></a><h3>g_dbus_message_set_header ()</h3>
1117 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1118 <em class="parameter"><code><a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> header_field</code></em>,
1119 <em class="parameter"><code><a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1121 Sets a header field on <em class="parameter"><code>message</code></em>.
1124 If <em class="parameter"><code>value</code></em> is floating, <em class="parameter"><code>message</code></em> assumes ownership of <em class="parameter"><code>value</code></em>.
1126 <div class="variablelist"><table border="0">
1127 <col align="left" valign="top">
1130 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1131 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1134 <td><p><span class="term"><em class="parameter"><code>header_field</code></em> :</span></p></td>
1135 <td>A 8-bit unsigned integer (typically a value from the <a class="link" href="GDBusMessage.html#GDBusMessageHeaderField" title="enum GDBusMessageHeaderField"><span class="type">GDBusMessageHeaderField</span></a> enumeration)</td>
1138 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1139 <td>A <a href="./../glib/glib/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to set the header field or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the header field. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1144 <p class="since">Since 2.26</p>
1147 <div class="refsect2">
1148 <a name="g-dbus-message-get-destination"></a><h3>g_dbus_message_get_destination ()</h3>
1149 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1151 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.
1153 <div class="variablelist"><table border="0">
1154 <col align="left" valign="top">
1157 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1158 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1161 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1166 <p class="since">Since 2.26</p>
1169 <div class="refsect2">
1170 <a name="g-dbus-message-set-destination"></a><h3>g_dbus_message_set_destination ()</h3>
1171 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1172 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1174 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.
1176 <div class="variablelist"><table border="0">
1177 <col align="left" valign="top">
1180 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1181 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1184 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1185 <td>The value to set.</td>
1189 <p class="since">Since 2.26</p>
1192 <div class="refsect2">
1193 <a name="g-dbus-message-get-error-name"></a><h3>g_dbus_message_get_error_name ()</h3>
1194 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1196 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.
1198 <div class="variablelist"><table border="0">
1199 <col align="left" valign="top">
1202 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1203 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1206 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1211 <p class="since">Since 2.26</p>
1214 <div class="refsect2">
1215 <a name="g-dbus-message-set-error-name"></a><h3>g_dbus_message_set_error_name ()</h3>
1216 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1217 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1219 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.
1221 <div class="variablelist"><table border="0">
1222 <col align="left" valign="top">
1225 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1226 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1229 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1230 <td>The value to set.</td>
1234 <p class="since">Since 2.26</p>
1237 <div class="refsect2">
1238 <a name="g-dbus-message-get-interface"></a><h3>g_dbus_message_get_interface ()</h3>
1239 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1241 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.
1243 <div class="variablelist"><table border="0">
1244 <col align="left" valign="top">
1247 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1248 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1251 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1256 <p class="since">Since 2.26</p>
1259 <div class="refsect2">
1260 <a name="g-dbus-message-set-interface"></a><h3>g_dbus_message_set_interface ()</h3>
1261 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1262 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1264 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.
1266 <div class="variablelist"><table border="0">
1267 <col align="left" valign="top">
1270 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1271 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1274 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1275 <td>The value to set.</td>
1279 <p class="since">Since 2.26</p>
1282 <div class="refsect2">
1283 <a name="g-dbus-message-get-member"></a><h3>g_dbus_message_get_member ()</h3>
1284 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1286 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.
1288 <div class="variablelist"><table border="0">
1289 <col align="left" valign="top">
1292 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1293 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1296 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1301 <p class="since">Since 2.26</p>
1304 <div class="refsect2">
1305 <a name="g-dbus-message-set-member"></a><h3>g_dbus_message_set_member ()</h3>
1306 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1307 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1309 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.
1311 <div class="variablelist"><table border="0">
1312 <col align="left" valign="top">
1315 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1316 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1319 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1320 <td>The value to set.</td>
1324 <p class="since">Since 2.26</p>
1327 <div class="refsect2">
1328 <a name="g-dbus-message-get-path"></a><h3>g_dbus_message_get_path ()</h3>
1329 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1331 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.
1333 <div class="variablelist"><table border="0">
1334 <col align="left" valign="top">
1337 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1338 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1341 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1346 <p class="since">Since 2.26</p>
1349 <div class="refsect2">
1350 <a name="g-dbus-message-set-path"></a><h3>g_dbus_message_set_path ()</h3>
1351 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1352 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1354 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.
1356 <div class="variablelist"><table border="0">
1357 <col align="left" valign="top">
1360 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1361 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1364 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1365 <td>The value to set.</td>
1369 <p class="since">Since 2.26</p>
1372 <div class="refsect2">
1373 <a name="g-dbus-message-get-reply-serial"></a><h3>g_dbus_message_get_reply_serial ()</h3>
1374 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> 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>
1376 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.
1378 <div class="variablelist"><table border="0">
1379 <col align="left" valign="top">
1382 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1383 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1386 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1391 <p class="since">Since 2.26</p>
1394 <div class="refsect2">
1395 <a name="g-dbus-message-set-reply-serial"></a><h3>g_dbus_message_set_reply_serial ()</h3>
1396 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1397 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> value</code></em>);</pre>
1399 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.
1401 <div class="variablelist"><table border="0">
1402 <col align="left" valign="top">
1405 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1406 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1409 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1410 <td>The value to set.</td>
1414 <p class="since">Since 2.26</p>
1417 <div class="refsect2">
1418 <a name="g-dbus-message-get-sender"></a><h3>g_dbus_message_get_sender ()</h3>
1419 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1421 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.
1423 <div class="variablelist"><table border="0">
1424 <col align="left" valign="top">
1427 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1428 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1431 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1436 <p class="since">Since 2.26</p>
1439 <div class="refsect2">
1440 <a name="g-dbus-message-set-sender"></a><h3>g_dbus_message_set_sender ()</h3>
1441 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1442 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1444 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.
1446 <div class="variablelist"><table border="0">
1447 <col align="left" valign="top">
1450 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1451 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1454 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1455 <td>The value to set.</td>
1459 <p class="since">Since 2.26</p>
1462 <div class="refsect2">
1463 <a name="g-dbus-message-get-signature"></a><h3>g_dbus_message_get_signature ()</h3>
1464 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1466 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.
1468 <div class="variablelist"><table border="0">
1469 <col align="left" valign="top">
1472 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1473 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1476 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1481 <p class="since">Since 2.26</p>
1484 <div class="refsect2">
1485 <a name="g-dbus-message-set-signature"></a><h3>g_dbus_message_set_signature ()</h3>
1486 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
1487 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1489 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.
1491 <div class="variablelist"><table border="0">
1492 <col align="left" valign="top">
1495 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1496 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1499 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1500 <td>The value to set.</td>
1504 <p class="since">Since 2.26</p>
1507 <div class="refsect2">
1508 <a name="g-dbus-message-get-arg0"></a><h3>g_dbus_message_get_arg0 ()</h3>
1509 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
1511 Convenience to get the first item in the body of <em class="parameter"><code>message</code></em>.
1513 <div class="variablelist"><table border="0">
1514 <col align="left" valign="top">
1517 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1518 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1521 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1522 <td>The string item or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the first item in the body of
1523 <em class="parameter"><code>message</code></em> is not a string.</td>
1527 <p class="since">Since 2.26</p>
1530 <div class="refsect2">
1531 <a name="g-dbus-message-to-blob"></a><h3>g_dbus_message_to_blob ()</h3>
1532 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * 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>,
1533 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *out_size</code></em>,
1534 <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
1535 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1537 Serializes <em class="parameter"><code>message</code></em> to a blob. The byte order returned by
1538 <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.
1540 <div class="variablelist"><table border="0">
1541 <col align="left" valign="top">
1544 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1545 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1548 <td><p><span class="term"><em class="parameter"><code>out_size</code></em> :</span></p></td>
1549 <td>Return location for size of generated blob.</td>
1552 <td><p><span class="term"><em class="parameter"><code>capabilities</code></em> :</span></p></td>
1553 <td>A <a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> describing what protocol features are supported.</td>
1556 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1557 <td>Return location for error.</td>
1560 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1562 valid binary D-Bus message of <em class="parameter"><code>out_size</code></em> bytes generated by <em class="parameter"><code>message</code></em>
1563 or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. Free with <a href="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <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>
1568 <p class="since">Since 2.26</p>
1571 <div class="refsect2">
1572 <a name="g-dbus-message-bytes-needed"></a><h3>g_dbus_message_bytes_needed ()</h3>
1573 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a> g_dbus_message_bytes_needed (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
1574 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
1575 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1577 Utility function to calculate how many bytes are needed to
1578 completely deserialize the D-Bus message stored at <em class="parameter"><code>blob</code></em>.
1580 <div class="variablelist"><table border="0">
1581 <col align="left" valign="top">
1584 <td><p><span class="term"><em class="parameter"><code>blob</code></em> :</span></p></td>
1585 <td>A blob represent a binary D-Bus message. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=blob_len][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span>
1589 <td><p><span class="term"><em class="parameter"><code>blob_len</code></em> :</span></p></td>
1590 <td>The length of <em class="parameter"><code>blob</code></em> (must be at least 16).</td>
1593 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1594 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1597 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1598 <td>Number of bytes needed or -1 if <em class="parameter"><code>error</code></em> is set (e.g. if
1599 <em class="parameter"><code>blob</code></em> contains invalid data or not enough data is available to
1600 determine the size).</td>
1604 <p class="since">Since 2.26</p>
1607 <div class="refsect2">
1608 <a name="g-dbus-message-new-from-blob"></a><h3>g_dbus_message_new_from_blob ()</h3>
1609 <pre class="programlisting"><a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="returnvalue">GDBusMessage</span></a> * g_dbus_message_new_from_blob (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *blob</code></em>,
1610 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> blob_len</code></em>,
1611 <em class="parameter"><code><a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> capabilities</code></em>,
1612 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1614 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>. The byte
1615 order that the message was in can be retrieved using
1616 <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>.
1618 <div class="variablelist"><table border="0">
1619 <col align="left" valign="top">
1622 <td><p><span class="term"><em class="parameter"><code>blob</code></em> :</span></p></td>
1623 <td>A blob represent a binary D-Bus message. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=blob_len][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span>
1627 <td><p><span class="term"><em class="parameter"><code>blob_len</code></em> :</span></p></td>
1628 <td>The length of <em class="parameter"><code>blob</code></em>.</td>
1631 <td><p><span class="term"><em class="parameter"><code>capabilities</code></em> :</span></p></td>
1632 <td>A <a class="link" href="GDBusConnection.html#GDBusCapabilityFlags" title="enum GDBusCapabilityFlags"><span class="type">GDBusCapabilityFlags</span></a> describing what protocol features are supported.</td>
1635 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1636 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1639 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1640 <td>A new <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. Free with
1641 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
1645 <p class="since">Since 2.26</p>
1648 <div class="refsect2">
1649 <a name="g-dbus-message-to-gerror"></a><h3>g_dbus_message_to_gerror ()</h3>
1650 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 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>,
1651 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1653 If <em class="parameter"><code>message</code></em> 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
1654 nothing and returns <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
1657 Otherwise this method encodes the error in <em class="parameter"><code>message</code></em> as a <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
1658 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
1659 <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> as
1660 well as the first string item in <em class="parameter"><code>message</code></em>'s body.
1662 <div class="variablelist"><table border="0">
1663 <col align="left" valign="top">
1666 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
1667 <td>A <a class="link" href="GDBusMessage.html" title="GDBusMessage"><span class="type">GDBusMessage</span></a>.</td>
1670 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1671 <td>The <a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to set.</td>
1674 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1676 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em> was set, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1680 <p class="since">Since 2.26</p>
1683 <div class="refsect1">
1684 <a name="GDBusMessage.property-details"></a><h2>Property Details</h2>
1685 <div class="refsect2">
1686 <a name="GDBusMessage--locked"></a><h3>The <code class="literal">"locked"</code> property</h3>
1687 <pre class="programlisting"> "locked" <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
1688 <p>Whether the message is locked.</p>
1689 <p>Default value: FALSE</p>
1693 <div class="footer">
1695 Generated by GTK-Doc V1.18</div>