<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>glibmm: D-Bus API</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-extra.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">glibmm
 <span id="projectnumber">2.56.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#nested-classes">Classes</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">D-Bus API</div> </div>
</div><!--header-->
<div class="contents">
<p>API to use D-Bus services as a client or to implement a D-Bus service.
<a href="#details">More...</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Classes</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1AuthObserver.html">Gio::DBus::AuthObserver</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGio_1_1DBus_1_1AuthObserver.html" title="AuthObserver - An object used for authenticating connections. ">AuthObserver</a> - An object used for authenticating connections. <a href="classGio_1_1DBus_1_1AuthObserver.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A D-Bus <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a>. <a href="classGio_1_1DBus_1_1Connection.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1InterfaceVTable.html">Gio::DBus::InterfaceVTable</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">This represents a virtual table for handling properties and method calls for a D-Bus interface. <a href="classGio_1_1DBus_1_1InterfaceVTable.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1AnnotationInfo.html">Gio::DBus::AnnotationInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Stores information about an annotation. <a href="classGio_1_1DBus_1_1AnnotationInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1ArgInfo.html">Gio::DBus::ArgInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGio_1_1DBus_1_1ArgInfo.html" title="ArgInfo - Stores information about an argument for a method or a signal. ">ArgInfo</a> - Stores information about an argument for a method or a signal. <a href="classGio_1_1DBus_1_1ArgInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1MethodInfo.html">Gio::DBus::MethodInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Stores information about a method on an D-Bus interface. <a href="classGio_1_1DBus_1_1MethodInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SignalInfo.html">Gio::DBus::SignalInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Stores information about a signal on a D-Bus interface. <a href="classGio_1_1DBus_1_1SignalInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1PropertyInfo.html">Gio::DBus::PropertyInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Stores information about a property on a D-Bus interface. <a href="classGio_1_1DBus_1_1PropertyInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1InterfaceInfo.html">Gio::DBus::InterfaceInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Stores information about a D-Bus interface. <a href="classGio_1_1DBus_1_1InterfaceInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1NodeInfo.html">Gio::DBus::NodeInfo</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGio_1_1DBus_1_1NodeInfo.html" title="NodeInfo - Stores information about nodes in a remote object hierarchy. ">NodeInfo</a> - Stores information about nodes in a remote object hierarchy. <a href="classGio_1_1DBus_1_1NodeInfo.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1Message.html">Gio::DBus::Message</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A type for representing D-Bus messages that can be sent or received on a <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a>. <a href="classGio_1_1DBus_1_1Message.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1MethodInvocation.html">Gio::DBus::MethodInvocation</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">An <a class="el" href="classGio_1_1DBus_1_1Object.html" title="Object - Base type for D-Bus objects. ">Object</a> for handling remote calls. <a href="classGio_1_1DBus_1_1MethodInvocation.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1Proxy.html">Gio::DBus::Proxy</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A client-side proxy. <a href="classGio_1_1DBus_1_1Proxy.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1Server.html">Gio::DBus::Server</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">This is a helper for listening to and accepting D-Bus connections. <a href="classGio_1_1DBus_1_1Server.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1DBus_1_1SubtreeVTable.html">Gio::DBus::SubtreeVTable</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">This represents a virtual table for subtrees registered with <a class="el" href="classGio_1_1DBus_1_1Connection.html#ade98c63ff3e2ce7906ca4a2f63849e07" title="Registers a whole subtree of “dynamic” objects. ">Gio::DBus::Connection::register_subtree()</a>. <a href="classGio_1_1DBus_1_1SubtreeVTable.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:gab7640ad4f168b22492f5783148ad0d69"><td class="memItemLeft" align="right" valign="top">using </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">Gio::DBus::SlotBusAcquired</a> = <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> >&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> ></td></tr>
<tr class="memdesc:gab7640ad4f168b22492f5783148ad0d69"><td class="mdescLeft"> </td><td class="mdescRight">For example, void on_bus_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. <a href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">More...</a><br /></td></tr>
<tr class="separator:gab7640ad4f168b22492f5783148ad0d69"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga41021af407491538d8bfd65ab63f456a"><td class="memItemLeft" align="right" valign="top">using </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">Gio::DBus::SlotNameAcquired</a> = <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> >&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> ></td></tr>
<tr class="memdesc:ga41021af407491538d8bfd65ab63f456a"><td class="mdescLeft"> </td><td class="mdescRight">For example, void on_name_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. <a href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">More...</a><br /></td></tr>
<tr class="separator:ga41021af407491538d8bfd65ab63f456a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga69b58dba209c6b3a5f5f20fcd492c973"><td class="memItemLeft" align="right" valign="top">using </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">Gio::DBus::SlotNameLost</a> = <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> >&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> ></td></tr>
<tr class="memdesc:ga69b58dba209c6b3a5f5f20fcd492c973"><td class="mdescLeft"> </td><td class="mdescRight">For example, void on_name_lost(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. <a href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">More...</a><br /></td></tr>
<tr class="separator:ga69b58dba209c6b3a5f5f20fcd492c973"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga200acb252ecaa113828e23b9001a7a8e"><td class="memItemLeft" align="right" valign="top">using </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">Gio::DBus::SlotNameAppeared</a> = <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> >&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& ></td></tr>
<tr class="memdesc:ga200acb252ecaa113828e23b9001a7a8e"><td class="mdescLeft"> </td><td class="mdescRight">For example, void on_name_appeared(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name_owner);. <a href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">More...</a><br /></td></tr>
<tr class="separator:ga200acb252ecaa113828e23b9001a7a8e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga01da22e2e222d03382d93e6741be6935"><td class="memItemLeft" align="right" valign="top">using </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">Gio::DBus::SlotNameVanished</a> = <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>< void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> >&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> ></td></tr>
<tr class="memdesc:ga01da22e2e222d03382d93e6741be6935"><td class="mdescLeft"> </td><td class="mdescRight">For example, void on_name_vanished(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. <a href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">More...</a><br /></td></tr>
<tr class="separator:ga01da22e2e222d03382d93e6741be6935"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gab2c056ac3cce34b4a58df19166d48fae"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gab2c056ac3cce34b4a58df19166d48fae">Gio::DBus::Address::is_address</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:gab2c056ac3cce34b4a58df19166d48fae"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a D-Bus address. <a href="group__DBus.html#gab2c056ac3cce34b4a58df19166d48fae">More...</a><br /></td></tr>
<tr class="separator:gab2c056ac3cce34b4a58df19166d48fae"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214">Gio::DBus::Address::is_supported</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address)</td></tr>
<tr class="memdesc:ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"><td class="mdescLeft"> </td><td class="mdescRight">Like <a class="el" href="group__DBus.html#gab2c056ac3cce34b4a58df19166d48fae" title="Checks if string is a D-Bus address. ">is_address()</a> but also checks if the library supports the transports in <em>address</em> and that key/value pairs for each transport are valid. <a href="group__DBus.html#ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214">More...</a><br /></td></tr>
<tr class="separator:ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2d53e540686789c834cef9a3ac447bf4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4">Gio::DBus::Address::get_stream</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const <a class="el" href="namespaceGio.html#a62eda8192493461b01b1df06ca229bb7">SlotAsyncReady</a> slot, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable)</td></tr>
<tr class="memdesc:ga2d53e540686789c834cef9a3ac447bf4"><td class="mdescLeft"> </td><td class="mdescRight">Asynchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. <a href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4">More...</a><br /></td></tr>
<tr class="separator:ga2d53e540686789c834cef9a3ac447bf4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8fa5586dec918dfa553dab97f0f8e342"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1IOStream.html">IOStream</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga8fa5586dec918dfa553dab97f0f8e342">Gio::DBus::Address::get_stream_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& res, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& out_guid)</td></tr>
<tr class="memdesc:ga8fa5586dec918dfa553dab97f0f8e342"><td class="mdescLeft"> </td><td class="mdescRight">Finishes an operation started with <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. <a href="group__DBus.html#ga8fa5586dec918dfa553dab97f0f8e342">More...</a><br /></td></tr>
<tr class="separator:ga8fa5586dec918dfa553dab97f0f8e342"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7da9ac3910fa800a6a42b2667b1a0135"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1IOStream.html">IOStream</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga7da9ac3910fa800a6a42b2667b1a0135">Gio::DBus::Address::get_stream_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& res)</td></tr>
<tr class="memdesc:ga7da9ac3910fa800a6a42b2667b1a0135"><td class="mdescLeft"> </td><td class="mdescRight">Finishes an operation started with <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. <a href="group__DBus.html#ga7da9ac3910fa800a6a42b2667b1a0135">More...</a><br /></td></tr>
<tr class="separator:ga7da9ac3910fa800a6a42b2667b1a0135"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga95b08ddb9dedf51b585fa7a5da4f4233"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1IOStream.html">IOStream</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga95b08ddb9dedf51b585fa7a5da4f4233">Gio::DBus::Address::get_stream_sync</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& out_guid)</td></tr>
<tr class="memdesc:ga95b08ddb9dedf51b585fa7a5da4f4233"><td class="mdescLeft"> </td><td class="mdescRight">Synchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. <a href="group__DBus.html#ga95b08ddb9dedf51b585fa7a5da4f4233">More...</a><br /></td></tr>
<tr class="separator:ga95b08ddb9dedf51b585fa7a5da4f4233"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaec661c3dff45b4a5626b9dc1bc586b3d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1IOStream.html">IOStream</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaec661c3dff45b4a5626b9dc1bc586b3d">Gio::DBus::Address::get_stream_sync</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable)</td></tr>
<tr class="memdesc:gaec661c3dff45b4a5626b9dc1bc586b3d"><td class="mdescLeft"> </td><td class="mdescRight">Synchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. <a href="group__DBus.html#gaec661c3dff45b4a5626b9dc1bc586b3d">More...</a><br /></td></tr>
<tr class="separator:gaec661c3dff45b4a5626b9dc1bc586b3d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3acef7d113b30124fe11e88c2d2a60a4"><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga3acef7d113b30124fe11e88c2d2a60a4">Gio::DBus::Address::get_for_bus_sync</a> (<a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> bus_type, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable)</td></tr>
<tr class="memdesc:ga3acef7d113b30124fe11e88c2d2a60a4"><td class="mdescLeft"> </td><td class="mdescRight">Synchronously looks up the D-Bus address for the well-known message bus instance specified by <em>bus_type</em>. <a href="group__DBus.html#ga3acef7d113b30124fe11e88c2d2a60a4">More...</a><br /></td></tr>
<tr class="separator:ga3acef7d113b30124fe11e88c2d2a60a4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2b6d40f35340690128b06b289388d120"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga2b6d40f35340690128b06b289388d120">Gio::DBus::ErrorUtils::is_remote_error</a> (const <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& error)</td></tr>
<tr class="memdesc:ga2b6d40f35340690128b06b289388d120"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>error</em> represents an error received via D-Bus from a remote peer. <a href="group__DBus.html#ga2b6d40f35340690128b06b289388d120">More...</a><br /></td></tr>
<tr class="separator:ga2b6d40f35340690128b06b289388d120"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga94461b5c18260b017f3404d82ad5321a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga94461b5c18260b017f3404d82ad5321a">Gio::DBus::ErrorUtils::get_remote_error</a> (const <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& error)</td></tr>
<tr class="memdesc:ga94461b5c18260b017f3404d82ad5321a"><td class="mdescLeft"> </td><td class="mdescRight">Gets the D-Bus error name used for <em>error</em>, if any. <a href="group__DBus.html#ga94461b5c18260b017f3404d82ad5321a">More...</a><br /></td></tr>
<tr class="separator:ga94461b5c18260b017f3404d82ad5321a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2f38119e0765fd1654363fcdee6e4c76"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga2f38119e0765fd1654363fcdee6e4c76">Gio::DBus::ErrorUtils::strip_remote_error</a> (<a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& error)</td></tr>
<tr class="memdesc:ga2f38119e0765fd1654363fcdee6e4c76"><td class="mdescLeft"> </td><td class="mdescRight">Looks for extra information in the error message used to recover the D-Bus error name and strips it if found. <a href="group__DBus.html#ga2f38119e0765fd1654363fcdee6e4c76">More...</a><br /></td></tr>
<tr class="separator:ga2f38119e0765fd1654363fcdee6e4c76"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6e63011eb298f04364d38d44ae51d1e5"><td class="memItemLeft" align="right" valign="top">guint </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga6e63011eb298f04364d38d44ae51d1e5">Gio::DBus::own_name</a> (<a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> bus_type, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const <a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">SlotBusAcquired</a>& bus_acquired_slot=<a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">SlotBusAcquired</a>(), const <a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">SlotNameAcquired</a>& name_acquired_slot=<a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">SlotNameAcquired</a>(), const <a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">SlotNameLost</a>& name_lost_slot=<a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">SlotNameLost</a>(), <a class="el" href="group__giommEnums.html#ga90e13b67fdf97528695baa4a6a18b051">BusNameOwnerFlags</a> flags=<a class="el" href="namespaceGio_1_1DBus.html#ga90e13b67fdf97528695baa4a6a18b051a900fa7dcd6f4b5263dc9b42969439140">Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE</a>)</td></tr>
<tr class="memdesc:ga6e63011eb298f04364d38d44ae51d1e5"><td class="mdescLeft"> </td><td class="mdescRight">Starts acquiring <em>name</em> on the bus specified by <em>bus_type</em> and calls <em>name_acquired_slot</em> and name_<em>lost_slot</em> when the name is acquired respectively lost. <a href="group__DBus.html#ga6e63011eb298f04364d38d44ae51d1e5">More...</a><br /></td></tr>
<tr class="separator:ga6e63011eb298f04364d38d44ae51d1e5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1f11b499bbff8835c429c0fd534df4b0"><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga1f11b499bbff8835c429c0fd534df4b0">Gio::DBus::generate_guid</a> ()</td></tr>
<tr class="memdesc:ga1f11b499bbff8835c429c0fd534df4b0"><td class="mdescLeft"> </td><td class="mdescRight">Generate a D-Bus GUID that can be used with e.g. <a href="group__DBus.html#ga1f11b499bbff8835c429c0fd534df4b0">More...</a><br /></td></tr>
<tr class="separator:ga1f11b499bbff8835c429c0fd534df4b0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf95791c56c136194a67f3855a4416966"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaf95791c56c136194a67f3855a4416966">Gio::DBus::is_guid</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:gaf95791c56c136194a67f3855a4416966"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a D-Bus GUID. <a href="group__DBus.html#gaf95791c56c136194a67f3855a4416966">More...</a><br /></td></tr>
<tr class="separator:gaf95791c56c136194a67f3855a4416966"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga05c67dee67b2ccccdcb0c19714abd5e1"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga05c67dee67b2ccccdcb0c19714abd5e1">Gio::DBus::is_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:ga05c67dee67b2ccccdcb0c19714abd5e1"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus bus name (either unique or well-known). <a href="group__DBus.html#ga05c67dee67b2ccccdcb0c19714abd5e1">More...</a><br /></td></tr>
<tr class="separator:ga05c67dee67b2ccccdcb0c19714abd5e1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga04c3f3efa55c252ce9299a934f3bc9ed"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga04c3f3efa55c252ce9299a934f3bc9ed">Gio::DBus::is_unique_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:ga04c3f3efa55c252ce9299a934f3bc9ed"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus unique bus name. <a href="group__DBus.html#ga04c3f3efa55c252ce9299a934f3bc9ed">More...</a><br /></td></tr>
<tr class="separator:ga04c3f3efa55c252ce9299a934f3bc9ed"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2383c7d151a59adc91e4fbfbd1e4652a"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga2383c7d151a59adc91e4fbfbd1e4652a">Gio::DBus::is_member_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:ga2383c7d151a59adc91e4fbfbd1e4652a"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus member (e.g. <a href="group__DBus.html#ga2383c7d151a59adc91e4fbfbd1e4652a">More...</a><br /></td></tr>
<tr class="separator:ga2383c7d151a59adc91e4fbfbd1e4652a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf8f12ce74f2521c357d814a0105359ea"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaf8f12ce74f2521c357d814a0105359ea">Gio::DBus::is_interface_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">string</a>)</td></tr>
<tr class="memdesc:gaf8f12ce74f2521c357d814a0105359ea"><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus interface name. <a href="group__DBus.html#gaf8f12ce74f2521c357d814a0105359ea">More...</a><br /></td></tr>
<tr class="separator:gaf8f12ce74f2521c357d814a0105359ea"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa202af27755f2ea8d0736f8ab3a75dba"><td class="memItemLeft" align="right" valign="top">guint </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaa202af27755f2ea8d0736f8ab3a75dba">Gio::DBus::watch_name</a> (<a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> bus_type, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const <a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>& name_appeared_slot=<a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>(), const <a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>& name_vanished_slot=<a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>(), <a class="el" href="group__giommEnums.html#ga724a510e53ed4df47411bcdbaf680c85">BusNameWatcherFlags</a> flags=<a class="el" href="namespaceGio_1_1DBus.html#ga724a510e53ed4df47411bcdbaf680c85a23e333ede42826b165a4d40b0f55ad22">Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</a>)</td></tr>
<tr class="memdesc:gaa202af27755f2ea8d0736f8ab3a75dba"><td class="mdescLeft"> </td><td class="mdescRight">Starts watching <em>name</em> on the bus specified by <em>bus_type</em> and calls <em>name_appeared_slot</em> and <em>name_vanished_slot</em> when the name is known to have a owner respectively known to lose its owner. <a href="group__DBus.html#gaa202af27755f2ea8d0736f8ab3a75dba">More...</a><br /></td></tr>
<tr class="separator:gaa202af27755f2ea8d0736f8ab3a75dba"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf07c31497172ba813b9322dad4570927"><td class="memItemLeft" align="right" valign="top">guint </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaf07c31497172ba813b9322dad4570927">Gio::DBus::watch_name</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Connection</a> >& connection, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const <a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>& name_appeared_slot=<a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>(), const <a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>& name_vanished_slot=<a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>(), <a class="el" href="group__giommEnums.html#ga724a510e53ed4df47411bcdbaf680c85">BusNameWatcherFlags</a> flags=<a class="el" href="namespaceGio_1_1DBus.html#ga724a510e53ed4df47411bcdbaf680c85a23e333ede42826b165a4d40b0f55ad22">Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</a>)</td></tr>
<tr class="memdesc:gaf07c31497172ba813b9322dad4570927"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="group__DBus.html#gaa202af27755f2ea8d0736f8ab3a75dba" title="Starts watching name on the bus specified by bus_type and calls name_appeared_slot and name_vanished_...">watch_name()</a> function that takes a <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a> instead of a BusType. <a href="group__DBus.html#gaf07c31497172ba813b9322dad4570927">More...</a><br /></td></tr>
<tr class="separator:gaf07c31497172ba813b9322dad4570927"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa5106315b09d6fc5ad019ecfcc8d5342"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaa5106315b09d6fc5ad019ecfcc8d5342">Gio::DBus::unwatch_name</a> (guint watcher_id)</td></tr>
<tr class="memdesc:gaa5106315b09d6fc5ad019ecfcc8d5342"><td class="mdescLeft"> </td><td class="mdescRight">Stops watching a name. <a href="group__DBus.html#gaa5106315b09d6fc5ad019ecfcc8d5342">More...</a><br /></td></tr>
<tr class="separator:gaa5106315b09d6fc5ad019ecfcc8d5342"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>API to use D-Bus services as a client or to implement a D-Bus service. </p>
<p>To write client code, see <a class="el" href="classGio_1_1DBus_1_1Proxy.html" title="A client-side proxy. ">Gio::DBus::Proxy</a>. To export objects on the bus for other clients, see <a class="el" href="group__DBus.html#ga6e63011eb298f04364d38d44ae51d1e5" title="Starts acquiring name on the bus specified by bus_type and calls name_acquired_slot and name_lost_slo...">Gio::DBus::own_name()</a>, for instance. </p>
<h2 class="groupheader">Typedef Documentation</h2>
<a id="gab7640ad4f168b22492f5783148ad0d69"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab7640ad4f168b22492f5783148ad0d69">◆ </a></span>SlotBusAcquired</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">using <a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">Gio::DBus::SlotBusAcquired</a> = typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a>>&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>></td>
</tr>
</table>
</div><div class="memdoc">
<p>For example, void on_bus_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. </p>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000161">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga41021af407491538d8bfd65ab63f456a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga41021af407491538d8bfd65ab63f456a">◆ </a></span>SlotNameAcquired</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">using <a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">Gio::DBus::SlotNameAcquired</a> = typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a>>&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>></td>
</tr>
</table>
</div><div class="memdoc">
<p>For example, void on_name_acquired(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. </p>
</div>
</div>
<a id="ga200acb252ecaa113828e23b9001a7a8e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga200acb252ecaa113828e23b9001a7a8e">◆ </a></span>SlotNameAppeared</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">using <a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">Gio::DBus::SlotNameAppeared</a> = typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a>>&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&></td>
</tr>
</table>
</div><div class="memdoc">
<p>For example, void on_name_appeared(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name_owner);. </p>
</div>
</div>
<a id="ga69b58dba209c6b3a5f5f20fcd492c973"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga69b58dba209c6b3a5f5f20fcd492c973">◆ </a></span>SlotNameLost</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">using <a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">Gio::DBus::SlotNameLost</a> = typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a>>&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>></td>
</tr>
</table>
</div><div class="memdoc">
<p>For example, void on_name_lost(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. </p>
</div>
</div>
<a id="ga01da22e2e222d03382d93e6741be6935"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga01da22e2e222d03382d93e6741be6935">◆ </a></span>SlotNameVanished</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">using <a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">Gio::DBus::SlotNameVanished</a> = typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a><void, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a>>&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>></td>
</tr>
</table>
</div><div class="memdoc">
<p>For example, void on_name_vanished(const Glib::RefPtr<Gio::DBus::Connection>& connection, const <a class="el" href="classGlib_1_1ustring.html" title="Glib::ustring has much the same interface as std::string, but contains Unicode characters encoded as ...">Glib::ustring</a>& name);. </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="ga1f11b499bbff8835c429c0fd534df4b0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga1f11b499bbff8835c429c0fd534df4b0">◆ </a></span>generate_guid()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::DBus::generate_guid </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Generate a D-Bus GUID that can be used with e.g. </p>
<p><a class="el" href="classGio_1_1DBus_1_1Connection.html#ab8be27670e0620aad315dfc0c1622ab6" title="Asynchronously sets up a D-Bus connection for exchanging D-Bus messages with the end represented by s...">Gio::DBus::Connection::create()</a>.</p>
<p>See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</p>
<dl class="section return"><dt>Returns</dt><dd>A valid D-Bus GUID. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000167">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga3acef7d113b30124fe11e88c2d2a60a4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3acef7d113b30124fe11e88c2d2a60a4">◆ </a></span>get_for_bus_sync()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::DBus::Address::get_for_bus_sync </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> </td>
<td class="paramname"><em>bus_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"><em>cancellable</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Synchronously looks up the D-Bus address for the well-known message bus instance specified by <em>bus_type</em>. </p>
<p>This may involve using various platform specific mechanisms.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bus_type</td><td>A BusType. </td></tr>
<tr><td class="paramname">cancellable</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled. ">Cancellable</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A valid D-Bus address string for <em>bus_type</em>. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000127">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga94461b5c18260b017f3404d82ad5321a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga94461b5c18260b017f3404d82ad5321a">◆ </a></span>get_remote_error()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::DBus::ErrorUtils::get_remote_error </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& </td>
<td class="paramname"><em>error</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the D-Bus error name used for <em>error</em>, if any. </p>
<p>This function is guaranteed to return a D-Bus error name for all <a class="el" href="classGlib_1_1Error.html">Glib::Error</a> instances returned from functions handling remote method calls (e.g. <a class="el" href="classGio_1_1DBus_1_1Connection.html#a230fbe18c49f2fe73857db0919b14edb" title="Finishes an operation started with call(). ">Gio::DBus::Connection::call_finish()</a>) unless <a class="el" href="group__DBus.html#ga2f38119e0765fd1654363fcdee6e4c76" title="Looks for extra information in the error message used to recover the D-Bus error name and strips it i...">strip_remote_error()</a> has been used on <em>error</em>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">error</td><td>A <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An allocated string or <code>0</code> if the D-Bus error name could not be found. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000149">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga2d53e540686789c834cef9a3ac447bf4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2d53e540686789c834cef9a3ac447bf4">◆ </a></span>get_stream()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gio::DBus::Address::get_stream </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>address</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="namespaceGio.html#a62eda8192493461b01b1df06ca229bb7">SlotAsyncReady</a> </td>
<td class="paramname"><em>slot</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"><em>cancellable</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Asynchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. </p>
<p>When the operation is finished, <em>slot</em> will be invoked. You can then call <a class="el" href="group__DBus.html#ga8fa5586dec918dfa553dab97f0f8e342" title="Finishes an operation started with get_stream(). ">get_stream_finish()</a> to get the result of the operation.</p>
<p>This is an asynchronous failable function. See <a class="el" href="group__DBus.html#ga95b08ddb9dedf51b585fa7a5da4f4233" title="Synchronously connects to an endpoint specified by address and sets up the connection so it is in a s...">get_stream_sync()</a> for the synchronous version.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A valid D-Bus address. </td></tr>
<tr><td class="paramname">cancellable</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled. ">Cancellable</a>. </td></tr>
<tr><td class="paramname">slot</td><td>A SlotAsyncReady to call when the request is satisfied. </td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000122">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga8fa5586dec918dfa553dab97f0f8e342"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8fa5586dec918dfa553dab97f0f8e342">◆ </a></span>get_stream_finish() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1IOStream.html">IOStream</a>> Gio::DBus::Address::get_stream_finish </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& </td>
<td class="paramname"><em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>out_guid</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Finishes an operation started with <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">res</td><td>A <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results. ">AsyncResult</a> obtained from the SlotAsyncReady passed to <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. </td></tr>
<tr><td class="paramname">out_guid</td><td>Return location to store the GUID extracted from address, if any. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A <a class="el" href="classGio_1_1IOStream.html" title="IOStream - Base class for implementing read/write streams. ">IOStream</a>. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000123">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga7da9ac3910fa800a6a42b2667b1a0135"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga7da9ac3910fa800a6a42b2667b1a0135">◆ </a></span>get_stream_finish() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1IOStream.html">IOStream</a>> Gio::DBus::Address::get_stream_finish </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& </td>
<td class="paramname"><em>res</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Finishes an operation started with <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">res</td><td>A <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results. ">AsyncResult</a> obtained from the SlotAsyncReady passed to <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A <a class="el" href="classGio_1_1IOStream.html" title="IOStream - Base class for implementing read/write streams. ">IOStream</a>. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000124">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga95b08ddb9dedf51b585fa7a5da4f4233"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga95b08ddb9dedf51b585fa7a5da4f4233">◆ </a></span>get_stream_sync() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1IOStream.html">IOStream</a>> Gio::DBus::Address::get_stream_sync </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>address</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"><em>cancellable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>out_guid</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Synchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. </p>
<p>This is a synchronous failable function. See <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a> for the asynchronous version.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A valid D-Bus address. </td></tr>
<tr><td class="paramname">cancellable</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled. ">Cancellable</a>. </td></tr>
<tr><td class="paramname">out_guid</td><td>A return location to store the GUID extracted from address, if any. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A <a class="el" href="classGio_1_1IOStream.html" title="IOStream - Base class for implementing read/write streams. ">IOStream</a>. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000125">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gaec661c3dff45b4a5626b9dc1bc586b3d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaec661c3dff45b4a5626b9dc1bc586b3d">◆ </a></span>get_stream_sync() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1IOStream.html">IOStream</a>> Gio::DBus::Address::get_stream_sync </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>address</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"><em>cancellable</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Synchronously connects to an endpoint specified by <em>address</em> and sets up the connection so it is in a state to run the client-side of the D-Bus authentication conversation. </p>
<p>This is a synchronous failable function. See <a class="el" href="group__DBus.html#ga2d53e540686789c834cef9a3ac447bf4" title="Asynchronously connects to an endpoint specified by address and sets up the connection so it is in a ...">get_stream()</a> for the asynchronous version.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A valid D-Bus address. </td></tr>
<tr><td class="paramname">cancellable</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled. ">Cancellable</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A <a class="el" href="classGio_1_1IOStream.html" title="IOStream - Base class for implementing read/write streams. ">IOStream</a>. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000126">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gab2c056ac3cce34b4a58df19166d48fae"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab2c056ac3cce34b4a58df19166d48fae">◆ </a></span>is_address()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::Address::is_address </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a D-Bus address. </p>
<p>This doesn't check if <em>string</em> is actually supported by BusServer or BusConnection - use is_supported_address() to do more checks.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>A string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if <em>string</em> is a valid D-Bus address, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000120">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gaf95791c56c136194a67f3855a4416966"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf95791c56c136194a67f3855a4416966">◆ </a></span>is_guid()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::is_guid </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a D-Bus GUID. </p>
<p>See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if string is a guid, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000168">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gaf8f12ce74f2521c357d814a0105359ea"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf8f12ce74f2521c357d814a0105359ea">◆ </a></span>is_interface_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::is_interface_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus interface name. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if valid, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000172">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga2383c7d151a59adc91e4fbfbd1e4652a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2383c7d151a59adc91e4fbfbd1e4652a">◆ </a></span>is_member_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::is_member_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus member (e.g. </p>
<p>signal or method) name.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if valid, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000171">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga05c67dee67b2ccccdcb0c19714abd5e1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga05c67dee67b2ccccdcb0c19714abd5e1">◆ </a></span>is_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::is_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus bus name (either unique or well-known). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if valid, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000169">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga2b6d40f35340690128b06b289388d120"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2b6d40f35340690128b06b289388d120">◆ </a></span>is_remote_error()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::ErrorUtils::is_remote_error </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& </td>
<td class="paramname"><em>error</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>error</em> represents an error received via D-Bus from a remote peer. </p>
<p>If so, use <a class="el" href="group__DBus.html#ga94461b5c18260b017f3404d82ad5321a" title="Gets the D-Bus error name used for error, if any. ">get_remote_error()</a> to get the name of the error.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">error</td><td>A <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if error represents an error from a remote peer, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000148">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214">◆ </a></span>is_supported()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::Address::is_supported </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01681.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"><em>address</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Like <a class="el" href="group__DBus.html#gab2c056ac3cce34b4a58df19166d48fae" title="Checks if string is a D-Bus address. ">is_address()</a> but also checks if the library supports the transports in <em>address</em> and that key/value pairs for each transport are valid. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A supposed address. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if <em>address</em> is a valid D-Bus address that is supported by this library, <code>false</code> otherwise. </dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000121">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga04c3f3efa55c252ce9299a934f3bc9ed"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga04c3f3efa55c252ce9299a934f3bc9ed">◆ </a></span>is_unique_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::is_unique_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>string</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus unique bus name. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if valid, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000170">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga6e63011eb298f04364d38d44ae51d1e5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6e63011eb298f04364d38d44ae51d1e5">◆ </a></span>own_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gio::DBus::own_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> </td>
<td class="paramname"><em>bus_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">SlotBusAcquired</a>& </td>
<td class="paramname"><em>bus_acquired_slot</em> = <code><a class="el" href="group__DBus.html#gab7640ad4f168b22492f5783148ad0d69">SlotBusAcquired</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">SlotNameAcquired</a>& </td>
<td class="paramname"><em>name_acquired_slot</em> = <code><a class="el" href="group__DBus.html#ga41021af407491538d8bfd65ab63f456a">SlotNameAcquired</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">SlotNameLost</a>& </td>
<td class="paramname"><em>name_lost_slot</em> = <code><a class="el" href="group__DBus.html#ga69b58dba209c6b3a5f5f20fcd492c973">SlotNameLost</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#ga90e13b67fdf97528695baa4a6a18b051">BusNameOwnerFlags</a> </td>
<td class="paramname"><em>flags</em> = <code><a class="el" href="namespaceGio_1_1DBus.html#ga90e13b67fdf97528695baa4a6a18b051a900fa7dcd6f4b5263dc9b42969439140">Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE</a></code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Starts acquiring <em>name</em> on the bus specified by <em>bus_type</em> and calls <em>name_acquired_slot</em> and name_<em>lost_slot</em> when the name is acquired respectively lost. </p>
<p>Slots will be invoked in the thread-default main loop of the thread you are calling this function from.</p>
<p>You are guaranteed that one of the <em>name_acquired_slot</em> and <em>name_lost_slot</em> slots will be invoked after calling this function - there are three possible cases:</p>
<ul>
<li><em>name_lost_slot</em> with a nullptr connection (if a connection to the bus can't be made).</li>
<li><em>bus_acquired_slot</em> then <em>name_lost_slot</em> (if the name can't be obtained)</li>
<li><em>bus_acquired_slot</em> then <em>name_acquired_slot</em> (if the name was obtained).</li>
</ul>
<p>When you are done owning the name, just call <a class="el" href="namespaceGio_1_1DBus.html#a56eb716650330a147b033d7aec56e0ed" title="Stops owning a name. ">unown_name()</a> with the owner id this function returns.</p>
<p>If the name is acquired or lost (for example another application could acquire the name if you allow replacement or the application currently owning the name exits), the slots are also invoked. If the <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a> that is used for attempting to own the name closes, then <em>name_lost_slot</em> is invoked since it is no longer possible for other processes to access the process.</p>
<p>You cannot use <a class="el" href="group__DBus.html#ga6e63011eb298f04364d38d44ae51d1e5" title="Starts acquiring name on the bus specified by bus_type and calls name_acquired_slot and name_lost_slo...">own_name()</a> several times for the same name (unless interleaved with calls to <a class="el" href="namespaceGio_1_1DBus.html#a56eb716650330a147b033d7aec56e0ed" title="Stops owning a name. ">unown_name()</a>) - only the first call will work.</p>
<p>Another guarantee is that invocations of name_<em>acquired_slot</em> and <em>name_lost_slot</em> are guaranteed to alternate; that is, if <em>name_acquired_slot</em> is invoked then you are guaranteed that the next time one of the slots is invoked, it will be <em>name_lost_slot</em>. The reverse is also true.</p>
<p>If you plan on exporting objects (using e.g. Gio::DbusConnection::register_object()), note that it is generally too late to export the objects in <em>name_acquired_slot</em>. Instead, you can do this in <em>bus_acquired_slot</em> since you are guaranteed that this will run before name is requested from the bus.</p>
<p>This behavior makes it very simple to write applications that wants to own names and export objects.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bus_type</td><td>The type of bus to own a name on. </td></tr>
<tr><td class="paramname">name</td><td>The well-known name to own. </td></tr>
<tr><td class="paramname">bus_acquired_slot</td><td>Slot to invoke when connected to the bus of type bus_type. </td></tr>
<tr><td class="paramname">name_acquired_slot</td><td>Slot to invoke when name is acquired. </td></tr>
<tr><td class="paramname">name_lost_slot</td><td>Slot to invoke when name is lost. </td></tr>
<tr><td class="paramname">flags</td><td>A set of flags from the BusNameOwnerFlags enumeration. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An identifier (never 0) that an be used with <a class="el" href="namespaceGio_1_1DBus.html#a56eb716650330a147b033d7aec56e0ed" title="Stops owning a name. ">unown_name()</a> to stop owning the name.</dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000162">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="ga2f38119e0765fd1654363fcdee6e4c76"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2f38119e0765fd1654363fcdee6e4c76">◆ </a></span>strip_remote_error()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gio::DBus::ErrorUtils::strip_remote_error </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& </td>
<td class="paramname"><em>error</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Looks for extra information in the error message used to recover the D-Bus error name and strips it if found. </p>
<p>If stripped, the message field in <em>error</em> will correspond exactly to what was received on the wire.</p>
<p>This is typically used when presenting errors to the end user.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">error</td><td>A <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if information was stripped, <code>false</code> otherwise. </dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000150">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gaa5106315b09d6fc5ad019ecfcc8d5342"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa5106315b09d6fc5ad019ecfcc8d5342">◆ </a></span>unwatch_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gio::DBus::unwatch_name </td>
<td>(</td>
<td class="paramtype">guint </td>
<td class="paramname"><em>watcher_id</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Stops watching a name. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">watcher_id</td><td>An identifier obtained from <a class="el" href="group__DBus.html#gaa202af27755f2ea8d0736f8ab3a75dba" title="Starts watching name on the bus specified by bus_type and calls name_appeared_slot and name_vanished_...">watch_name()</a>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gaa202af27755f2ea8d0736f8ab3a75dba"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa202af27755f2ea8d0736f8ab3a75dba">◆ </a></span>watch_name() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gio::DBus::watch_name </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#gaa00806111608557f425bf09bdf4b0087">BusType</a> </td>
<td class="paramname"><em>bus_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>& </td>
<td class="paramname"><em>name_appeared_slot</em> = <code><a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>& </td>
<td class="paramname"><em>name_vanished_slot</em> = <code><a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#ga724a510e53ed4df47411bcdbaf680c85">BusNameWatcherFlags</a> </td>
<td class="paramname"><em>flags</em> = <code><a class="el" href="namespaceGio_1_1DBus.html#ga724a510e53ed4df47411bcdbaf680c85a23e333ede42826b165a4d40b0f55ad22">Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</a></code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Starts watching <em>name</em> on the bus specified by <em>bus_type</em> and calls <em>name_appeared_slot</em> and <em>name_vanished_slot</em> when the name is known to have a owner respectively known to lose its owner. </p>
<p>Callbacks will be invoked in the thread-default main loop of the thread you are calling this function from.</p>
<p>You are guaranteed that one of the slot will be invoked after calling this function. When you are done watching the name, just call <a class="el" href="group__DBus.html#gaa5106315b09d6fc5ad019ecfcc8d5342" title="Stops watching a name. ">unwatch_name()</a> with the watcher id this function returns.</p>
<p>If the name vanishes or appears (for example the application owning the name could restart), the slot are also invoked. If the <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a> that is used for watching the name disconnects, then <em>name_vanished_slot</em> is invoked since it is no longer possible to access the name.</p>
<p>Another guarantee is that invocations of <em>name_appeared_slot</em> and <em>name_vanished_slot</em> are guaranteed to alternate; that is, if <em>name_appeared_slot</em> is invoked then you are guaranteed that the next time one of the slot is invoked, it will be <em>name_vanished_slot</em>. The reverse is also true.</p>
<p>This behavior makes it very simple to write applications that wants to take action when a certain name exists, see the C API's Example 9, “Simple application watching a name” for more information. Basically, the application should create object proxies in <em>name_appeared_slot</em> and destroy them again (if any) in <em>name_vanished_slot</em>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bus_type</td><td>The type of bus to watch a name on. </td></tr>
<tr><td class="paramname">name</td><td>The name (well-known or unique) to watch. </td></tr>
<tr><td class="paramname">name_appeared_slot</td><td>Slot to invoke when name is known to exist. </td></tr>
<tr><td class="paramname">name_vanished_slot</td><td>Slot to invoke when name is known to not exist. </td></tr>
<tr><td class="paramname">flags</td><td>Flags from the BusNameWatcherFlags enumeration. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An identifier (never 0) that can be used with <a class="el" href="group__DBus.html#gaa5106315b09d6fc5ad019ecfcc8d5342" title="Stops watching a name. ">unwatch_name()</a> to stop watching the name.</dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000173">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a id="gaf07c31497172ba813b9322dad4570927"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf07c31497172ba813b9322dad4570927">◆ </a></span>watch_name() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gio::DBus::watch_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Connection</a> >& </td>
<td class="paramname"><em>connection</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>& </td>
<td class="paramname"><em>name_appeared_slot</em> = <code><a class="el" href="group__DBus.html#ga200acb252ecaa113828e23b9001a7a8e">SlotNameAppeared</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>& </td>
<td class="paramname"><em>name_vanished_slot</em> = <code><a class="el" href="group__DBus.html#ga01da22e2e222d03382d93e6741be6935">SlotNameVanished</a>()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__giommEnums.html#ga724a510e53ed4df47411bcdbaf680c85">BusNameWatcherFlags</a> </td>
<td class="paramname"><em>flags</em> = <code><a class="el" href="namespaceGio_1_1DBus.html#ga724a510e53ed4df47411bcdbaf680c85a23e333ede42826b165a4d40b0f55ad22">Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</a></code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>A <a class="el" href="group__DBus.html#gaa202af27755f2ea8d0736f8ab3a75dba" title="Starts watching name on the bus specified by bus_type and calls name_appeared_slot and name_vanished_...">watch_name()</a> function that takes a <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a> instead of a BusType. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">connection</td><td>A <a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection. ">Connection</a>. </td></tr>
<tr><td class="paramname">name</td><td>The name (well-known or unique) to watch. </td></tr>
<tr><td class="paramname">name_appeared_slot</td><td>Slot to invoke when name is known to exist. </td></tr>
<tr><td class="paramname">name_vanished_slot</td><td>Slot to invoke when name is known to not exist. </td></tr>
<tr><td class="paramname">flags</td><td>Flags from the BusNameWatcherFlags enumeration. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An identifier (never 0) that can be used with <a class="el" href="group__DBus.html#gaa5106315b09d6fc5ad019ecfcc8d5342" title="Stops watching a name. ">unwatch_name()</a> to stop watching the name.</dd></dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000174">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Mar 31 2018 09:12:05 for glibmm by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>