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