2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
<!ENTITY dbus-binding-tool SYSTEM "dbus-binding-tool.xml">
5
<!ENTITY version SYSTEM "version.xml">
7
<refentry id="dbus-glib-DBusGMessage">
9
<refentrytitle id="top_of_page">DBusGMessage</refentrytitle>
10
<manvolnum>3</manvolnum>
11
<refmiscinfo>DBUS-GLIB Library</refmiscinfo>
15
<refname>DBusGMessage</refname>
16
<refpurpose>DBus Message</refpurpose>
17
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
20
<title>Stability Level</title>
21
Stable, unless otherwise indicated
24
<refsynopsisdiv id="synopsis">
25
<title id="synopsis.title">Synopsis</title>
31
<link linkend="DBusGMessage">DBusGMessage</link>;
32
<link linkend="DBusGMessage">DBusGMessage</link>* <link linkend="dbus-g-message-ref">dbus_g_message_ref</link> (<link linkend="DBusGMessage">DBusGMessage</link> *message);
33
<link linkend="void">void</link> <link linkend="dbus-g-message-unref">dbus_g_message_unref</link> (<link linkend="DBusGMessage">DBusGMessage</link> *message);
34
<link linkend="DBusMessage">DBusMessage</link>* <link linkend="dbus-g-message-get-message">dbus_g_message_get_message</link> (<link linkend="DBusGMessage">DBusGMessage</link> *gmessage);
48
<title id="desc.title">Description</title>
50
A <link linkend="DBusGConnection"><type>DBusGConnection</type></link> is a boxed type abstracting a DBusMessage.</para>
56
<refsect1 id="details">
57
<title id="details.title">Details</title>
59
<title><anchor id="DBusGMessage" role="struct"/>DBusGMessage</title>
60
<indexterm><primary>DBusGMessage</primary></indexterm><programlisting>typedef struct _DBusGMessage DBusGMessage;</programlisting>
65
<title><anchor id="dbus-g-message-ref" role="function"/>dbus_g_message_ref ()</title>
66
<indexterm><primary>dbus_g_message_ref</primary></indexterm><programlisting><link linkend="DBusGMessage">DBusGMessage</link>* dbus_g_message_ref (<link linkend="DBusGMessage">DBusGMessage</link> *message);</programlisting>
68
Increment refcount on a <link linkend="DBusGMessage"><type>DBusGMessage</type></link></para>
71
</para><variablelist role="params">
72
<varlistentry><term><parameter>message</parameter> :</term>
74
</simpara></listitem></varlistentry>
75
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the message that was ref'd
76
</simpara></listitem></varlistentry>
77
</variablelist></refsect2>
79
<title><anchor id="dbus-g-message-unref" role="function"/>dbus_g_message_unref ()</title>
80
<indexterm><primary>dbus_g_message_unref</primary></indexterm><programlisting><link linkend="void">void</link> dbus_g_message_unref (<link linkend="DBusGMessage">DBusGMessage</link> *message);</programlisting>
82
Decrement refcount on a <link linkend="DBusGMessage"><type>DBusGMessage</type></link></para>
85
</para><variablelist role="params">
86
<varlistentry><term><parameter>message</parameter> :</term>
90
</simpara></listitem></varlistentry>
91
</variablelist></refsect2>
93
<title><anchor id="dbus-g-message-get-message" role="function"/>dbus_g_message_get_message ()</title>
94
<indexterm><primary>dbus_g_message_get_message</primary></indexterm><programlisting><link linkend="DBusMessage">DBusMessage</link>* dbus_g_message_get_message (<link linkend="DBusGMessage">DBusGMessage</link> *gmessage);</programlisting>
96
Get the <link linkend="DBusMessage"><type>DBusMessage</type></link> corresponding to this <link linkend="DBusGMessage"><type>DBusGMessage</type></link>.
97
The return value does not have its refcount incremented.</para>
100
</para><variablelist role="params">
101
<varlistentry><term><parameter>gmessage</parameter> :</term>
102
<listitem><simpara> a <link linkend="DBusGMessage"><type>DBusGMessage</type></link>
103
</simpara></listitem></varlistentry>
104
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="DBusMessage"><type>DBusMessage</type></link>
105
</simpara></listitem></varlistentry>
106
</variablelist></refsect2>
113
<title>See Also</title>
114
<link linkend="DBusMessage"><type>DBusMessage</type></link>