~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed : revision 203

133

</tr>

134

<tr>

135

136

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

136

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

137

</td>

138

139

<a class="link" href="GDBusConnection.html#g-dbus-connection-close-finish" title="g_dbus_connection_close_finish ()">g_dbus_connection_close_finish</a> ()

141

</tr>

142

<tr>

143

144

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

144

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

145

</td>

146

147

<a class="link" href="GDBusConnection.html#g-dbus-connection-close-sync" title="g_dbus_connection_close_sync ()">g_dbus_connection_close_sync</a> ()

149

</tr>

150

<tr>

151

152

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

152

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

153

</td>

154

155

<a class="link" href="GDBusConnection.html#g-dbus-connection-is-closed" title="g_dbus_connection_is_closed ()">g_dbus_connection_is_closed</a> ()

165

</tr>

166

<tr>

167

168

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

168

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

169

</td>

170

171

<a class="link" href="GDBusConnection.html#g-dbus-connection-flush-finish" title="g_dbus_connection_flush_finish ()">g_dbus_connection_flush_finish</a> ()

173

</tr>

174

<tr>

175

176

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

176

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

177

</td>

178

179

<a class="link" href="GDBusConnection.html#g-dbus-connection-flush-sync" title="g_dbus_connection_flush_sync ()">g_dbus_connection_flush_sync</a> ()

181

</tr>

182

<tr>

183

184

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

184

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

185

</td>

186

187

<a class="link" href="GDBusConnection.html#g-dbus-connection-get-exit-on-close" title="g_dbus_connection_get_exit_on_close ()">g_dbus_connection_get_exit_on_close</a> ()

204

</td>

205

</tr>

206

<tr>

207

<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

207

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

208

</td>

209

210

<a class="link" href="GDBusConnection.html#g-dbus-connection-get-guid" title="g_dbus_connection_get_guid ()">g_dbus_connection_get_guid</a> ()

211

</td>

212

</tr>

213

<tr>

214

<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

214

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

215

</td>

216

217

<a class="link" href="GDBusConnection.html#g-dbus-connection-get-unique-name" title="g_dbus_connection_get_unique_name ()">g_dbus_connection_get_unique_name</a> ()

235

</tr>

236

<tr>

237

238

<a href="../glib/glib-Basic-Types.html#guint32">guint32</a>

238

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a>

239

</td>

240

241

<a class="link" href="GDBusConnection.html#g-dbus-connection-get-last-serial" title="g_dbus_connection_get_last_serial ()">g_dbus_connection_get_last_serial</a> ()

251

</tr>

252

<tr>

253

254

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

254

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

255

</td>

256

257

<a class="link" href="GDBusConnection.html#g-dbus-connection-call-finish" title="g_dbus_connection_call_finish ()">g_dbus_connection_call_finish</a> ()

259

</tr>

260

<tr>

261

262

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

262

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

263

</td>

264

265

<a class="link" href="GDBusConnection.html#g-dbus-connection-call-sync" title="g_dbus_connection_call_sync ()">g_dbus_connection_call_sync</a> ()

275

</tr>

276

<tr>

277

278

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

278

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

279

</td>

280

281

<a class="link" href="GDBusConnection.html#g-dbus-connection-call-with-unix-fd-list-finish" title="g_dbus_connection_call_with_unix_fd_list_finish ()">g_dbus_connection_call_with_unix_fd_list_finish</a> ()

283

</tr>

284

<tr>

285

286

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

286

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

287

</td>

288

289

<a class="link" href="GDBusConnection.html#g-dbus-connection-call-with-unix-fd-list-sync" title="g_dbus_connection_call_with_unix_fd_list_sync ()">g_dbus_connection_call_with_unix_fd_list_sync</a> ()

291

</tr>

292

<tr>

293

294

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

294

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

295

</td>

296

297

<a class="link" href="GDBusConnection.html#g-dbus-connection-emit-signal" title="g_dbus_connection_emit_signal ()">g_dbus_connection_emit_signal</a> ()

307

</tr>

308

<tr>

309

310

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

310

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

311

</td>

312

313

<a class="link" href="GDBusConnection.html#g-dbus-connection-signal-subscribe" title="g_dbus_connection_signal_subscribe ()">g_dbus_connection_signal_subscribe</a> ()

323

</tr>

324

<tr>

325

326

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

326

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

327

</td>

328

329

<a class="link" href="GDBusConnection.html#g-dbus-connection-send-message" title="g_dbus_connection_send_message ()">g_dbus_connection_send_message</a> ()

363

</tr>

364

<tr>

365

366

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

366

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

367

</td>

368

369

<a class="link" href="GDBusConnection.html#g-dbus-connection-add-filter" title="g_dbus_connection_add_filter ()">g_dbus_connection_add_filter</a> ()

387

</tr>

388

<tr>

389

390

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

390

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

391

</td>

392

393

(<a class="link" href="GDBusConnection.html#GDBusInterfaceGetPropertyFunc" title="GDBusInterfaceGetPropertyFunc ()">*GDBusInterfaceGetPropertyFunc</a>) ()

395

</tr>

396

<tr>

397

398

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

398

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

399

</td>

400

401

(<a class="link" href="GDBusConnection.html#GDBusInterfaceSetPropertyFunc" title="GDBusInterfaceSetPropertyFunc ()">*GDBusInterfaceSetPropertyFunc</a>) ()

403

</tr>

404

<tr>

405

406

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

406

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

407

</td>

408

409

<a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()">g_dbus_connection_register_object</a> ()

411

</tr>

412

<tr>

413

414

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

414

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

415

</td>

416

417

<a class="link" href="GDBusConnection.html#g-dbus-connection-unregister-object" title="g_dbus_connection_unregister_object ()">g_dbus_connection_unregister_object</a> ()

419

</tr>

420

<tr>

421

422

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

422

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

423

</td>

424

425

(<a class="link" href="GDBusConnection.html#GDBusSubtreeEnumerateFunc" title="GDBusSubtreeEnumerateFunc ()">*GDBusSubtreeEnumerateFunc</a>) ()

442

</tr>

443

<tr>

444

445

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

445

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

446

</td>

447

448

<a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()">g_dbus_connection_register_subtree</a> ()

450

</tr>

451

<tr>

452

453

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

453

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

454

</td>

455

456

<a class="link" href="GDBusConnection.html#g-dbus-connection-unregister-subtree" title="g_dbus_connection_unregister_subtree ()">g_dbus_connection_unregister_subtree</a> ()

470

<tbody>

471

<tr>

472

473

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</td>

473

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

474

<td class="property_name"><a class="link" href="GDBusConnection.html#GDBusConnection--address" title="The “address” property">address</a></td>

475

<td class="property_flags">Write / Construct Only</td>

476

</tr>

486

487

</tr>

488

<tr>

489

<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></td>

489

<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a></td>

490

<td class="property_name"><a class="link" href="GDBusConnection.html#GDBusConnection--closed" title="The “closed” property">closed</a></td>

491

492

</tr>

493

<tr>

494

<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></td>

494

<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a></td>

495

<td class="property_name"><a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">exit-on-close</a></td>

496

<td class="property_flags">Read / Write</td>

497

</tr>

502

</tr>

503

<tr>

504

505

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</td>

505

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

506

507

<td class="property_flags">Read / Write / Construct Only</td>

508

</tr>

514

</tr>

515

<tr>

516

517

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</td>

517

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

518

<td class="property_name"><a class="link" href="GDBusConnection.html#GDBusConnection--unique-name" title="The “unique-name” property">unique-name</a></td>

519

520

</tr>

532

533

534

<td class="signal_name"><a class="link" href="GDBusConnection.html#GDBusConnection-closed" title="The “closed” signal">closed</a></td>

535

535

536

</tr></tbody>

537

</table></div>

538

</div>

589

</div>

590

591

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

592

<pre class="screen"> <a href="/home/desrt/.cache/jhbuild/install/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a>

592

<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Enumeration-and-Flag-Types.html">GFlags</a>

593

├── GDBusCapabilityFlags

594

╰── GDBusConnectionFlags

595

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

595

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

596

╰── GDBusConnection

597

</pre>

598

</div>

627

<a class="link" href="GInitable.html#g-initable-new" title="g_initable_new ()"><code class="function">g_initable_new()</code></a> or <a class="link" href="GAsyncInitable.html#g-async-initable-new-async" title="g_async_initable_new_async ()"><code class="function">g_async_initable_new_async()</code></a>, which also initialize the

628

connection.

629

If you construct an uninitialized <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>, such as via

630

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>, you must initialize it via <a class="link" href="GInitable.html#g-initable-init" title="g_initable_init ()"><code class="function">g_initable_init()</code></a> or

630

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>, you must initialize it via <a class="link" href="GInitable.html#g-initable-init" title="g_initable_init ()"><code class="function">g_initable_init()</code></a> or

631

<a class="link" href="GAsyncInitable.html#g-async-initable-init-async" title="g_async_initable_init_async ()"><code class="function">g_async_initable_init_async()</code></a> before using its methods or properties.

632

Calling methods or accessing properties on a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> that has not

633

completed initialization successfully is considered to be invalid, and leads

634

to undefined behaviour. In particular, if initialization fails with a

635

<a href="../glib/glib-Error-Reporting.html#GError">GError</a>, the only valid thing you can do with that <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> is to

636

free it with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

635

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, the only valid thing you can do with that <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> is to

636

free it with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

637

638

<a name="gdbus-server"></a><h4>An example D-Bus server</h4>

639

Here is an example for a D-Bus server:

651

</div>

652

653

<a name="gdbus-export"></a><h4>An example for exporting a GObject</h4>

654

Here is an example for exporting a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>:

654

Here is an example for exporting a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>:

655

<a class="ulink" href="https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-export.c" target="_top">gdbus-example-export.c</a>

656

</div>

657

</div>

663

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

664

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

665

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

666

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

666

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

667

Asynchronously connects to the message bus specified by <code>bus_type</code>

668

.

669

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

687

</tr>

688

<tr>

689

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

690

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

690

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

691

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

692

</tr>

693

<tr>

711

<a name="g-bus-get-finish"></a><h3>g_bus_get_finish ()</h3>

712

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

713

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

714

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

714

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

715

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-bus-get" title="g_bus_get ()"><code class="function">g_bus_get()</code></a>.

716

The returned object is a singleton, that is, shared with other

717

callers of <a class="link" href="GDBusConnection.html#g-bus-get" title="g_bus_get ()"><code class="function">g_bus_get()</code></a> and <a class="link" href="GDBusConnection.html#g-bus-get-sync" title="g_bus_get_sync ()"><code class="function">g_bus_get_sync()</code></a> for <code>bus_type</code>

720

<a class="link" href="gio-D-Bus-Addresses.html#g-dbus-address-get-for-bus-sync" title="g_dbus_address_get_for_bus_sync ()"><code class="function">g_dbus_address_get_for_bus_sync()</code></a> and

721

<a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address" title="g_dbus_connection_new_for_address ()"><code class="function">g_dbus_connection_new_for_address()</code></a>.

722

Note that the returned <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> object will (usually) have

723

the <a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">“exit-on-close”</a> property set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

723

the <a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">“exit-on-close”</a> property set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

724

725

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

726

738

</tr>

739

<tr>

740

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

741

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

741

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

742

743

</tr>

744

</tbody>

746

</div>

747

748

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

749

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

749

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

750

is set.

751

Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

751

Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

752

[<acronym title="Free data after the code is done.">transfer full</acronym>]

753

</div>

754

Since 2.26

759

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

760

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

761

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

762

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

762

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

763

Synchronously connects to the message bus specified by <code>bus_type</code>

764

.

765

Note that the returned object may shared with other callers,

775

<a class="link" href="gio-D-Bus-Addresses.html#g-dbus-address-get-for-bus-sync" title="g_dbus_address_get_for_bus_sync ()"><code class="function">g_dbus_address_get_for_bus_sync()</code></a> and

776

<a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address" title="g_dbus_connection_new_for_address ()"><code class="function">g_dbus_connection_new_for_address()</code></a>.

777

Note that the returned <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> object will (usually) have

778

the <a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">“exit-on-close”</a> property set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

778

the <a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">“exit-on-close”</a> property set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

779

780

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

781

792

</tr>

793

<tr>

794

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

795

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

795

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

796

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

797

</tr>

798

<tr>

799

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

800

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

800

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

801

802

</tr>

803

</tbody>

805

</div>

806

807

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

808

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

808

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

809

is set.

810

Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

810

Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

811

[<acronym title="Free data after the code is done.">transfer full</acronym>]

812

</div>

813

Since 2.26

817

<a name="g-dbus-connection-new"></a><h3>g_dbus_connection_new ()</h3>

818

<pre class="programlisting">void

819

g_dbus_connection_new (<code><a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a> *stream</code>,

820

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

820

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

821

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

822

<code><a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> *observer</code>,

823

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

824

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

825

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

825

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

826

Asynchronously sets up a D-Bus connection for exchanging D-Bus messages

827

with the end represented by <code>stream</code>

828

.

833

from a worker thread.

834

As a result, the caller should not interact with <code>stream</code>

835

after this

836

method has been called, except by calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on it.

836

method has been called, except by calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on it.

837

If <code>observer</code>

838

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

838

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

839

authentication process.

840

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

841

will be invoked. You can

860

</tr>

861

<tr>

862

863

<td class="parameter_description"> the GUID to use if a authenticating as a server or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

863

<td class="parameter_description"> the GUID to use if a authenticating as a server or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

864

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

865

</tr>

866

<tr>

870

</tr>

871

<tr>

872

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

873

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

873

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

874

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

875

</tr>

876

<tr>

877

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

878

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

878

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

879

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

880

</tr>

881

<tr>

899

<a name="g-dbus-connection-new-finish"></a><h3>g_dbus_connection_new_finish ()</h3>

900

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

901

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

902

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

902

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

903

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-new" title="g_dbus_connection_new ()"><code class="function">g_dbus_connection_new()</code></a>.

904

905

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

918

</tr>

919

<tr>

920

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

921

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

921

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

922

923

</tr>

924

</tbody>

926

</div>

927

928

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

929

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

929

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

930

is set. Free

931

with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

931

with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

932

933

</div>

934

Since 2.26

938

<a name="g-dbus-connection-new-sync"></a><h3>g_dbus_connection_new_sync ()</h3>

939

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

940

g_dbus_connection_new_sync (<code><a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a> *stream</code>,

941

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

941

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

942

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

943

<code><a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> *observer</code>,

944

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

945

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

945

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

946

Synchronously sets up a D-Bus connection for exchanging D-Bus messages

947

with the end represented by <code>stream</code>

948

.

953

from a worker thread.

954

As a result, the caller should not interact with <code>stream</code>

955

after this

956

method has been called, except by calling <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on it.

956

method has been called, except by calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on it.

957

If <code>observer</code>

958

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

958

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

959

authentication process.

960

This is a synchronous failable constructor. See

961

<a class="link" href="GDBusConnection.html#g-dbus-connection-new" title="g_dbus_connection_new ()"><code class="function">g_dbus_connection_new()</code></a> for the asynchronous version.

975

</tr>

976

<tr>

977

978

<td class="parameter_description"> the GUID to use if a authenticating as a server or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

978

<td class="parameter_description"> the GUID to use if a authenticating as a server or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

979

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

980

</tr>

981

<tr>

985

</tr>

986

<tr>

987

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

988

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

988

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

989

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

990

</tr>

991

<tr>

992

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

993

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

993

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

994

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

995

</tr>

996

<tr>

997

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

998

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

998

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

999

1000

</tr>

1001

</tbody>

1003

</div>

1004

1005

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

1006

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

1007

is set. Free with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1006

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

1007

is set. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1008

1009

</div>

1010

Since 2.26

1013

1014

<a name="g-dbus-connection-new-for-address"></a><h3>g_dbus_connection_new_for_address ()</h3>

1015

<pre class="programlisting">void

1016

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

1016

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

1017

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

1018

<code><a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> *observer</code>,

1019

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

1020

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

1021

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

1021

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

1022

Asynchronously connects and sets up a D-Bus client connection for

1023

exchanging D-Bus messages with an endpoint specified by <code>address</code>

1024

1034

then call <a class="link" href="GDBusConnection.html#g-dbus-connection-new-finish" title="g_dbus_connection_new_finish ()"><code class="function">g_dbus_connection_new_finish()</code></a> to get the result of the

1035

operation.

1036

If <code>observer</code>

1037

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

1037

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

1038

authentication process.

1039

This is a asynchronous failable constructor. See

1040

<a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address-sync" title="g_dbus_connection_new_for_address_sync ()"><code class="function">g_dbus_connection_new_for_address_sync()</code></a> for the synchronous

1060

</tr>

1061

<tr>

1062

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

1063

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

1063

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

1064

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

1065

</tr>

1066

<tr>

1067

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

1068

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

1068

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

1069

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

1070

</tr>

1071

<tr>

1090

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

1091

g_dbus_connection_new_for_address_finish

1092

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

1093

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

1093

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

1094

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address" title="g_dbus_connection_new_for_address ()"><code class="function">g_dbus_connection_new_for_address()</code></a>.

1095

1096

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

1109

</tr>

1110

<tr>

1111

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

1112

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

1112

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

1113

1114

</tr>

1115

</tbody>

1117

</div>

1118

1119

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

1120

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

1120

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

1121

is set. Free with

1122

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1122

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1123

1124

</div>

1125

Since 2.26

1129

<a name="g-dbus-connection-new-for-address-sync"></a><h3>g_dbus_connection_new_for_address_sync ()</h3>

1130

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

1131

g_dbus_connection_new_for_address_sync

1132

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

1132

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

1133

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

1134

<code><a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> *observer</code>,

1135

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

1136

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

1136

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

1137

Synchronously connects and sets up a D-Bus client connection for

1138

exchanging D-Bus messages with an endpoint specified by <code>address</code>

1139

1147

This is a synchronous failable constructor. See

1148

<a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address" title="g_dbus_connection_new_for_address ()"><code class="function">g_dbus_connection_new_for_address()</code></a> for the asynchronous version.

1149

If <code>observer</code>

1150

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

1150

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it may be used to control the

1151

authentication process.

1152

1153

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

1170

</tr>

1171

<tr>

1172

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

1173

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

1173

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

1174

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

1175

</tr>

1176

<tr>

1177

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

1178

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

1178

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

1179

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

1180

</tr>

1181

<tr>

1182

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

1183

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

1183

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

1184

1185

</tr>

1186

</tbody>

1188

</div>

1189

1190

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

1191

a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

1191

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

1192

is set. Free with

1193

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1193

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1194

1195

</div>

1196

Since 2.26

1231

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

1232

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

1233

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

1234

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

1234

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

1235

Closes <code>connection</code>

1236

. Note that this never causes the process to

1237

exit (this might only happen if the other end of a shared message

1246

When <code>connection</code>

1247

has been closed, the <a class="link" href="GDBusConnection.html#GDBusConnection-closed" title="The “closed” signal">“closed”</a>

1248

signal is emitted in the

1249

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1249

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1250

of the thread that <code>connection</code>

1251

was constructed in.

1252

This is an asynchronous method. When the operation is finished,

1253

<code>callback</code>

1254

will be invoked in the

1255

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1255

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1256

of the thread you are calling this method from. You can

1257

then call <a class="link" href="GDBusConnection.html#g-dbus-connection-close-finish" title="g_dbus_connection_close_finish ()"><code class="function">g_dbus_connection_close_finish()</code></a> to get the result of the

1258

operation. See <a class="link" href="GDBusConnection.html#g-dbus-connection-close-sync" title="g_dbus_connection_close_sync ()"><code class="function">g_dbus_connection_close_sync()</code></a> for the synchronous

1273

</tr>

1274

<tr>

1275

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

1276

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

1276

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

1277

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

1278

</tr>

1279

<tr>

1280

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

1281

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request is

1282

satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

1282

satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

1283

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

1284

</tr>

1285

<tr>

1296

<hr>

1297

1298

<a name="g-dbus-connection-close-finish"></a><h3>g_dbus_connection_close_finish ()</h3>

1299

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1299

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1300

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

1301

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

1302

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

1302

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

1303

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-close" title="g_dbus_connection_close ()"><code class="function">g_dbus_connection_close()</code></a>.

1304

1305

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

1323

</tr>

1324

<tr>

1325

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

1326

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

1326

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

1327

1328

</tr>

1329

</tbody>

1331

</div>

1332

1333

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

1334

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1334

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1335

is set

1336

1337

</div>

1340

<hr>

1341

1342

<a name="g-dbus-connection-close-sync"></a><h3>g_dbus_connection_close_sync ()</h3>

1343

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1343

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1344

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

1345

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

1346

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

1346

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

1347

Synchronously closees <code>connection</code>

1348

. The calling thread is blocked

1349

until this is done. See <a class="link" href="GDBusConnection.html#g-dbus-connection-close" title="g_dbus_connection_close ()"><code class="function">g_dbus_connection_close()</code></a> for the

1365

</tr>

1366

<tr>

1367

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

1368

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

1368

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

1369

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

1370

</tr>

1371

<tr>

1372

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

1373

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

1373

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

1374

1375

</tr>

1376

</tbody>

1378

</div>

1379

1380

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

1381

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1381

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1382

is set

1383

1384

</div>

1387

<hr>

1388

1389

<a name="g-dbus-connection-is-closed"></a><h3>g_dbus_connection_is_closed ()</h3>

1390

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1390

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1391

g_dbus_connection_is_closed (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>);</pre>

1392

Gets whether <code>connection</code>

1393

is closed.

1408

</div>

1409

1410

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

1411

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the connection is closed, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

1411

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the connection is closed, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

1412

1413

</div>

1414

Since 2.26

1420

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

1421

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

1422

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

1423

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

1423

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

1424

Asynchronously flushes <code>connection</code>

1425

, that is, writes all queued

1426

outgoing message to the transport and then flushes the transport

1431

This is an asynchronous method. When the operation is finished,

1432

<code>callback</code>

1433

will be invoked in the

1434

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1434

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1435

of the thread you are calling this method from. You can

1436

then call <a class="link" href="GDBusConnection.html#g-dbus-connection-flush-finish" title="g_dbus_connection_flush_finish ()"><code class="function">g_dbus_connection_flush_finish()</code></a> to get the result of the

1437

operation. See <a class="link" href="GDBusConnection.html#g-dbus-connection-flush-sync" title="g_dbus_connection_flush_sync ()"><code class="function">g_dbus_connection_flush_sync()</code></a> for the synchronous

1452

</tr>

1453

<tr>

1454

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

1455

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

1455

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

1456

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

1457

</tr>

1458

<tr>

1459

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

1460

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the

1461

request is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

1461

request is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

1462

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

1463

</tr>

1464

<tr>

1475

<hr>

1476

1477

<a name="g-dbus-connection-flush-finish"></a><h3>g_dbus_connection_flush_finish ()</h3>

1478

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1478

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1479

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

1480

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

1481

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

1481

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

1482

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-flush" title="g_dbus_connection_flush ()"><code class="function">g_dbus_connection_flush()</code></a>.

1483

1484

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

1502

</tr>

1503

<tr>

1504

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

1505

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

1505

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

1506

1507

</tr>

1508

</tbody>

1510

</div>

1511

1512

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

1513

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1513

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1514

is set

1515

1516

</div>

1519

<hr>

1520

1521

<a name="g-dbus-connection-flush-sync"></a><h3>g_dbus_connection_flush_sync ()</h3>

1522

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1522

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1523

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

1524

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

1525

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

1525

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

1526

Synchronously flushes <code>connection</code>

1527

. The calling thread is blocked

1528

until this is done. See <a class="link" href="GDBusConnection.html#g-dbus-connection-flush" title="g_dbus_connection_flush ()"><code class="function">g_dbus_connection_flush()</code></a> for the

1544

</tr>

1545

<tr>

1546

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

1547

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

1547

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

1548

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

1549

</tr>

1550

<tr>

1551

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

1552

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

1552

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

1553

1554

</tr>

1555

</tbody>

1557

</div>

1558

1559

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

1560

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1560

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

1561

is set

1562

1563

</div>

1566

<hr>

1567

1568

<a name="g-dbus-connection-get-exit-on-close"></a><h3>g_dbus_connection_get_exit_on_close ()</h3>

1569

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1569

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1570

g_dbus_connection_get_exit_on_close (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>);</pre>

1571

Gets whether the process is terminated when <code>connection</code>

1572

is

1601

<a name="g-dbus-connection-set-exit-on-close"></a><h3>g_dbus_connection_set_exit_on_close ()</h3>

1602

<pre class="programlisting">void

1603

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

1604

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

1604

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

1605

Sets whether the process should be terminated when <code>connection</code>

1606

is

1607

closed by the remote peer. See <a class="link" href="GDBusConnection.html#GDBusConnection--exit-on-close" title="The “exit-on-close” property">“exit-on-close”</a> for

1610

desktops tie the notion of a user session the session bus, and expect

1611

all of a users applications to quit when their bus connection goes away.

1612

If you are setting <code>exit_on_close</code>

1613

to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for the shared session

1613

to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for the shared session

1614

bus connection, you should make sure that your application exits

1615

when the user session ends.

1616

1673

<hr>

1674

1675

<a name="g-dbus-connection-get-guid"></a><h3>g_dbus_connection_get_guid ()</h3>

1676

<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

1676

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

1677

g_dbus_connection_get_guid (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>);</pre>

1678

The GUID of the peer performing the role of server when

1679

authenticating. See <a class="link" href="GDBusConnection.html#GDBusConnection--guid" title="The “guid” property">“guid”</a> for more details.

1704

<hr>

1705

1706

<a name="g-dbus-connection-get-unique-name"></a><h3>g_dbus_connection_get_unique_name ()</h3>

1707

<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

1707

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

1708

g_dbus_connection_get_unique_name (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>);</pre>

1709

Gets the unique name of <code>connection</code>

1710

as assigned by the message

1728

</div>

1729

1730

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

1731

the unique name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>connection</code>

1731

the unique name 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>

1732

is not a message

1733

bus connection. Do not free this string, it is owned by

1734

<code>connection</code>

1772

g_dbus_connection_get_peer_credentials

1773

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

1774

Gets the credentials of the authenticated peer. This will always

1775

return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> unless <code>connection</code>

1775

return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> unless <code>connection</code>

1776

acted as a server

1777

(e.g. <a class="link" href="GDBusConnection.html#G-DBUS-CONNECTION-FLAGS-AUTHENTICATION-SERVER:CAPS"><code class="literal">G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER</code></a> was passed)

1778

when set up and the client passed credentials as part of the

1779

authentication process.

1780

In a message bus setup, the message bus is always the server and

1781

each application is a client. So this method will always return

1782

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for message bus clients.

1782

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for message bus clients.

1783

1784

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

1785

1797

</div>

1798

1799

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

1800

a <a class="link" href="GCredentials.html" title="GCredentials">GCredentials</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not available.

1800

a <a class="link" href="GCredentials.html" title="GCredentials">GCredentials</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not available.

1801

Do not free this object, it is owned by <code>connection</code>

1802

.

1803

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1807

<hr>

1808

1809

<a name="g-dbus-connection-get-last-serial"></a><h3>g_dbus_connection_get_last_serial ()</h3>

1810

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32">guint32</a>

1810

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a>

1811

g_dbus_connection_get_last_serial (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>);</pre>

1812

Retrieves the last serial number assigned to a <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> on

1813

the current thread. This includes messages sent via both low-level

1842

<a name="g-dbus-connection-call"></a><h3>g_dbus_connection_call ()</h3>

1843

<pre class="programlisting">void

1844

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

1845

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

1846

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

1847

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

1848

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

1849

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

1850

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

1845

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

1846

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

1847

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

1848

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

1849

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

1850

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

1851

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

1852

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

1852

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

1853

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

1854

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

1855

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

1855

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

1856

Asynchronously invokes the <code>method_name</code>

1857

method on the

1858

<code>interface_name</code>

1869

not compatible with the D-Bus protocol, the operation fails with

1870

<a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.

1871

If <code>reply_type</code>

1872

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the reply will be checked for having this type and an

1872

is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the reply will be checked for having this type and an

1873

error will be raised if it does not match. Said another way, if you give a <code>reply_type</code>

1874

1875

then any non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> return value will be of this type.

1875

then any non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> return value will be of this type.

1876

If the <code>parameters</code>

1877

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> is floating, it is consumed. This allows

1878

convenient 'inline' use of <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:

1877

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> is floating, it is consumed. This allows

1878

convenient 'inline' use of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:

1879

1880

1881

<tbody>

1899

"/org/freedesktop/StringThings",

1900

"org.freedesktop.StringThings",

1901

"TwoStrings",

1902

<a href="../glib/glib-GVariant.html#g-variant-new">g_variant_new</a> ("(ss)",

1902

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new">g_variant_new</a> ("(ss)",

1903

"Thing One",

1904

"Thing Two"),

1905

NULL,

1917

This is an asynchronous method. When the operation is finished,

1918

<code>callback</code>

1919

will be invoked in the

1920

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1920

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1921

of the thread you are calling this method from. You can then call

1922

<a class="link" href="GDBusConnection.html#g-dbus-connection-call-finish" title="g_dbus_connection_call_finish ()"><code class="function">g_dbus_connection_call_finish()</code></a> to get the result of the operation.

1923

See <a class="link" href="GDBusConnection.html#g-dbus-connection-call-sync" title="g_dbus_connection_call_sync ()"><code class="function">g_dbus_connection_call_sync()</code></a> for the synchronous version of this

1924

function.

1925

If <code>callback</code>

1926

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the D-Bus method call message will be sent with

1926

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the D-Bus method call message will be sent with

1927

the <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-FLAGS-NO-REPLY-EXPECTED:CAPS"><code class="literal">G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED</code></a> flag set.

1928

1929

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

1941

</tr>

1942

<tr>

1943

1944

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

1944

<td class="parameter_description"> a unique or well-known bus name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1945

<code>connection</code>

1946

is not a message bus connection. </td>

1947

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

1963

</tr>

1964

<tr>

1965

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

1966

<td class="parameter_description"> a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

1967

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

1966

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

1967

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

1968

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

1969

</tr>

1970

<tr>

1971

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

1972

<td class="parameter_description"> the expected type of the reply, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

1972

<td class="parameter_description"> the expected type of the reply, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

1973

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

1974

</tr>

1975

<tr>

1980

<tr>

1981

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

1982

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

1983

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

1983

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

1984

1985

</tr>

1986

<tr>

1987

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

1988

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

1988

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

1989

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

1990

</tr>

1991

<tr>

1992

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

1993

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request

1994

is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result of the

1994

is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result of the

1995

method invocation. </td>

1996

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

1997

</tr>

2009

<hr>

2010

2011

<a name="g-dbus-connection-call-finish"></a><h3>g_dbus_connection_call_finish ()</h3>

2012

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

2012

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

2013

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

2014

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

2015

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

2015

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

2016

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-call" title="g_dbus_connection_call ()"><code class="function">g_dbus_connection_call()</code></a>.

2017

2018

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

2035

</tr>

2036

<tr>

2037

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

2038

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

2038

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

2039

2040

</tr>

2041

</tbody>

2043

</div>

2044

2045

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

2046

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

2047

is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with

2048

return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2046

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

2047

is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with

2048

return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2049

2050

</div>

2051

Since 2.26

2053

<hr>

2054

2055

<a name="g-dbus-connection-call-sync"></a><h3>g_dbus_connection_call_sync ()</h3>

2056

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

2056

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

2057

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

2058

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

2059

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

2060

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

2061

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

2062

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2063

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2058

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

2059

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

2060

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

2061

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

2062

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2063

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2064

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

2065

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2065

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2066

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

2067

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

2067

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

2068

Synchronously invokes the <code>method_name</code>

2069

method on the

2070

<code>interface_name</code>

2081

contains a value not compatible with the D-Bus protocol, the operation

2082

fails with <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a>.

2083

If <code>reply_type</code>

2084

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the reply will be checked for having

2084

is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then the reply will be checked for having

2085

this type and an error will be raised if it does not match. Said

2086

another way, if you give a <code>reply_type</code>

2087

then any non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> return

2087

then any non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> return

2088

value will be of this type.

2089

If the <code>parameters</code>

2090

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> is floating, it is consumed.

2091

This allows convenient 'inline' use of <a href="../glib/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:

2090

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> is floating, it is consumed.

2091

This allows convenient 'inline' use of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>, e.g.:

2092

2093

2094

<tbody>

2111

"/org/freedesktop/StringThings",

2112

"org.freedesktop.StringThings",

2113

"TwoStrings",

2114

<a href="../glib/glib-GVariant.html#g-variant-new">g_variant_new</a> ("(ss)",

2114

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new">g_variant_new</a> ("(ss)",

2115

"Thing One",

2116

"Thing Two"),

2117

NULL,

2144

</tr>

2145

<tr>

2146

2147

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

2147

<td class="parameter_description"> a unique or well-known bus name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

2148

<code>connection</code>

2149

is not a message bus connection. </td>

2150

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

2166

</tr>

2167

<tr>

2168

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

2169

<td class="parameter_description"> a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

2170

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2169

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

2170

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2171

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

2172

</tr>

2173

<tr>

2174

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

2175

<td class="parameter_description"> the expected type of the reply, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2175

<td class="parameter_description"> the expected type of the reply, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2176

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

2177

</tr>

2178

<tr>

2183

<tr>

2184

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

2185

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

2186

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2186

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2187

2188

</tr>

2189

<tr>

2190

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

2191

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

2191

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

2192

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

2193

</tr>

2194

<tr>

2195

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

2196

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

2196

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

2197

2198

</tr>

2199

</tbody>

2201

</div>

2202

2203

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

2204

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

2205

is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with

2206

return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2204

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

2205

is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with

2206

return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2207

2208

</div>

2209

Since 2.26

2214

<pre class="programlisting">void

2215

g_dbus_connection_call_with_unix_fd_list

2216

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

2217

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

2218

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

2219

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

2220

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

2221

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2222

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2217

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

2218

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

2219

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

2220

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

2221

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2222

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2223

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

2224

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2224

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2225

<code><a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> *fd_list</code>,

2226

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

2227

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

2228

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

2228

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

2229

Like <a class="link" href="GDBusConnection.html#g-dbus-connection-call" title="g_dbus_connection_call ()"><code class="function">g_dbus_connection_call()</code></a> but also takes a <a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> object.

2230

This method is only available on UNIX.

2231

2244

</tr>

2245

<tr>

2246

2247

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

2247

<td class="parameter_description"> a unique or well-known bus name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

2248

<code>connection</code>

2249

is not a message bus connection. </td>

2250

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

2266

</tr>

2267

<tr>

2268

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

2269

<td class="parameter_description"> a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

2270

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2269

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the method

2270

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2271

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

2272

</tr>

2273

<tr>

2274

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

2275

<td class="parameter_description"> the expected type of the reply, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2275

<td class="parameter_description"> the expected type of the reply, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2276

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

2277

</tr>

2278

<tr>

2283

<tr>

2284

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

2285

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

2286

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2286

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2287

2288

</tr>

2289

<tr>

2290

2291

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

2291

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

2292

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

2293

</tr>

2294

<tr>

2295

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

2296

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

2296

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

2297

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

2298

</tr>

2299

<tr>

2300

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

2301

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request is

2302

satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't * care about the result of the

2302

satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't * care about the result of the

2303

method invocation. </td>

2304

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

2305

</tr>

2317

<hr>

2318

2319

<a name="g-dbus-connection-call-with-unix-fd-list-finish"></a><h3>g_dbus_connection_call_with_unix_fd_list_finish ()</h3>

2320

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

2320

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

2321

g_dbus_connection_call_with_unix_fd_list_finish

2322

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

2323

<code><a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> **out_fd_list</code>,

2324

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

2325

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

2325

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

2326

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-call-with-unix-fd-list" title="g_dbus_connection_call_with_unix_fd_list ()"><code class="function">g_dbus_connection_call_with_unix_fd_list()</code></a>.

2327

2328

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

2340

</tr>

2341

<tr>

2342

2343

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

2343

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

2344

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

2345

</tr>

2346

<tr>

2351

</tr>

2352

<tr>

2353

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

2354

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

2354

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

2355

2356

</tr>

2357

</tbody>

2359

</div>

2360

2361

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

2362

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

2363

is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with

2364

return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2362

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

2363

is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with

2364

return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2365

2366

</div>

2367

Since 2.30

2369

<hr>

2370

2371

<a name="g-dbus-connection-call-with-unix-fd-list-sync"></a><h3>g_dbus_connection_call_with_unix_fd_list_sync ()</h3>

2372

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

2372

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

2373

g_dbus_connection_call_with_unix_fd_list_sync

2374

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

2375

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

2376

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

2377

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

2378

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

2379

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2380

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2375

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

2376

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

2377

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

2378

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

2379

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2380

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *reply_type</code>,

2381

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

2382

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2382

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2383

<code><a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> *fd_list</code>,

2384

<code><a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> **out_fd_list</code>,

2385

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

2386

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

2386

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

2387

Like <a class="link" href="GDBusConnection.html#g-dbus-connection-call-sync" title="g_dbus_connection_call_sync ()"><code class="function">g_dbus_connection_call_sync()</code></a> but also takes and returns <a class="link" href="GUnixFDList.html" title="GUnixFDList">GUnixFDList</a> objects.

2388

This method is only available on UNIX.

2389

2402

</tr>

2403

<tr>

2404

2405

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

2405

<td class="parameter_description"> a unique or well-known bus name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2406

if <code>connection</code>

2407

is not a message bus connection. </td>

2408

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

2424

</tr>

2425

<tr>

2426

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

2427

<td class="parameter_description"> a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for

2428

the method or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2427

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for

2428

the method or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2429

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

2430

</tr>

2431

<tr>

2432

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

2433

<td class="parameter_description"> the expected type of the reply, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2433

<td class="parameter_description"> the expected type of the reply, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2434

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

2435

</tr>

2436

<tr>

2441

<tr>

2442

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

2443

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

2444

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2444

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2445

2446

</tr>

2447

<tr>

2448

2449

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

2449

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

2450

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

2451

</tr>

2452

<tr>

2453

2454

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

2454

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

2455

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

2456

</tr>

2457

<tr>

2458

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

2459

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

2459

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

2460

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

2461

</tr>

2462

<tr>

2463

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

2464

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

2464

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

2465

2466

</tr>

2467

</tbody>

2469

</div>

2470

2471

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

2472

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

2473

is set. Otherwise a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with

2474

return values. Free with <a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2472

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

2473

is set. Otherwise a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with

2474

return values. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.

2475

2476

</div>

2477

Since 2.30

2479

<hr>

2480

2481

<a name="g-dbus-connection-emit-signal"></a><h3>g_dbus_connection_emit_signal ()</h3>

2482

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2482

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

2483

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

2484

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

2485

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

2486

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

2487

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

2488

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2489

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

2484

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

2485

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

2486

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

2487

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

2488

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2489

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

2490

Emits a signal.

2491

If the parameters GVariant is floating, it is consumed.

2492

This can only fail if <code>parameters</code>

2508

<tr>

2509

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

2510

<td class="parameter_description"> the unique bus name for the destination

2511

for the signal or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to emit to all listeners. </td>

2511

for the signal or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to emit to all listeners. </td>

2512

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

2513

</tr>

2514

<tr>

2528

</tr>

2529

<tr>

2530

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

2531

<td class="parameter_description"> a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the signal

2532

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2531

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the signal

2532

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not passing parameters. </td>

2533

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

2534

</tr>

2535

<tr>

2536

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

2537

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

2537

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

2538

2539

</tr>

2540

</tbody>

2542

</div>

2543

2544

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

2545

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> unless <code>error</code>

2545

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> unless <code>error</code>

2546

is set

2547

2548

</div>

2553

<a name="GDBusSignalCallback"></a><h3>GDBusSignalCallback ()</h3>

2554

<pre class="programlisting">void

2555

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

2556

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

2557

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

2558

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

2559

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

2560

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2561

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

2556

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

2557

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

2558

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

2559

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

2560

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

2561

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

2562

Signature for callback function used in <a class="link" href="GDBusConnection.html#g-dbus-connection-signal-subscribe" title="g_dbus_connection_signal_subscribe ()"><code class="function">g_dbus_connection_signal_subscribe()</code></a>.

2563

2564

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

2596

</tr>

2597

<tr>

2598

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

2599

<td class="parameter_description">A <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the signal.</td>

2599

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters for the signal.</td>

2600

2601

</tr>

2602

<tr>

2612

<hr>

2613

2614

<a name="g-dbus-connection-signal-subscribe"></a><h3>g_dbus_connection_signal_subscribe ()</h3>

2615

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

2615

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

2616

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

2617

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

2618

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

2619

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

2620

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

2621

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

2617

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

2618

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

2619

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

2620

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

2621

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

2622

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

2623

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

2624

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

2625

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

2624

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

2625

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

2626

Subscribes to signals on <code>connection</code>

2627

and invokes <code>callback</code>

2628

with a whenever

2629

the signal is received. Note that <code>callback</code>

2630

will be invoked in the

2631

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

2631

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

2632

of the thread you are calling this method from.

2633

If <code>connection</code>

2634

is not a message bus connection, <code>sender</code>

2635

must be

2636

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2636

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

2637

If <code>sender</code>

2638

is a well-known name note that <code>callback</code>

2639

is invoked with

2665

<tr>

2666

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

2667

<td class="parameter_description"> sender name to match on (unique or well-known name)

2668

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to listen from all senders. </td>

2668

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to listen from all senders. </td>

2669

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

2670

</tr>

2671

<tr>

2672

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

2673

<td class="parameter_description"> D-Bus interface name to match on or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to

2673

<td class="parameter_description"> D-Bus interface name to match on or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to

2674

match on all interfaces. </td>

2675

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

2676

</tr>

2677

<tr>

2678

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

2679

<td class="parameter_description"> D-Bus signal name to match on or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to match on

2679

<td class="parameter_description"> D-Bus signal name to match on or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to match on

2680

all signals. </td>

2681

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

2682

</tr>

2683

<tr>

2684

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

2685

<td class="parameter_description"> object path to match on or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to match on

2685

<td class="parameter_description"> object path to match on or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to match on

2686

all object paths. </td>

2687

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

2688

</tr>

2689

<tr>

2690

2691

<td class="parameter_description"> contents of first string argument to match on or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2691

<td class="parameter_description"> contents of first string argument to match on or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

2692

to match on all kinds of arguments. </td>

2693

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

2694

</tr>

2712

2713

<td class="parameter_description"> function to free <code>user_data</code>

2714

with when

2715

subscription is removed or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2715

subscription is removed or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2716

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

2717

</tr>

2718

</tbody>

2730

<a name="g-dbus-connection-signal-unsubscribe"></a><h3>g_dbus_connection_signal_unsubscribe ()</h3>

2731

<pre class="programlisting">void

2732

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

2733

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

2733

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

2734

Unsubscribes from signals.

2735

2736

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

2760

<hr>

2761

2762

<a name="g-dbus-connection-send-message"></a><h3>g_dbus_connection_send_message ()</h3>

2763

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2763

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

2764

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

2765

<code><a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> *message</code>,

2766

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

2767

<code>volatile <a href="../glib/glib-Basic-Types.html#guint32">guint32</a> *out_serial</code>,

2768

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

2767

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

2768

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

2769

Asynchronously sends <code>message</code>

2770

to the peer represented by <code>connection</code>

2771

.

2776

and set on <code>message</code>

2777

via

2778

<a class="link" href="GDBusMessage.html#g-dbus-message-set-serial" title="g_dbus_message_set_serial ()"><code class="function">g_dbus_message_set_serial()</code></a>. If <code>out_serial</code>

2779

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

2779

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

2780

serial number used will be written to this location prior to

2781

submitting the message to the underlying transport.

2782

If <code>connection</code>

2819

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

2820

<td class="parameter_description"> return location for serial number assigned

2821

to <code>message</code>

2822

when sending it or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2822

when sending it or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2823

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

2824

</tr>

2825

<tr>

2826

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

2827

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

2827

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

2828

2829

</tr>

2830

</tbody>

2832

</div>

2833

2834

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

2835

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the message was well-formed and queued for

2836

transmission, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

2835

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the message was well-formed and queued for

2836

transmission, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

2837

is set

2838

2839

</div>

2847

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

2848

<code><a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> *message</code>,

2849

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

2850

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2851

<code>volatile <a href="../glib/glib-Basic-Types.html#guint32">guint32</a> *out_serial</code>,

2850

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

2851

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

2852

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

2853

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

2854

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

2854

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

2855

Asynchronously sends <code>message</code>

2856

to the peer represented by <code>connection</code>

2857

.

2862

and set on <code>message</code>

2863

via

2864

<a class="link" href="GDBusMessage.html#g-dbus-message-set-serial" title="g_dbus_message_set_serial ()"><code class="function">g_dbus_message_set_serial()</code></a>. If <code>out_serial</code>

2865

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

2865

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

2866

serial number used will be written to this location prior to

2867

submitting the message to the underlying transport.

2868

If <code>connection</code>

2875

This is an asynchronous method. When the operation is finished, <code>callback</code>

2876

2877

will be invoked in the

2878

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

2878

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

2879

of the thread you are calling this method from. You can then call

2880

<a class="link" href="GDBusConnection.html#g-dbus-connection-send-message-with-reply-finish" title="g_dbus_connection_send_message_with_reply_finish ()"><code class="function">g_dbus_connection_send_message_with_reply_finish()</code></a> to get the result of the operation.

2881

See <a class="link" href="GDBusConnection.html#g-dbus-connection-send-message-with-reply-sync" title="g_dbus_connection_send_message_with_reply_sync ()"><code class="function">g_dbus_connection_send_message_with_reply_sync()</code></a> for the synchronous version.

2913

<tr>

2914

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

2915

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

2916

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2916

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

2917

2918

</tr>

2919

<tr>

2920

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

2921

<td class="parameter_description"> return location for serial number assigned

2922

to <code>message</code>

2923

when sending it or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2923

when sending it or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2924

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

2925

</tr>

2926

<tr>

2927

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

2928

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

2928

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

2929

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

2930

</tr>

2931

<tr>

2932

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

2933

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request

2934

is satisfied or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

2934

is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't care about the result. </td>

2935

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

2936

</tr>

2937

<tr>

2952

g_dbus_connection_send_message_with_reply_finish

2953

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

2954

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

2955

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

2955

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

2956

Finishes an operation started with <a class="link" href="GDBusConnection.html#g-dbus-connection-send-message-with-reply" title="g_dbus_connection_send_message_with_reply ()"><code class="function">g_dbus_connection_send_message_with_reply()</code></a>.

2957

Note that <code>error</code>

2958

is only set if a local in-process error

2959

occurred. That is to say that the returned <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> object may

2960

be of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-ERROR:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_ERROR</code></a>. Use

2961

<a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()"><code class="function">g_dbus_message_to_gerror()</code></a> to transcode this to a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>.

2961

<a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()"><code class="function">g_dbus_message_to_gerror()</code></a> to transcode this to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>.

2962

See this <a class="link" href="GDBusConnection.html#gdbus-server" title="An example D-Bus server">server</a> and <a class="link" href="GDBusConnection.html#gdbus-unix-fd-client" title="An example for file descriptor passing">client</a>

2963

for an example of how to use this low-level API to send and receive

2964

UNIX file descriptors.

2984

</tr>

2985

<tr>

2986

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

2987

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

2987

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

2988

2989

</tr>

2990

</tbody>

2992

</div>

2993

2994

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

2995

a locked <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

2995

a locked <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> 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>

2996

is set.

2997

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2998

</div>

3006

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

3007

<code><a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> *message</code>,

3008

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

3009

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

3010

<code>volatile <a href="../glib/glib-Basic-Types.html#guint32">guint32</a> *out_serial</code>,

3009

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> timeout_msec</code>,

3010

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

3011

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

3012

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

3012

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

3013

Synchronously sends <code>message</code>

3014

to the peer represented by <code>connection</code>

3015

3023

and set on <code>message</code>

3024

via

3025

<a class="link" href="GDBusMessage.html#g-dbus-message-set-serial" title="g_dbus_message_set_serial ()"><code class="function">g_dbus_message_set_serial()</code></a>. If <code>out_serial</code>

3026

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

3026

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the

3027

serial number used will be written to this location prior to

3028

submitting the message to the underlying transport.

3029

If <code>connection</code>

3037

is only set if a local in-process error

3038

occurred. That is to say that the returned <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> object may

3039

be of type <a class="link" href="GDBusMessage.html#G-DBUS-MESSAGE-TYPE-ERROR:CAPS"><code class="literal">G_DBUS_MESSAGE_TYPE_ERROR</code></a>. Use

3040

<a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()"><code class="function">g_dbus_message_to_gerror()</code></a> to transcode this to a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>.

3040

<a class="link" href="GDBusMessage.html#g-dbus-message-to-gerror" title="g_dbus_message_to_gerror ()"><code class="function">g_dbus_message_to_gerror()</code></a> to transcode this to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>.

3041

See this <a class="link" href="GDBusConnection.html#gdbus-server" title="An example D-Bus server">server</a> and <a class="link" href="GDBusConnection.html#gdbus-unix-fd-client" title="An example for file descriptor passing">client</a>

3042

for an example of how to use this low-level API to send and receive

3043

UNIX file descriptors.

3072

<tr>

3073

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

3074

<td class="parameter_description">the timeout in milliseconds, -1 to use the default

3075

timeout or <a href="../glib/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

3075

timeout or <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a> for no timeout</td>

3076

3077

</tr>

3078

<tr>

3079

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

3080

<td class="parameter_description"> return location for serial number

3081

assigned to <code>message</code>

3082

when sending it or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

3082

when sending it or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

3083

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

3084

</tr>

3085

<tr>

3086

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

3087

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

3087

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

3088

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

3089

</tr>

3090

<tr>

3091

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

3092

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

3092

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

3093

3094

</tr>

3095

</tbody>

3099

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

3100

a locked <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> that is the reply

3101

to <code>message</code>

3102

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

3102

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>

3103

is set.

3104

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3105

</div>

3111

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

3112

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

3113

<code><a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> *message</code>,

3114

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> incoming</code>,

3115

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

3114

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> incoming</code>,

3115

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

3116

Signature for function used in <a class="link" href="GDBusConnection.html#g-dbus-connection-add-filter" title="g_dbus_connection_add_filter ()"><code class="function">g_dbus_connection_add_filter()</code></a>.

3117

A filter function is passed a <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> and expected to return

3118

a <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> too. Passive filter functions that don't modify the

3146

</div>

3147

3148

3149

Filter functions that wants to drop a message can simply return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>:

3149

Filter functions that wants to drop a message can simply return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>:

3150

3151

3152

<tbody>

3172

{

3173

if (should_drop_message)

3174

{

3175

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (message);

3175

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (message);

3176

message = NULL;

3177

}

3178

return message;

3218

error = NULL;

3219

copy = <a href="GDBusMessage.html#g-dbus-message-copy">g_dbus_message_copy</a> (message, &error);

3220

/* handle @error being is set */

3221

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (message);

3221

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a> (message);

3222

3223

/* modify @copy */

3224

3261

</tr>

3262

<tr>

3263

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

3264

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if it is a message received from the other peer, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is

3264

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if it is a message received from the other peer, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if it is

3265

a message to be sent to the other peer.</td>

3266

3267

</tr>

3276

3277

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

3278

A <a class="link" href="GDBusMessage.html" title="GDBusMessage">GDBusMessage</a> that will be freed with

3279

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to drop the message. Passive filter

3279

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to drop the message. Passive filter

3280

functions can simply return the passed <code>message</code>

3281

object.

3282

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

3286

<hr>

3287

3288

<a name="g-dbus-connection-add-filter"></a><h3>g_dbus_connection_add_filter ()</h3>

3289

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

3289

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

3290

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

3291

<code><a class="link" href="GDBusConnection.html#GDBusMessageFilterFunction" title="GDBusMessageFilterFunction ()">GDBusMessageFilterFunction</a> filter_function</code>,

3292

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

3293

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

3292

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

3293

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

3294

Adds a message filter. Filters are handlers that are run on all

3295

incoming and outgoing messages, prior to standard dispatch. Filters

3296

are run in the order that they were added. The same handler can be

3338

3339

<td class="parameter_description">function to free <code>user_data</code>

3340

with when filter

3341

is removed or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3341

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

3342

3343

</tr>

3344

</tbody>

3357

<a name="g-dbus-connection-remove-filter"></a><h3>g_dbus_connection_remove_filter ()</h3>

3358

<pre class="programlisting">void

3359

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

3360

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

3360

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

3361

Removes a filter.

3362

3363

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

3388

<a name="GDBusInterfaceMethodCallFunc"></a><h3>GDBusInterfaceMethodCallFunc ()</h3>

3389

<pre class="programlisting">void

3390

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

3391

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

3392

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

3393

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

3394

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

3395

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

3391

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

3392

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

3393

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

3394

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

3395

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameters</code>,

3396

<code><a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation">GDBusMethodInvocation</a> *invocation</code>,

3397

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

3397

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

3398

The type of the <code>method_call</code>

3399

function in <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a>.

3400

3433

</tr>

3434

<tr>

3435

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

3436

<td class="parameter_description">A <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters.</td>

3436

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuple with parameters.</td>

3437

3438

</tr>

3439

<tr>

3444

<tr>

3445

3446

3447

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3447

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3448

3449

</tr>

3450

</tbody>

3455

<hr>

3456

3457

<a name="GDBusInterfaceGetPropertyFunc"></a><h3>GDBusInterfaceGetPropertyFunc ()</h3>

3458

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

3458

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

3459

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

3460

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

3461

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

3462

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

3463

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

3464

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

3465

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

3460

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

3461

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

3462

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

3463

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

3464

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

3465

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

3466

The type of the <code>get_property</code>

3467

function in <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a>.

3468

3507

<tr>

3508

3509

3510

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3510

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3511

3512

</tr>

3513

</tbody>

3515

</div>

3516

3517

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

3518

A <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> with the value for <code>property_name</code>

3519

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

3518

A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> with the value for <code>property_name</code>

3519

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

3520

<code>error</code>

3521

is set. If the returned <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> is floating, it is

3521

is set. If the returned <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> is floating, it is

3522

consumed - otherwise its reference count is decreased by one.

3523

3524

</div>

3527

<hr>

3528

3529

<a name="GDBusInterfaceSetPropertyFunc"></a><h3>GDBusInterfaceSetPropertyFunc ()</h3>

3530

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3530

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

3531

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

3532

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

3533

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

3534

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

3535

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

3536

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *value</code>,

3537

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

3538

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

3532

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

3533

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

3534

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

3535

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

3536

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *value</code>,

3537

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

3538

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

3539

The type of the <code>set_property</code>

3540

function in <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a>.

3541

3585

<tr>

3586

3587

3588

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3588

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-object" title="g_dbus_connection_register_object ()"><code class="function">g_dbus_connection_register_object()</code></a>.</td>

3589

3590

</tr>

3591

</tbody>

3593

</div>

3594

3595

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

3596

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the property was set to <code>value</code>

3597

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

3596

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the property was set to <code>value</code>

3597

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

3598

is set.

3599

3600

</div>

3603

<hr>

3604

3605

<a name="g-dbus-connection-register-object"></a><h3>g_dbus_connection_register_object ()</h3>

3606

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

3606

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

3607

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

3608

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

3608

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

3609

<code><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a> *interface_info</code>,

3610

<code>const <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> *vtable</code>,

3611

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

3612

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>,

3613

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

3611

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

3612

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>,

3613

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

3614

Registers callbacks for exported objects at <code>object_path</code>

3615

with the

3616

D-Bus interface that is described in <code>interface_info</code>

3619

(and <code>user_data_free_func</code>

3620

) will happen

3621

in the

3622

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

3622

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

3623

of the thread you are calling this method from.

3624

Note that all <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> values passed to functions in <code>vtable</code>

3624

Note that all <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> values passed to functions in <code>vtable</code>

3625

will match

3626

the signature given in <code>interface_info</code>

3627

- if a remote caller passes

3636

It is considered a programming error if the

3637

<a class="link" href="GDBusConnection.html#GDBusInterfaceGetPropertyFunc" title="GDBusInterfaceGetPropertyFunc ()">GDBusInterfaceGetPropertyFunc</a> function in <code>vtable</code>

3638

returns a

3639

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> of incorrect type.

3639

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> of incorrect type.

3640

If an existing callback is already registered at <code>object_path</code>

3641

and

3642

<code>interface_name</code>

3680

</tr>

3681

<tr>

3682

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

3683

<td class="parameter_description"> a <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> to call into or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

3683

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

3684

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

3685

</tr>

3686

<tr>

3696

</tr>

3697

<tr>

3698

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

3699

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

3699

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

3700

3701

</tr>

3702

</tbody>

3714

<hr>

3715

3716

<a name="g-dbus-connection-unregister-object"></a><h3>g_dbus_connection_unregister_object ()</h3>

3717

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3717

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

3718

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

3719

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

3719

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

3720

Unregisters an object.

3721

3722

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

3743

</div>

3744

3745

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

3746

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the object was unregistered, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

3746

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the object was unregistered, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

3747

3748

</div>

3749

Since 2.26

3751

<hr>

3752

3753

<a name="GDBusSubtreeEnumerateFunc"></a><h3>GDBusSubtreeEnumerateFunc ()</h3>

3754

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar">gchar</a> **

3754

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **

3755

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

3756

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

3757

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

3758

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

3756

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

3757

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

3758

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

3759

The type of the <code>enumerate</code>

3760

function in <a class="link" href="GDBusConnection.html#GDBusSubtreeVTable" title="GDBusSubtreeVTable">GDBusSubtreeVTable</a>.

3761

This function is called when generating introspection data and also

3764

specified (ie: to verify that the object path is valid).

3765

Hierarchies are not supported; the items that you return should not

3766

contain the '/' character.

3767

The return value will be freed with <a href="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

3767

The return value will be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

3768

3769

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

3770

3792

<tr>

3793

3794

3795

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3795

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3796

3797

</tr>

3798

</tbody>

3811

<a name="GDBusSubtreeIntrospectFunc"></a><h3>GDBusSubtreeIntrospectFunc ()</h3>

3812

<pre class="programlisting"><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a> **

3813

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

3814

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

3815

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

3816

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

3817

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

3814

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

3815

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

3816

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

3817

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

3818

The type of the <code>introspect</code>

3819

function in <a class="link" href="GDBusConnection.html#GDBusSubtreeVTable" title="GDBusSubtreeVTable">GDBusSubtreeVTable</a>.

3820

Subtrees are flat. <code>node</code>

3821

, if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is always exactly one

3821

, if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is always exactly one

3822

segment of the object path (ie: it never contains a slash).

3823

This function should return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that there is no object

3823

This function should return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that there is no object

3824

at this node.

3825

If this function returns non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the return value is expected to

3826

be a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of pointers to <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a>

3825

If this function returns non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the return value is expected to

3826

be a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of pointers to <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a>

3827

structures describing the interfaces implemented by <code>node</code>

3828

. This

3829

array will have <a class="link" href="gio-D-Bus-Introspection-Data.html#g-dbus-interface-info-unref" title="g_dbus_interface_info_unref ()"><code class="function">g_dbus_interface_info_unref()</code></a> called on each item

3830

before being freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

3831

The difference between returning <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and an array containing zero

3830

before being freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

3831

The difference between returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and an array containing zero

3832

items is that the standard DBus interfaces will returned to the

3833

remote introspector in the empty array case, but not in the <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

3833

remote introspector in the empty array case, but not in the <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

3834

case.

3835

3836

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

3860

3861

<td class="parameter_description">A node that is a child of <code>object_path</code>

3862

(relative to <code>object_path</code>

3863

) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the root of the subtree.</td>

3863

) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the root of the subtree.</td>

3864

3865

</tr>

3866

<tr>

3867

3868

3869

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3869

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3870

3871

</tr>

3872

</tbody>

3874

</div>

3875

3876

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

3877

A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of pointers to <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

3877

A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of pointers to <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo">GDBusInterfaceInfo</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

3878

3879

</div>

3880

Since 2.26

3884

<a name="GDBusSubtreeDispatchFunc"></a><h3>GDBusSubtreeDispatchFunc ()</h3>

3885

<pre class="programlisting">const <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> *

3886

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

3887

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

3888

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

3889

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

3890

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

3891

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> *out_user_data</code>,

3892

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

3887

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

3888

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

3889

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

3890

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

3891

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

3892

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

3893

The type of the <code>dispatch</code>

3894

function in <a class="link" href="GDBusConnection.html#GDBusSubtreeVTable" title="GDBusSubtreeVTable">GDBusSubtreeVTable</a>.

3895

Subtrees are flat. <code>node</code>

3896

, if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is always exactly one

3896

, if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, is always exactly one

3897

segment of the object path (ie: it never contains a slash).

3898

3899

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

3928

3929

<td class="parameter_description">A node that is a child of <code>object_path</code>

3930

(relative to <code>object_path</code>

3931

) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the root of the subtree.</td>

3931

) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the root of the subtree.</td>

3932

3933

</tr>

3934

<tr>

3935

3936

<td class="parameter_description">Return location for user data to pass to functions in the returned <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> (never <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>

3936

<td class="parameter_description">Return location for user data to pass to functions in the returned <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> (never <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>

3937

3938

</tr>

3939

<tr>

3940

3941

3942

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3942

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> passed to <a class="link" href="GDBusConnection.html#g-dbus-connection-register-subtree" title="g_dbus_connection_register_subtree ()"><code class="function">g_dbus_connection_register_subtree()</code></a>.</td>

3943

3944

</tr>

3945

</tbody>

3947

</div>

3948

3949

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

3950

A <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't want to handle the methods.

3950

A <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you don't want to handle the methods.

3951

3952

</div>

3953

Since 2.26

3955

<hr>

3956

3957

<a name="g-dbus-connection-register-subtree"></a><h3>g_dbus_connection_register_subtree ()</h3>

3958

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

3958

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

3959

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

3960

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

3960

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

3961

<code>const <a class="link" href="GDBusConnection.html#GDBusSubtreeVTable" title="GDBusSubtreeVTable">GDBusSubtreeVTable</a> *vtable</code>,

3962

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

3963

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

3964

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>,

3965

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

3963

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

3964

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>,

3965

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

3966

Registers a whole subtree of dynamic objects.

3967

The <code>enumerate</code>

3968

and <code>introspection</code>

3980

requested method. If so, the <code>dispatch</code>

3981

function is used to determine

3982

where to dispatch the call. The collected <a class="link" href="GDBusConnection.html#GDBusInterfaceVTable" title="GDBusInterfaceVTable">GDBusInterfaceVTable</a> and

3983

<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> will be used to call into the interface vtable for processing

3983

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> will be used to call into the interface vtable for processing

3984

the request.

3985

All calls into user-provided code will be invoked in the

3986

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

3986

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

3987

of the thread you are calling this method from.

3988

If an existing subtree is already registered at <code>object_path</code>

3989

or

4043

</tr>

4044

<tr>

4045

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

4046

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

4046

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

4047

4048

</tr>

4049

</tbody>

4061

<hr>

4062

4063

<a name="g-dbus-connection-unregister-subtree"></a><h3>g_dbus_connection_unregister_subtree ()</h3>

4064

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4064

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4065

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

4066

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

4066

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

4067

Unregisters a subtree.

4068

4069

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

4090

</div>

4091

4092

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

4093

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the subtree was unregistered, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

4093

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the subtree was unregistered, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise

4094

4095

</div>

4096

Since 2.26

4379

Virtual table for handling properties and method calls for a D-Bus

4380

interface.

4381

Since 2.38, if you want to handle getting/setting D-Bus properties

4382

asynchronously, give <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as your <code class="function">get_property()</code> or <code class="function">set_property()</code>

4382

asynchronously, give <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as your <code class="function">get_property()</code> or <code class="function">set_property()</code>

4383

function. The D-Bus call will be directed to your <code>method_call</code>

4384

function,

4385

with the provided <code>interface_name</code>

4395

<a class="link" href="GDBusMethodInvocation.html#g-dbus-method-invocation-get-property-info" title="g_dbus_method_invocation_get_property_info ()"><code class="function">g_dbus_method_invocation_get_property_info()</code></a> to get a pointer

4396

to the <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusPropertyInfo">GDBusPropertyInfo</a> of the property.

4397

If you have readable properties specified in your interface info,

4398

you must ensure that you either provide a non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code><code class="function">get_property()</code></code>

4398

you must ensure that you either provide a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code><code class="function">get_property()</code></code>

4399

4400

function or provide implementations of both the <code class="literal">Get</code> and <code class="literal">GetAll</code>

4401

methods on org.freedesktop.DBus.Properties interface in your <code>method_call</code>

4404

<code class="literal">(v)</code>, not the type of the property. <code class="literal">GetAll</code> expects a return value

4405

of type <code class="literal">a{sv}</code>.

4406

If you have writable properties specified in your interface info,

4407

you must ensure that you either provide a non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code><code class="function">set_property()</code></code>

4407

you must ensure that you either provide a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code><code class="function">set_property()</code></code>

4408

4409

function or provide an implementation of the <code class="literal">Set</code> call. If implementing

4410

the call, you must return the value of type <a href="../glib/glib-GVariantType.html#G-VARIANT-TYPE-UNIT:CAPS"><code class="literal">G_VARIANT_TYPE_UNIT</code></a>.

4410

the call, you must return the value of type <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#G-VARIANT-TYPE-UNIT:CAPS"><code class="literal">G_VARIANT_TYPE_UNIT</code></a>.

4411

4412

<a name="id-1.4.17.7.12.9.10"></a><h4>Members</h4>

4413

4515

<a name="GDBusConnection.property-details"></a><h2>Property Details</h2>

4516

4517

<a name="GDBusConnection--address"></a><h3>The <code class="literal">“address”</code> property</h3>

4518

<pre class="programlisting"> “address” <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4518

<pre class="programlisting"> “address” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4519

A D-Bus address specifying potential endpoints that can be used

4520

when establishing the connection.

4521

Flags: Write / Construct Only

4526

4527

<a name="GDBusConnection--authentication-observer"></a><h3>The <code class="literal">“authentication-observer”</code> property</h3>

4528

<pre class="programlisting"> “authentication-observer” <a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> *</pre>

4529

A <a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> object to assist in the authentication process or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

4529

A <a class="link" href="GDBusAuthObserver.html" title="GDBusAuthObserver">GDBusAuthObserver</a> object to assist in the authentication process or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

4530

Flags: Write / Construct Only

4531

Since 2.26

4532

</div>

4542

<hr>

4543

4544

<a name="GDBusConnection--closed"></a><h3>The <code class="literal">“closed”</code> property</h3>

4545

<pre class="programlisting"> “closed” <a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></pre>

4545

<pre class="programlisting"> “closed” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a></pre>

4546

A boolean specifying whether the connection has been closed.

4547

Flags: Read

4548

Default value: FALSE

4551

<hr>

4552

4553

<a name="GDBusConnection--exit-on-close"></a><h3>The <code class="literal">“exit-on-close”</code> property</h3>

4554

<pre class="programlisting"> “exit-on-close” <a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></pre>

4554

<pre class="programlisting"> “exit-on-close” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a></pre>

4555

A boolean specifying whether the process will be terminated (by

4556

calling <code class="literal">raise(SIGTERM)</code>) if the connection is closed by the

4557

remote peer.

4558

Note that <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> objects returned by <a class="link" href="GDBusConnection.html#g-bus-get-finish" title="g_bus_get_finish ()"><code class="function">g_bus_get_finish()</code></a>

4559

and <a class="link" href="GDBusConnection.html#g-bus-get-sync" title="g_bus_get_sync ()"><code class="function">g_bus_get_sync()</code></a> will (usually) have this property set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

4559

and <a class="link" href="GDBusConnection.html#g-bus-get-sync" title="g_bus_get_sync ()"><code class="function">g_bus_get_sync()</code></a> will (usually) have this property set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

4560

Flags: Read / Write

4561

Default value: FALSE

4562

Since 2.26

4572

<hr>

4573

4574

<a name="GDBusConnection--guid"></a><h3>The <code class="literal">“guid”</code> property</h3>

4575

<pre class="programlisting"> “guid” <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4575

<pre class="programlisting"> “guid” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4576

The GUID of the peer performing the role of server when

4577

authenticating.

4578

If you are constructing a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> and pass

4604

<hr>

4605

4606

<a name="GDBusConnection--unique-name"></a><h3>The <code class="literal">“unique-name”</code> property</h3>

4607

<pre class="programlisting"> “unique-name” <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4608

The unique name as assigned by the message bus or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the

4607

<pre class="programlisting"> “unique-name” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *</pre>

4608

The unique name as assigned by the message bus or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the

4609

connection is not open or not a message bus connection.

4610

Flags: Read

4611

Default value: NULL

4618

<a name="GDBusConnection-closed"></a><h3>The <code class="literal">“closed”</code> signal</h3>

4619

<pre class="programlisting">void

4620

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

4621

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> remote_peer_vanished,

4622

<a href="../glib/glib-Error-Reporting.html#GError">GError</a> *error,

4623

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

4621

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> remote_peer_vanished,

4622

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

4623

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

4624

Emitted when the connection is closed.

4625

The cause of this event can be

4626

4627

<li class="listitem">If <a class="link" href="GDBusConnection.html#g-dbus-connection-close" title="g_dbus_connection_close ()"><code class="function">g_dbus_connection_close()</code></a> is called. In this case

4628

<code>remote_peer_vanished</code>

4629

is set to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

4630

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</li>

4629

is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

4630

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</li>

4631

<li class="listitem">If the remote peer closes the connection. In this case

4632

<code>remote_peer_vanished</code>

4633

is set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and <code>error</code>

4633

is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and <code>error</code>

4634

is set.</li>

4635

<li class="listitem">If the remote peer sends invalid or malformed data. In this

4636

case <code>remote_peer_vanished</code>

4637

is set to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

4637

is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

4638

is set.</li>

4639

</ul></div>

4640

Upon receiving this signal, you should give up your reference to

4657

</tr>

4658

<tr>

4659

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

4660

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>connection</code>

4660

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>connection</code>

4661

is closed because the

4662

remote peer closed its end of the connection</td>

4663

4664

</tr>

4665

<tr>

4666

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

4667

<td class="parameter_description"> a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> with more details about the event or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

4667

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> with more details about the event or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

4668

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

4669

</tr>

4670

<tr>

4675

</tbody>

4676

</table></div>

4677

</div>

4678

Flags: Run Last

4678

Flags: <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a>

4679

Since 2.26

4680

</div>

4681

</div>