~ubuntu-branches/debian/jessie/glib2.0/jessie

<a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name-on-connection" title="g_bus_own_name_on_connection ()">g_bus_own_name_on_connection</a> ()

</tr>

<tr>

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

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

</td>

<a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name-with-closures" title="g_bus_own_name_with_closures ()">g_bus_own_name_with_closures</a> ()

</tr>

<tr>

100

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

100

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

101

</td>

102

103

<a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name-on-connection-with-closures" title="g_bus_own_name_on_connection_with_closures ()">g_bus_own_name_on_connection_with_closures</a> ()

136

<a name="GBusAcquiredCallback"></a><h3>GBusAcquiredCallback ()</h3>

137

<pre class="programlisting">void

138

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

139

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

140

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

139

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

140

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

141

Invoked when a connection to a message bus has been obtained.

142

143

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

173

<a name="GBusNameAcquiredCallback"></a><h3>GBusNameAcquiredCallback ()</h3>

174

<pre class="programlisting">void

175

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

176

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

177

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

176

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

177

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

178

Invoked when the name is acquired.

179

180

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

210

<a name="GBusNameLostCallback"></a><h3>GBusNameLostCallback ()</h3>

211

<pre class="programlisting">void

212

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

213

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

214

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

213

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

214

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

215

Invoked when the name is lost or <code>connection</code>

216

has been closed.

217

225

<tbody>

226

<tr>

227

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

228

<td class="parameter_description">The <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> on which to acquire the name or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

228

<td class="parameter_description">The <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> on which to acquire the name or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

229

the connection was disconnected.</td>

230

231

</tr>

247

<hr>

248

249

250

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

250

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

251

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

252

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

252

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

253

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameOwnerFlags" title="enum GBusNameOwnerFlags">GBusNameOwnerFlags</a> flags</code>,

254

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusAcquiredCallback" title="GBusAcquiredCallback ()">GBusAcquiredCallback</a> bus_acquired_handler</code>,

255

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameAcquiredCallback" title="GBusNameAcquiredCallback ()">GBusNameAcquiredCallback</a> name_acquired_handler</code>,

256

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameLostCallback" title="GBusNameLostCallback ()">GBusNameLostCallback</a> name_lost_handler</code>,

257

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

258

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

257

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

258

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

259

Starts acquiring <code>name</code>

260

on the bus specified by <code>bus_type</code>

261

and calls

263

and <code>name_lost_handler</code>

264

when the name is

265

acquired respectively lost. Callbacks will be invoked in the

266

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

266

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

267

of the thread you are calling this function from.

268

You are guaranteed that one of the <code>name_acquired_handler</code>

269

and <code>name_lost_handler</code>

272

possible cases:

273

274

<li class="listitem"><code>name_lost_handler</code>

275

with a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> connection (if a connection to the bus

275

with a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> connection (if a connection to the bus

276

can't be made).</li>

277

<li class="listitem"><code>bus_acquired_handler</code>

278

then <code>name_lost_handler</code>

345

<tr>

346

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

347

<td class="parameter_description"> handler to invoke when connected to the bus of type <code>bus_type</code>

348

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

348

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

349

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

350

</tr>

351

<tr>

352

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

353

<td class="parameter_description"> handler to invoke when <code>name</code>

354

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

354

is acquired or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

355

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

356

</tr>

357

<tr>

358

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

359

<td class="parameter_description"> handler to invoke when <code>name</code>

360

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

360

is lost or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

361

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

362

</tr>

363

<tr>

368

<tr>

369

370

<td class="parameter_description"> function for freeing <code>user_data</code>

371

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

371

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

372

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

373

</tr>

374

</tbody>

385

<hr>

386

387

<a name="g-bus-own-name-on-connection"></a><h3>g_bus_own_name_on_connection ()</h3>

388

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

388

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

389

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

390

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

390

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

391

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameOwnerFlags" title="enum GBusNameOwnerFlags">GBusNameOwnerFlags</a> flags</code>,

392

393

394

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

395

394

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

395

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_free_func</code>);</pre>

396

Like <a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name" title="g_bus_own_name ()"><code class="function">g_bus_own_name()</code></a> but takes a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> instead of a

397

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

398

422

<tr>

423

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

424

<td class="parameter_description"> handler to invoke when <code>name</code>

425

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

425

is acquired or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

426

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

427

</tr>

428

<tr>

429

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

430

<td class="parameter_description"> handler to invoke when <code>name</code>

431

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

431

is lost or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

432

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

433

</tr>

434

<tr>

439

<tr>

440

441

<td class="parameter_description"> function for freeing <code>user_data</code>

442

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

442

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

443

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

444

</tr>

445

</tbody>

457

458

<a name="g-bus-unown-name"></a><h3>g_bus_unown_name ()</h3>

459

<pre class="programlisting">void

460

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

460

g_bus_unown_name (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> owner_id</code>);</pre>

461

Stops owning a name.

462

463

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

479

<hr>

480

481

<a name="g-bus-own-name-with-closures"></a><h3>g_bus_own_name_with_closures ()</h3>

482

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

482

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

483

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

484

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

484

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

485

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameOwnerFlags" title="enum GBusNameOwnerFlags">GBusNameOwnerFlags</a> flags</code>,

486

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> *bus_acquired_closure</code>,

487

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> *name_acquired_closure</code>,

488

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> *name_lost_closure</code>);</pre>

486

<code><a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> *bus_acquired_closure</code>,

487

<code><a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> *name_acquired_closure</code>,

488

<code><a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> *name_lost_closure</code>);</pre>

489

Version of <a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name" title="g_bus_own_name ()"><code class="function">g_bus_own_name()</code></a> using closures instead of callbacks for

490

easier binding in other languages.

491

514

</tr>

515

<tr>

516

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

517

<td class="parameter_description"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> to invoke when connected to

517

<td class="parameter_description"> <a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> to invoke when connected to

518

the bus of type <code>bus_type</code>

519

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

519

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

520

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

521

</tr>

522

<tr>

523

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

524

<td class="parameter_description"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> to invoke when <code>name</code>

524

<td class="parameter_description"> <a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> to invoke when <code>name</code>

525

526

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

526

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

527

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

528

</tr>

529

<tr>

530

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

531

<td class="parameter_description"> <a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> to invoke when <code>name</code>

532

is lost or

533

533

534

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

535

</tr>

536

</tbody>

548

<hr>

549

550

<a name="g-bus-own-name-on-connection-with-closures"></a><h3>g_bus_own_name_on_connection_with_closures ()</h3>

551

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

551

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

552

g_bus_own_name_on_connection_with_closures

553

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

554

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

554

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

555

<code><a class="link" href="gio-Owning-Bus-Names.html#GBusNameOwnerFlags" title="enum GBusNameOwnerFlags">GBusNameOwnerFlags</a> flags</code>,

556

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> *name_acquired_closure</code>,

557

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure">GClosure</a> *name_lost_closure</code>);</pre>

556

<code><a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> *name_acquired_closure</code>,

557

<code><a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> *name_lost_closure</code>);</pre>

558

Version of <a class="link" href="gio-Owning-Bus-Names.html#g-bus-own-name-on-connection" title="g_bus_own_name_on_connection ()"><code class="function">g_bus_own_name_on_connection()</code></a> using closures instead of

559

callbacks for easier binding in other languages.

560

583

</tr>

584

<tr>

585

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

586

<td class="parameter_description"> <a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> to invoke when <code>name</code>

587

588

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

588

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

589

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

590

</tr>

591

<tr>

592

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

593

<td class="parameter_description"> <a href="../gobject/gobject-Closures.html#GClosure">GClosure</a> to invoke when <code>name</code>

594

is lost

595

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

595

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

596

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

597

</tr>

598

</tbody>

Older »