<!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"/>
<title>glibmm: D-Bus API</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.2 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
</div>
<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">
<h1>D-Bus API</h1> </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Classes</h2></td></tr>
<tr><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><td class="mdescLeft"> </td><td class="mdescRight">Ah object used for authenticating connections. <a href="classGio_1_1DBus_1_1AuthObserver.html#_details">More...</a><br/></td></tr>
<tr><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><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><td class="mdescLeft"> </td><td class="mdescRight">An Object for handling remote calls. <a href="classGio_1_1DBus_1_1MethodInvocation.html#_details">More...</a><br/></td></tr>
<tr><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><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><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><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><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><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><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">sigc::slot</a>< void, <br class="typebreak"/>
const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> ><br class="typebreak"/>
&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga92ddf71b4fad230b88f53f0bd51cf9ce">Gio::DBus::SlotBusAcquired</a></td></tr>
<tr><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="#ga92ddf71b4fad230b88f53f0bd51cf9ce"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">sigc::slot</a>< void, <br class="typebreak"/>
const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> ><br class="typebreak"/>
&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gaa9752b9e34e82802372d543be19e835d">Gio::DBus::SlotNameAcquired</a></td></tr>
<tr><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="#gaa9752b9e34e82802372d543be19e835d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">sigc::slot</a>< void, <br class="typebreak"/>
const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> ><br class="typebreak"/>
&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga6191db7ad78e8398c1193b9e78b9a9e8">Gio::DBus::SlotNameLost</a></td></tr>
<tr><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="#ga6191db7ad78e8398c1193b9e78b9a9e8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">sigc::slot</a>< void, <br class="typebreak"/>
const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> ><br class="typebreak"/>
&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>, const <br class="typebreak"/>
<a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#ga86bd32cfdf2b9f3ef20ed287c8fc58b7">Gio::DBus::SlotNameAppeared</a></td></tr>
<tr><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="#ga86bd32cfdf2b9f3ef20ed287c8fc58b7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">sigc::slot</a>< void, <br class="typebreak"/>
const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1DBus_1_1Connection.html">Gio::DBus::Connection</a> ><br class="typebreak"/>
&, <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="group__DBus.html#gadb9a09c6a42e777238421f74c82a631b">Gio::DBus::SlotNameVanished</a></td></tr>
<tr><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="#gadb9a09c6a42e777238421f74c82a631b"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a D-Bus address. <a href="#gab2c056ac3cce34b4a58df19166d48fae"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address)</td></tr>
<tr><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="#ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const SlotAsyncReady slot, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< Cancellable >& cancellable)</td></tr>
<tr><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="#ga2d53e540686789c834cef9a3ac447bf4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< IOStream > </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>< AsyncResult >& res, <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& out_guid)</td></tr>
<tr><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="#ga8fa5586dec918dfa553dab97f0f8e342"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< IOStream > </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>< AsyncResult >& res)</td></tr>
<tr><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="#ga7da9ac3910fa800a6a42b2667b1a0135"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< IOStream > </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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< Cancellable >& cancellable, <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& out_guid)</td></tr>
<tr><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="#ga95b08ddb9dedf51b585fa7a5da4f4233"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< IOStream > </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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& address, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< Cancellable >& cancellable)</td></tr>
<tr><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="#gaec661c3dff45b4a5626b9dc1bc586b3d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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> (BusType bus_type, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< Cancellable >& cancellable)</td></tr>
<tr><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="#ga3acef7d113b30124fe11e88c2d2a60a4"></a><br/></td></tr>
<tr><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><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="#ga2b6d40f35340690128b06b289388d120"></a><br/></td></tr>
<tr><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><td class="mdescLeft"> </td><td class="mdescRight">Gets the D-Bus error name used for <em>error</em>, if any. <a href="#ga94461b5c18260b017f3404d82ad5321a"></a><br/></td></tr>
<tr><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><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="#ga2f38119e0765fd1654363fcdee6e4c76"></a><br/></td></tr>
<tr><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> (BusType bus_type, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const SlotBusAcquired& bus_acquired_slot=SlotBusAcquired(), const SlotNameAcquired& name_acquired_slot=SlotNameAcquired(), const SlotNameLost& name_lost_slot=SlotNameLost(), BusNameOwnerFlags flags=Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE)</td></tr>
<tr><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="#ga6e63011eb298f04364d38d44ae51d1e5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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><td class="mdescLeft"> </td><td class="mdescRight">Generate a D-Bus GUID that can be used with e.g. <a href="#ga1f11b499bbff8835c429c0fd534df4b0"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a D-Bus GUID. <a href="#gaf95791c56c136194a67f3855a4416966"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><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="#ga05c67dee67b2ccccdcb0c19714abd5e1"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus unique bus name. <a href="#ga04c3f3efa55c252ce9299a934f3bc9ed"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus member (e.g. <a href="#ga2383c7d151a59adc91e4fbfbd1e4652a"></a><br/></td></tr>
<tr><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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01128.html#af4d08898cac5ae6fe1d0a15a6f90d271">string</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if <em>string</em> is a valid D-Bus interface name. <a href="#gaf8f12ce74f2521c357d814a0105359ea"></a><br/></td></tr>
<tr><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> (BusType bus_type, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const SlotNameAppeared& name_appeared_slot=SlotNameAppeared(), const SlotNameVanished& name_vanished_slot=SlotNameVanished(), BusNameWatcherFlags flags=Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE)</td></tr>
<tr><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="#gaa202af27755f2ea8d0736f8ab3a75dba"></a><br/></td></tr>
<tr><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>< Connection >& connection, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& name, const SlotNameAppeared& name_appeared_slot=SlotNameAppeared(), const SlotNameVanished& name_vanished_slot=SlotNameVanished(), BusNameWatcherFlags flags=Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE)</td></tr>
<tr><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="#gaf07c31497172ba813b9322dad4570927"></a><br/></td></tr>
<tr><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><td class="mdescLeft"> </td><td class="mdescRight">Stops watching a name. <a href="#gaa5106315b09d6fc5ad019ecfcc8d5342"></a><br/></td></tr>
</table>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga92ddf71b4fad230b88f53f0bd51cf9ce"></a><!-- doxytag: member="Gio::DBus::SlotBusAcquired" ref="ga92ddf71b4fad230b88f53f0bd51cf9ce" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/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>> <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">Gio::DBus::SlotBusAcquired</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_28000105">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaa9752b9e34e82802372d543be19e835d"></a><!-- doxytag: member="Gio::DBus::SlotNameAcquired" ref="gaa9752b9e34e82802372d543be19e835d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/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>> <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">Gio::DBus::SlotNameAcquired</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 class="anchor" id="ga86bd32cfdf2b9f3ef20ed287c8fc58b7"></a><!-- doxytag: member="Gio::DBus::SlotNameAppeared" ref="ga86bd32cfdf2b9f3ef20ed287c8fc58b7" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/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>&> <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">Gio::DBus::SlotNameAppeared</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 class="anchor" id="ga6191db7ad78e8398c1193b9e78b9a9e8"></a><!-- doxytag: member="Gio::DBus::SlotNameLost" ref="ga6191db7ad78e8398c1193b9e78b9a9e8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/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>> <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">Gio::DBus::SlotNameLost</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 class="anchor" id="gadb9a09c6a42e777238421f74c82a631b"></a><!-- doxytag: member="Gio::DBus::SlotNameVanished" ref="gadb9a09c6a42e777238421f74c82a631b" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="elRef" href="../../../libsigc++-2.0/reference/html/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>> <a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">Gio::DBus::SlotNameVanished</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>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga1f11b499bbff8835c429c0fd534df4b0"></a><!-- doxytag: member="Gio::DBus::generate_guid" ref="ga1f11b499bbff8835c429c0fd534df4b0" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::DBus::generate_guid </td>
<td>(</td>
<td class="paramname"> )</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="return"><dt><b>Returns:</b></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_28000111">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga3acef7d113b30124fe11e88c2d2a60a4"></a><!-- doxytag: member="Gio::DBus::Address::get_for_bus_sync" ref="ga3acef7d113b30124fe11e88c2d2a60a4" args="(BusType bus_type, const Glib::RefPtr< Cancellable > &cancellable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::DBus::Address::get_for_bus_sync </td>
<td>(</td>
<td class="paramtype">BusType </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>< Cancellable >& </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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></dt><dd>A valid D-Bus address string for <em>bus_type</em>. </dd></dl>
<dl><dt><b>Exceptions:</b></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_28000069">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga94461b5c18260b017f3404d82ad5321a"></a><!-- doxytag: member="Gio::DBus::ErrorUtils::get_remote_error" ref="ga94461b5c18260b017f3404d82ad5321a" args="(const Glib::Error &error)" -->
<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>
</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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></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_28000093">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga2d53e540686789c834cef9a3ac447bf4"></a><!-- doxytag: member="Gio::DBus::Address::get_stream" ref="ga2d53e540686789c834cef9a3ac447bf4" args="(const std::string &address, const SlotAsyncReady slot, const Glib::RefPtr< Cancellable > &cancellable)" -->
<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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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 SlotAsyncReady </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>< Cancellable >& </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><dt><b>Parameters:</b></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_28000064">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga8fa5586dec918dfa553dab97f0f8e342"></a><!-- doxytag: member="Gio::DBus::Address::get_stream_finish" ref="ga8fa5586dec918dfa553dab97f0f8e342" args="(const Glib::RefPtr< AsyncResult > &res, std::string &out_guid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><IOStream> Gio::DBus::Address::get_stream_finish </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< AsyncResult >& </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1IOStream.html">IOStream</a>. </dd></dl>
<dl><dt><b>Exceptions:</b></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_28000065">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga7da9ac3910fa800a6a42b2667b1a0135"></a><!-- doxytag: member="Gio::DBus::Address::get_stream_finish" ref="ga7da9ac3910fa800a6a42b2667b1a0135" args="(const Glib::RefPtr< AsyncResult > &res)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><IOStream> Gio::DBus::Address::get_stream_finish </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< AsyncResult >& </td>
<td class="paramname"> <em>res</em> )</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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1IOStream.html">IOStream</a>. </dd></dl>
<dl><dt><b>Exceptions:</b></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_28000066">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga95b08ddb9dedf51b585fa7a5da4f4233"></a><!-- doxytag: member="Gio::DBus::Address::get_stream_sync" ref="ga95b08ddb9dedf51b585fa7a5da4f4233" args="(const std::string &address, const Glib::RefPtr< Cancellable > &cancellable, std::string &out_guid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><IOStream> Gio::DBus::Address::get_stream_sync </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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>< Cancellable >& </td>
<td class="paramname"> <em>cancellable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A valid D-Bus address. </td></tr>
<tr><td class="paramname">out_guid</td><td>A return location to store the GUID extracted from address, if any. </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">Returns</td><td>A <a class="el" href="classGio_1_1IOStream.html">IOStream</a>. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></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_28000067">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaec661c3dff45b4a5626b9dc1bc586b3d"></a><!-- doxytag: member="Gio::DBus::Address::get_stream_sync" ref="gaec661c3dff45b4a5626b9dc1bc586b3d" args="(const std::string &address, const Glib::RefPtr< Cancellable > &cancellable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><IOStream> Gio::DBus::Address::get_stream_sync </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.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>< Cancellable >& </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><dt><b>Parameters:</b></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">Returns</td><td>A <a class="el" href="classGio_1_1IOStream.html">IOStream</a>. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></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_28000068">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gab2c056ac3cce34b4a58df19166d48fae"></a><!-- doxytag: member="Gio::DBus::Address::is_address" ref="gab2c056ac3cce34b4a58df19166d48fae" args="(const std::string &string)" -->
<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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>string</em> )</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>A string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000062">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaf95791c56c136194a67f3855a4416966"></a><!-- doxytag: member="Gio::DBus::is_guid" ref="gaf95791c56c136194a67f3855a4416966" args="(const std::string &string)" -->
<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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>string</em> )</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000112">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaf8f12ce74f2521c357d814a0105359ea"></a><!-- doxytag: member="Gio::DBus::is_interface_name" ref="gaf8f12ce74f2521c357d814a0105359ea" args="(const Glib::ustring &string)" -->
<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>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus interface name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000116">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga2383c7d151a59adc91e4fbfbd1e4652a"></a><!-- doxytag: member="Gio::DBus::is_member_name" ref="ga2383c7d151a59adc91e4fbfbd1e4652a" args="(const Glib::ustring &string)" -->
<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>
</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000115">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga05c67dee67b2ccccdcb0c19714abd5e1"></a><!-- doxytag: member="Gio::DBus::is_name" ref="ga05c67dee67b2ccccdcb0c19714abd5e1" args="(const Glib::ustring &string)" -->
<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>
</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000113">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga2b6d40f35340690128b06b289388d120"></a><!-- doxytag: member="Gio::DBus::ErrorUtils::is_remote_error" ref="ga2b6d40f35340690128b06b289388d120" args="(const Glib::Error &error)" -->
<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>
</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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></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_28000092">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214"></a><!-- doxytag: member="Gio::DBus::Address::is_supported" ref="ga2f8d4a3d5bda1d3fcc4f4f3c8cc0c214" args="(const std::string &address)" -->
<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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01202.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>address</em> )</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">address</td><td>A supposed address. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</t> if <em>address</em> is a valid D-Bus address that is supported by this library, <code>false</code> otherwise. </code></dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname">Glib::Error.</td><td><code></code></td></tr>
</table>
</dd>
</dl>
<dl class="since_2_28"><dt><b><a class="el" href="since_2_28.html#_since_2_28000063">Since glibmm 2.28:</a></b></dt><dd><p class="startdd"><code></code></p>
<p class="enddd"><code> </code></p>
</dd></dl>
</div>
</div>
<a class="anchor" id="ga04c3f3efa55c252ce9299a934f3bc9ed"></a><!-- doxytag: member="Gio::DBus::is_unique_name" ref="ga04c3f3efa55c252ce9299a934f3bc9ed" args="(const Glib::ustring &string)" -->
<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>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks if <em>string</em> is a valid D-Bus unique bus name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string to check. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000114">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga6e63011eb298f04364d38d44ae51d1e5"></a><!-- doxytag: member="Gio::DBus::own_name" ref="ga6e63011eb298f04364d38d44ae51d1e5" args="(BusType bus_type, const Glib::ustring &name, const SlotBusAcquired &bus_acquired_slot=SlotBusAcquired(), const SlotNameAcquired &name_acquired_slot=SlotNameAcquired(), const SlotNameLost &name_lost_slot=SlotNameLost(), BusNameOwnerFlags flags=Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gio::DBus::own_name </td>
<td>(</td>
<td class="paramtype">BusType </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 SlotBusAcquired & </td>
<td class="paramname"> <em>bus_acquired_slot</em> = <code>SlotBusAcquired()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const SlotNameAcquired & </td>
<td class="paramname"> <em>name_acquired_slot</em> = <code>SlotNameAcquired()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const SlotNameLost & </td>
<td class="paramname"> <em>name_lost_slot</em> = <code>SlotNameLost()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BusNameOwnerFlags </td>
<td class="paramname"> <em>flags</em> = <code>Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE</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 NULL 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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></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_28000106">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga2f38119e0765fd1654363fcdee6e4c76"></a><!-- doxytag: member="Gio::DBus::ErrorUtils::strip_remote_error" ref="ga2f38119e0765fd1654363fcdee6e4c76" args="(Glib::Error &error)" -->
<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>
</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><dt><b>Parameters:</b></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="return"><dt><b>Returns:</b></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_28000094">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaa5106315b09d6fc5ad019ecfcc8d5342"></a><!-- doxytag: member="Gio::DBus::unwatch_name" ref="gaa5106315b09d6fc5ad019ecfcc8d5342" args="(guint watcher_id)" -->
<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>
</tr>
</table>
</div>
<div class="memdoc">
<p>Stops watching a name. </p>
<dl><dt><b>Parameters:</b></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 class="anchor" id="gaf07c31497172ba813b9322dad4570927"></a><!-- doxytag: member="Gio::DBus::watch_name" ref="gaf07c31497172ba813b9322dad4570927" args="(const Glib::RefPtr< Connection > &connection, const Glib::ustring &name, const SlotNameAppeared &name_appeared_slot=SlotNameAppeared(), const SlotNameVanished &name_vanished_slot=SlotNameVanished(), BusNameWatcherFlags flags=Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE)" -->
<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>< Connection >& </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 SlotNameAppeared & </td>
<td class="paramname"> <em>name_appeared_slot</em> = <code>SlotNameAppeared()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const SlotNameVanished & </td>
<td class="paramname"> <em>name_vanished_slot</em> = <code>SlotNameVanished()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BusNameWatcherFlags </td>
<td class="paramname"> <em>flags</em> = <code>Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">connection A</td><td><a class="el" href="classGio_1_1DBus_1_1Connection.html" title="A D-Bus Connection.">Connection</a>. </td></tr>
<tr><td class="paramname">name The</td><td>name (well-known or unique) to watch. </td></tr>
<tr><td class="paramname">name_appeared_slot Slot</td><td>to invoke when name is known to exist. </td></tr>
<tr><td class="paramname">name_vanished_slot Slot</td><td>to invoke when name is known to not exist. </td></tr>
<tr><td class="paramname">flags Flags</td><td>from the BusNameWatcherFlags enumeration. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000118">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gaa202af27755f2ea8d0736f8ab3a75dba"></a><!-- doxytag: member="Gio::DBus::watch_name" ref="gaa202af27755f2ea8d0736f8ab3a75dba" args="(BusType bus_type, const Glib::ustring &name, const SlotNameAppeared &name_appeared_slot=SlotNameAppeared(), const SlotNameVanished &name_vanished_slot=SlotNameVanished(), BusNameWatcherFlags flags=Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gio::DBus::watch_name </td>
<td>(</td>
<td class="paramtype">BusType </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 SlotNameAppeared & </td>
<td class="paramname"> <em>name_appeared_slot</em> = <code>SlotNameAppeared()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const SlotNameVanished & </td>
<td class="paramname"> <em>name_vanished_slot</em> = <code>SlotNameVanished()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BusNameWatcherFlags </td>
<td class="paramname"> <em>flags</em> = <code>Gio::DBus::BUS_NAME_WATCHER_FLAGS_NONE</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><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">bus_type The</td><td>type of bus to watch a name on. </td></tr>
<tr><td class="paramname">name The</td><td>name (well-known or unique) to watch. </td></tr>
<tr><td class="paramname">name_appeared_slot Slot</td><td>to invoke when name is known to exist. </td></tr>
<tr><td class="paramname">name_vanished_slot Slot</td><td>to invoke when name is known to not exist. </td></tr>
<tr><td class="paramname">flags Flags</td><td>from the BusNameWatcherFlags enumeration. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></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_28000117">Since glibmm 2.28:</a></b></dt><dd></dd></dl>
</div>
</div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Apr 5 2011 16:07:12 for glibmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.2 </small></address>
</body>
</html>
