~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

<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> ()

121

</div>

122

123

<a name="ExampleObjectManagerClient.object-hierarchy"></a><h2>Object Hierarchy</h2>

124

<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

124

<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

125

╰── <a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</a>

126

╰── ExampleObjectManagerClient

127

</pre>

140

<a name="ExampleObjectManagerClient.functions_details"></a><h2>Functions</h2>

141

142

<a name="example-object-manager-client-get-proxy-type"></a><h3>example_object_manager_client_get_proxy_type ()</h3>

143

<pre class="programlisting"><a href="../gobject/gobject-Type-Information.html#GType">GType</a>

143

<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a>

144

example_object_manager_client_get_proxy_type

145

(<code><a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</a> *manager</code>,

146

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

147

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *interface_name</code>,

148

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

146

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

147

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *interface_name</code>,

148

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

149

A <a class="link" href="GDBusObjectManagerClient.html#GDBusProxyTypeFunc" title="GDBusProxyTypeFunc ()">GDBusProxyTypeFunc</a> that maps <code>interface_name</code>

150

to the generated <a class="link" href="GDBusObjectProxy.html" title="GDBusObjectProxy">GDBusObjectProxy</a>- and <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>-derived types.

151

169

</tr>

170

<tr>

171

<td class="parameter_name">interface_name</td>

172

<td class="parameter_description"> Interface name of the remote object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to get the object proxy <a href="../gobject/gobject-Type-Information.html#GType">GType</a>. </td>

172

<td class="parameter_description"> 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">GType</a>. </td>

173

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

174

</tr>

175

<tr>

182

</div>

183

184

<a name="id-1.5.5.6.8.8.2.6"></a><h4>Returns</h4>

185

A <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>-derived <a href="../gobject/gobject-Type-Information.html#GType">GType</a> if <code>interface_name</code>

186

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, otherwise the <a href="../gobject/gobject-Type-Information.html#GType">GType</a> for <a class="link" href="ExampleObject.html#ExampleObjectProxy">ExampleObjectProxy</a>.

185

A <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>-derived <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> if <code>interface_name</code>

186

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">GType</a> for <a class="link" href="ExampleObject.html#ExampleObjectProxy">ExampleObjectProxy</a>.

187

188

</div>

189

</div>

193

<pre class="programlisting">void

194

example_object_manager_client_new (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>,

195

<code><a class="link" href="GDBusObjectManagerClient.html#GDBusObjectManagerClientFlags" title="enum GDBusObjectManagerClientFlags">GDBusObjectManagerClientFlags</a> flags</code>,

196

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

197

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

196

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

197

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

198

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

199

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

200

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

200

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

201

Asynchronously creates <a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</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 ()">GDBusProxyTypeFunc</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.

202

When the operation is finished, <code>callback</code>

203

will be invoked in the <a href="../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.

203

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.

204

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.

205

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.

206

224

</tr>

225

<tr>

226

227

<td class="parameter_description"> A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>connection</code>

227

<td class="parameter_description"> 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 <code>connection</code>

228

is not a message bus connection. </td>

229

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

230

</tr>

235

</tr>

236

<tr>

237

<td class="parameter_name">cancellable</td>

238

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

238

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

239

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

240

</tr>

241

<tr>

259

<pre class="programlisting"><a class="link" href="GDBusObjectManager.html" title="GDBusObjectManager">GDBusObjectManager</a> *

260

example_object_manager_client_new_finish

261

(<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

262

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

262

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

263

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>.

264

265

<a name="id-1.5.5.6.8.8.4.5"></a><h4>Parameters</h4>

277

</tr>

278

<tr>

279

<td class="parameter_name">error</td>

280

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

280

<td class="parameter_description">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></td>

281

282

</tr>

283

</tbody>

285

</div>

286

287

<a name="id-1.5.5.6.8.8.4.6"></a><h4>Returns</h4>

288

The constructed object manager client or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

288

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 <code>error</code>

289

is set.

290

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Override the parsed C type with given type.">type</acronym> ExampleObjectManagerClient]

291

</div>

297

example_object_manager_client_new_sync

298

(<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>,

299

300

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

301

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

300

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

301

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

302

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

303

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

303

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

304

Synchronously creates <a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</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 ()">GDBusProxyTypeFunc</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.

305

The calling thread is blocked until a reply is received.

306

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.

325

</tr>

326

<tr>

327

328

329

is not a message bus connection. </td>

330

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

331

</tr>

336

</tr>

337

<tr>

338

<td class="parameter_name">cancellable</td>

339

340

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

341

</tr>

342

<tr>

343

<td class="parameter_name">error</td>

344

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

344

345

346

</tr>

347

</tbody>

349

</div>

350

351

<a name="id-1.5.5.6.8.8.5.8"></a><h4>Returns</h4>

352

The constructed object manager client or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

352

353

is set.

354

355

</div>

361

example_object_manager_client_new_for_bus

362

(<code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> bus_type</code>,

363

364

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

365

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

364

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

365

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

366

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

367

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

368

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

368

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

369

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">GBusType</a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>.

370

When the operation is finished, <code>callback</code>

371

will be invoked in the <a href="../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.

371

372

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.

373

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.

374

402

</tr>

403

<tr>

404

<td class="parameter_name">cancellable</td>

405

406

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

407

</tr>

408

<tr>

426

<pre class="programlisting"><a class="link" href="GDBusObjectManager.html" title="GDBusObjectManager">GDBusObjectManager</a> *

427

example_object_manager_client_new_for_bus_finish

428

(<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

429

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

429

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

430

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>.

431

432

<a name="id-1.5.5.6.8.8.7.5"></a><h4>Parameters</h4>

444

</tr>

445

<tr>

446

<td class="parameter_name">error</td>

447

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

447

448

449

</tr>

450

</tbody>

452

</div>

453

454

<a name="id-1.5.5.6.8.8.7.6"></a><h4>Returns</h4>

455

The constructed object manager client or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

455

456

is set.

457

458

</div>

464

example_object_manager_client_new_for_bus_sync

465

(<code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> bus_type</code>,

466

467

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

468

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

467

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

468

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

469

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

470

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

470

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

471

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">GBusType</a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>.

472

The calling thread is blocked until a reply is received.

473

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.

502

</tr>

503

<tr>

504

<td class="parameter_name">cancellable</td>

505

506

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

507

</tr>

508

<tr>

509

<td class="parameter_name">error</td>

510

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

510

511

512

</tr>

513

</tbody>

515

</div>

516

517

<a name="id-1.5.5.6.8.8.8.8"></a><h4>Returns</h4>

518

The constructed object manager client or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

518

519

is set.

520

521

</div>

Older »