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

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

</tr>

<tr>

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

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

</td>

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

</tr>

<tr>

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

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

</td>

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

128

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

129

<pre class="programlisting">void

130

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

131

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

132

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

133

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

131

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

132

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

133

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

134

Invoked when the name being watched is known to have to have a owner.

135

136

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

171

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

172

<pre class="programlisting">void

173

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

174

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

175

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

174

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

175

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

176

Invoked when the name being watched is known not to have to have a owner.

177

This is also invoked when the GDBusConection on which the watch was

178

established has been closed. In that case, <code>connection</code>

179

will be

180

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

180

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

181

182

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

183

190

<tr>

191

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

192

<td class="parameter_description">The <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> the name is being watched on, or

193

193

194

195

</tr>

196

<tr>

211

<hr>

212

213

<a name="g-bus-watch-name"></a><h3>g_bus_watch_name ()</h3>

214

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

214

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

215

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

216

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

216

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

217

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

218

<code><a class="link" href="gio-Watching-Bus-Names.html#GBusNameAppearedCallback" title="GBusNameAppearedCallback ()">GBusNameAppearedCallback</a> name_appeared_handler</code>,

219

<code><a class="link" href="gio-Watching-Bus-Names.html#GBusNameVanishedCallback" title="GBusNameVanishedCallback ()">GBusNameVanishedCallback</a> name_vanished_handler</code>,

220

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

221

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

220

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

221

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

222

Starts watching <code>name</code>

223

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

224

and calls

227

when the name is

228

known to have a owner respectively known to lose its

229

owner. Callbacks will be invoked in the

230

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

230

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

231

of the thread you are calling this function from.

232

You are guaranteed that one of the handlers will be invoked after

233

calling this function. When you are done watching the name, just

282

<tr>

283

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

284

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

285

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

285

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

286

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

287

</tr>

288

<tr>

289

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

290

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

291

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

291

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

292

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

293

</tr>

294

<tr>

299

<tr>

300

301

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

302

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

302

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

303

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

304

</tr>

305

</tbody>

316

<hr>

317

318

<a name="g-bus-watch-name-on-connection"></a><h3>g_bus_watch_name_on_connection ()</h3>

319

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

319

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

320

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

321

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

321

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

322

323

324

325

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

326

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

325

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

326

327

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

328

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

329

353

<tr>

354

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

355

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

356

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

356

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

357

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

358

</tr>

359

<tr>

360

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

361

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

362

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

362

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

363

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

364

</tr>

365

<tr>

370

<tr>

371

372

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

373

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

373

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

374

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

375

</tr>

376

</tbody>

388

389

<a name="g-bus-unwatch-name"></a><h3>g_bus_unwatch_name ()</h3>

390

<pre class="programlisting">void

391

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

391

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

392

Stops watching a name.

393

394

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

410

<hr>

411

412

<a name="g-bus-watch-name-with-closures"></a><h3>g_bus_watch_name_with_closures ()</h3>

413

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

413

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

414

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

415

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

415

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

416

417

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

418

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

417

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

418

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

419

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

420

easier binding in other languages.

421

444

</tr>

445

<tr>

446

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

447

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

447

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

448

is known

449

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

449

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

450

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

451

</tr>

452

<tr>

453

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

454

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

454

455

is known

456

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

456

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

457

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

458

</tr>

459

</tbody>

471

<hr>

472

473

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

474

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

474

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

475

g_bus_watch_name_on_connection_with_closures

476

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

477

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

477

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

478

479

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

480

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

479

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

480

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

481

Version of <a class="link" href="gio-Watching-Bus-Names.html#g-bus-watch-name-on-connection" title="g_bus_watch_name_on_connection ()"><code class="function">g_bus_watch_name_on_connection()</code></a> using closures instead of callbacks for

482

easier binding in other languages.

483

506

</tr>

507

<tr>

508

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

509

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

509

510

is known

511

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

511

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

512

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

513

</tr>

514

<tr>

515

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

516

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

516

517

is known

518

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

518

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

519

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

520

</tr>

521

</tbody>

Older »