Tizen 2.1 base
[platform/upstream/glib2.0.git] / docs / reference / gio / gdbus-object-manager-example / html / ExampleObjectManagerClient.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>ExampleObjectManagerClient</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="">
8 <link rel="up" href="ch01.html" title="bar">
9 <link rel="prev" href="ExampleObject.html" title="ExampleObject">
10 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11 <link rel="stylesheet" href="style.css" type="text/css">
12 </head>
13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
15 <tr valign="middle">
16 <td><a accesskey="p" href="ExampleObject.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19 <th width="100%" align="center"></th>
20 <td> </td>
21 </tr>
22 <tr><td colspan="5" class="shortcuts">
23 <a href="#ExampleObjectManagerClient.synopsis" class="shortcut">Top</a>
24                    | 
25                   <a href="#ExampleObjectManagerClient.description" class="shortcut">Description</a>
26                    | 
27                   <a href="#ExampleObjectManagerClient.object-hierarchy" class="shortcut">Object Hierarchy</a>
28                    | 
29                   <a href="#ExampleObjectManagerClient.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
30 </td></tr>
31 </table>
32 <div class="refentry">
33 <a name="ExampleObjectManagerClient"></a><div class="titlepage"></div>
34 <div class="refnamediv"><table width="100%"><tr>
35 <td valign="top">
36 <h2><span class="refentrytitle"><a name="ExampleObjectManagerClient.top_of_page"></a>ExampleObjectManagerClient</span></h2>
37 <p>ExampleObjectManagerClient — Generated GDBusObjectManagerClient type</p>
38 </td>
39 <td valign="top" align="right"></td>
40 </tr></table></div>
41 <div class="refsynopsisdiv">
42 <a name="ExampleObjectManagerClient.synopsis"></a><h2>Synopsis</h2>
43 <pre class="synopsis">struct              <a class="link" href="ExampleObjectManagerClient.html#ExampleObjectManagerClient-struct" title="struct ExampleObjectManagerClient">ExampleObjectManagerClient</a>;
44 struct              <a class="link" href="ExampleObjectManagerClient.html#ExampleObjectManagerClientClass" title="struct ExampleObjectManagerClientClass">ExampleObjectManagerClientClass</a>;
45 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-get-proxy-type" title="example_object_manager_client_get_proxy_type ()">example_object_manager_client_get_proxy_type</a>
46                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> *manager</code></em>,
47                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
48                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
49                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
50 <span class="returnvalue">void</span>                <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new" title="example_object_manager_client_new ()">example_object_manager_client_new</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
51                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
52                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
53                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
54                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
55                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
56                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
57 <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-finish" title="example_object_manager_client_new_finish ()">example_object_manager_client_new_finish</a>
58                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
59                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
60 <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-sync" title="example_object_manager_client_new_sync ()">example_object_manager_client_new_sync</a>
61                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
62                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
63                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
64                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
65                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
66                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
67 <span class="returnvalue">void</span>                <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus" title="example_object_manager_client_new_for_bus ()">example_object_manager_client_new_for_bus</a>
68                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
69                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
70                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
71                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
72                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
73                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
74                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
75 <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus-finish" title="example_object_manager_client_new_for_bus_finish ()">example_object_manager_client_new_for_bus_finish</a>
76                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
77                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
78 <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus-sync" title="example_object_manager_client_new_for_bus_sync ()">example_object_manager_client_new_for_bus_sync</a>
79                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
80                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
81                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
82                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
83                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
84                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
85 </pre>
86 </div>
87 <div class="refsect1">
88 <a name="ExampleObjectManagerClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
89 <pre class="synopsis">
90   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
91    +----<a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html">GDBusObjectManagerClient</a>
92          +----ExampleObjectManagerClient
93 </pre>
94 </div>
95 <div class="refsect1">
96 <a name="ExampleObjectManagerClient.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
97 <p>
98 ExampleObjectManagerClient implements
99  <a href="http://library.gnome.org/devel/gio/unstable/GInitable.html">GInitable</a>,  <a href="http://library.gnome.org/devel/gio/unstable/GAsyncInitable.html">GAsyncInitable</a> and  <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html">GDBusObjectManager</a>.</p>
100 </div>
101 <div class="refsect1">
102 <a name="ExampleObjectManagerClient.description"></a><h2>Description</h2>
103 <p>
104 This section contains a <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> that uses <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-get-proxy-type" title="example_object_manager_client_get_proxy_type ()"><code class="function">example_object_manager_client_get_proxy_type()</code></a> as the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusProxyTypeFunc"><span class="type">GDBusProxyTypeFunc</span></a>.
105 </p>
106 </div>
107 <div class="refsect1">
108 <a name="ExampleObjectManagerClient.details"></a><h2>Details</h2>
109 <div class="refsect2">
110 <a name="ExampleObjectManagerClient-struct"></a><h3>struct ExampleObjectManagerClient</h3>
111 <pre class="programlisting">struct ExampleObjectManagerClient;</pre>
112 <p>
113 The <a class="link" href="ExampleObjectManagerClient.html" title="ExampleObjectManagerClient"><span class="type">ExampleObjectManagerClient</span></a> structure contains only private data and should only be accessed using the provided API.
114 </p>
115 </div>
116 <hr>
117 <div class="refsect2">
118 <a name="ExampleObjectManagerClientClass"></a><h3>struct ExampleObjectManagerClientClass</h3>
119 <pre class="programlisting">struct ExampleObjectManagerClientClass {
120   GDBusObjectManagerClientClass parent_class;
121 };
122 </pre>
123 <p>
124 Class structure for <a class="link" href="ExampleObjectManagerClient.html" title="ExampleObjectManagerClient"><span class="type">ExampleObjectManagerClient</span></a>.
125 </p>
126 <div class="variablelist"><table border="0">
127 <col align="left" valign="top">
128 <tbody><tr>
129 <td><p><span class="term"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientClass"><span class="type">GDBusObjectManagerClientClass</span></a> <em class="structfield"><code><a name="ExampleObjectManagerClientClass.parent-class"></a>parent_class</code></em>;</span></p></td>
130 <td>The parent class.</td>
131 </tr></tbody>
132 </table></div>
133 </div>
134 <hr>
135 <div class="refsect2">
136 <a name="example-object-manager-client-get-proxy-type"></a><h3>example_object_manager_client_get_proxy_type ()</h3>
137 <pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               example_object_manager_client_get_proxy_type
138                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> *manager</code></em>,
139                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
140                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *interface_name</code></em>,
141                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
142 <p>
143 A <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusProxyTypeFunc"><span class="type">GDBusProxyTypeFunc</span></a> that maps <em class="parameter"><code>interface_name</code></em> to the generated <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectProxy.html"><span class="type">GDBusObjectProxy</span></a>- and <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html"><span class="type">GDBusProxy</span></a>-derived types.
144 </p>
145 <div class="variablelist"><table border="0">
146 <col align="left" valign="top">
147 <tbody>
148 <tr>
149 <td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
150 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a>.</td>
151 </tr>
152 <tr>
153 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
154 <td>The object path of the remote object (unused).</td>
155 </tr>
156 <tr>
157 <td><p><span class="term"><em class="parameter"><code>interface_name</code></em> :</span></p></td>
158 <td>Interface name of the remote object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to get the object proxy <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
159 </td>
160 </tr>
161 <tr>
162 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
163 <td>User data (unused).</td>
164 </tr>
165 <tr>
166 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
167 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html"><span class="type">GDBusProxy</span></a>-derived <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> if <em class="parameter"><code>interface_name</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, otherwise the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> for <a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="type">ExampleObjectProxy</span></a>.</td>
168 </tr>
169 </tbody>
170 </table></div>
171 </div>
172 <hr>
173 <div class="refsect2">
174 <a name="example-object-manager-client-new"></a><h3>example_object_manager_client_new ()</h3>
175 <pre class="programlisting"><span class="returnvalue">void</span>                example_object_manager_client_new   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
176                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
177                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
178                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
179                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
180                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
181                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
182 <p>
183 Asynchronously creates <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> using <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-get-proxy-type" title="example_object_manager_client_get_proxy_type ()"><code class="function">example_object_manager_client_get_proxy_type()</code></a> as the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusProxyTypeFunc"><span class="type">GDBusProxyTypeFunc</span></a>. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#g-dbus-object-manager-client-new"><code class="function">g_dbus_object_manager_client_new()</code></a> for more details.
184 </p>
185 <p>
186 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
187 You can then call <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-finish" title="example_object_manager_client_new_finish ()"><code class="function">example_object_manager_client_new_finish()</code></a> to get the result of the operation.
188 </p>
189 <p>
190 See <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-sync" title="example_object_manager_client_new_sync ()"><code class="function">example_object_manager_client_new_sync()</code></a> for the synchronous, blocking version of this constructor.
191 </p>
192 <div class="variablelist"><table border="0">
193 <col align="left" valign="top">
194 <tbody>
195 <tr>
196 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
197 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</td>
198 </tr>
199 <tr>
200 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
201 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> enumeration.</td>
202 </tr>
203 <tr>
204 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
205 <td>A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
206 </td>
207 </tr>
208 <tr>
209 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
210 <td>An object path.</td>
211 </tr>
212 <tr>
213 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
214 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
215 </td>
216 </tr>
217 <tr>
218 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
219 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
220 </tr>
221 <tr>
222 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
223 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
224 </tr>
225 </tbody>
226 </table></div>
227 </div>
228 <hr>
229 <div class="refsect2">
230 <a name="example-object-manager-client-new-finish"></a><h3>example_object_manager_client_new_finish ()</h3>
231 <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * example_object_manager_client_new_finish
232                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
233                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
234 <p>
235 Finishes an operation started with <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new" title="example_object_manager_client_new ()"><code class="function">example_object_manager_client_new()</code></a>.
236 </p>
237 <div class="variablelist"><table border="0">
238 <col align="left" valign="top">
239 <tbody>
240 <tr>
241 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
242 <td>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new" title="example_object_manager_client_new ()"><code class="function">example_object_manager_client_new()</code></a>.</td>
243 </tr>
244 <tr>
245 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
246 <td>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
247 </td>
248 </tr>
249 <tr>
250 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
251 <td>The constructed object manager client or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleObjectManagerClient]</span>
252 </td>
253 </tr>
254 </tbody>
255 </table></div>
256 </div>
257 <hr>
258 <div class="refsect2">
259 <a name="example-object-manager-client-new-sync"></a><h3>example_object_manager_client_new_sync ()</h3>
260 <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * example_object_manager_client_new_sync
261                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
262                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
263                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
264                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
265                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
266                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
267 <p>
268 Synchronously creates <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> using <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-get-proxy-type" title="example_object_manager_client_get_proxy_type ()"><code class="function">example_object_manager_client_get_proxy_type()</code></a> as the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusProxyTypeFunc"><span class="type">GDBusProxyTypeFunc</span></a>. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#g-dbus-object-manager-client-new-sync"><code class="function">g_dbus_object_manager_client_new_sync()</code></a> for more details.
269 </p>
270 <p>
271 The calling thread is blocked until a reply is received.
272 </p>
273 <p>
274 See <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new" title="example_object_manager_client_new ()"><code class="function">example_object_manager_client_new()</code></a> for the asynchronous version of this constructor.
275 </p>
276 <div class="variablelist"><table border="0">
277 <col align="left" valign="top">
278 <tbody>
279 <tr>
280 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
281 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</td>
282 </tr>
283 <tr>
284 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
285 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> enumeration.</td>
286 </tr>
287 <tr>
288 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
289 <td>A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
290 </td>
291 </tr>
292 <tr>
293 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
294 <td>An object path.</td>
295 </tr>
296 <tr>
297 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
298 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
299 </td>
300 </tr>
301 <tr>
302 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
303 <td>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
304 </td>
305 </tr>
306 <tr>
307 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
308 <td>The constructed object manager client or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleObjectManagerClient]</span>
309 </td>
310 </tr>
311 </tbody>
312 </table></div>
313 </div>
314 <hr>
315 <div class="refsect2">
316 <a name="example-object-manager-client-new-for-bus"></a><h3>example_object_manager_client_new_for_bus ()</h3>
317 <pre class="programlisting"><span class="returnvalue">void</span>                example_object_manager_client_new_for_bus
318                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
319                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
320                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
321                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
322                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
323                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
324                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
325 <p>
326 Like <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new" title="example_object_manager_client_new ()"><code class="function">example_object_manager_client_new()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.
327 </p>
328 <p>
329 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
330 You can then call <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus-finish" title="example_object_manager_client_new_for_bus_finish ()"><code class="function">example_object_manager_client_new_for_bus_finish()</code></a> to get the result of the operation.
331 </p>
332 <p>
333 See <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus-sync" title="example_object_manager_client_new_for_bus_sync ()"><code class="function">example_object_manager_client_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.
334 </p>
335 <div class="variablelist"><table border="0">
336 <col align="left" valign="top">
337 <tbody>
338 <tr>
339 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
340 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</td>
341 </tr>
342 <tr>
343 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
344 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> enumeration.</td>
345 </tr>
346 <tr>
347 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
348 <td>A bus name (well-known or unique).</td>
349 </tr>
350 <tr>
351 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
352 <td>An object path.</td>
353 </tr>
354 <tr>
355 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
356 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
357 </td>
358 </tr>
359 <tr>
360 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
361 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
362 </tr>
363 <tr>
364 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
365 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
366 </tr>
367 </tbody>
368 </table></div>
369 </div>
370 <hr>
371 <div class="refsect2">
372 <a name="example-object-manager-client-new-for-bus-finish"></a><h3>example_object_manager_client_new_for_bus_finish ()</h3>
373 <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * example_object_manager_client_new_for_bus_finish
374                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
375                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
376 <p>
377 Finishes an operation started with <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus" title="example_object_manager_client_new_for_bus ()"><code class="function">example_object_manager_client_new_for_bus()</code></a>.
378 </p>
379 <div class="variablelist"><table border="0">
380 <col align="left" valign="top">
381 <tbody>
382 <tr>
383 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
384 <td>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus" title="example_object_manager_client_new_for_bus ()"><code class="function">example_object_manager_client_new_for_bus()</code></a>.</td>
385 </tr>
386 <tr>
387 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
388 <td>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
389 </td>
390 </tr>
391 <tr>
392 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
393 <td>The constructed object manager client or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleObjectManagerClient]</span>
394 </td>
395 </tr>
396 </tbody>
397 </table></div>
398 </div>
399 <hr>
400 <div class="refsect2">
401 <a name="example-object-manager-client-new-for-bus-sync"></a><h3>example_object_manager_client_new_for_bus_sync ()</h3>
402 <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManager.html"><span class="returnvalue">GDBusObjectManager</span></a> * example_object_manager_client_new_for_bus_sync
403                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
404                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> flags</code></em>,
405                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
406                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
407                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
408                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
409 <p>
410 Like <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-sync" title="example_object_manager_client_new_sync ()"><code class="function">example_object_manager_client_new_sync()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.
411 </p>
412 <p>
413 The calling thread is blocked until a reply is received.
414 </p>
415 <p>
416 See <a class="link" href="ExampleObjectManagerClient.html#example-object-manager-client-new-for-bus" title="example_object_manager_client_new_for_bus ()"><code class="function">example_object_manager_client_new_for_bus()</code></a> for the asynchronous version of this constructor.
417 </p>
418 <div class="variablelist"><table border="0">
419 <col align="left" valign="top">
420 <tbody>
421 <tr>
422 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
423 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</td>
424 </tr>
425 <tr>
426 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
427 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags"><span class="type">GDBusObjectManagerClientFlags</span></a> enumeration.</td>
428 </tr>
429 <tr>
430 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
431 <td>A bus name (well-known or unique).</td>
432 </tr>
433 <tr>
434 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
435 <td>An object path.</td>
436 </tr>
437 <tr>
438 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
439 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
440 </td>
441 </tr>
442 <tr>
443 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
444 <td>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
445 </td>
446 </tr>
447 <tr>
448 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
449 <td>The constructed object manager client or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleObjectManagerClient]</span>
450 </td>
451 </tr>
452 </tbody>
453 </table></div>
454 </div>
455 </div>
456 </div>
457 <div class="footer">
458 <hr>
459           Generated by GTK-Doc V1.18</div>
460 </body>
461 </html>