~ubuntu-branches/debian/jessie/glib2.0/jessie : revision 120

59

</tr>

60

<tr>

61

62

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

62

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

63

</td>

64

65

<a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()">g_resolver_lookup_by_name</a> ()

75

</tr>

76

<tr>

77

78

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

78

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

79

</td>

80

81

<a class="link" href="GResolver.html#g-resolver-lookup-by-name-finish" title="g_resolver_lookup_by_name_finish ()">g_resolver_lookup_by_name_finish</a> ()

91

</tr>

92

<tr>

93

94

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

94

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

95

</td>

96

97

<a class="link" href="GResolver.html#g-resolver-lookup-by-address" title="g_resolver_lookup_by_address ()">g_resolver_lookup_by_address</a> ()

107

</tr>

108

<tr>

109

110

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

110

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

111

</td>

112

113

<a class="link" href="GResolver.html#g-resolver-lookup-by-address-finish" title="g_resolver_lookup_by_address_finish ()">g_resolver_lookup_by_address_finish</a> ()

115

</tr>

116

<tr>

117

118

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

118

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

119

</td>

120

121

<a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()">g_resolver_lookup_service</a> ()

131

</tr>

132

<tr>

133

134

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

134

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

135

</td>

136

137

<a class="link" href="GResolver.html#g-resolver-lookup-service-finish" title="g_resolver_lookup_service_finish ()">g_resolver_lookup_service_finish</a> ()

147

</tr>

148

<tr>

149

150

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

150

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

151

</td>

152

153

<a class="link" href="GResolver.html#g-resolver-lookup-records" title="g_resolver_lookup_records ()">g_resolver_lookup_records</a> ()

163

</tr>

164

<tr>

165

166

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

166

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

167

</td>

168

169

<a class="link" href="GResolver.html#g-resolver-lookup-records-finish" title="g_resolver_lookup_records_finish ()">g_resolver_lookup_records_finish</a> ()

212

</div>

213

214

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

215

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

215

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

216

╰── GResolver

217

</pre>

218

</div>

282

<hr>

283

284

<a name="g-resolver-lookup-by-name"></a><h3>g_resolver_lookup_by_name ()</h3>

285

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

285

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

286

g_resolver_lookup_by_name (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

287

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

287

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

288

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

289

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

289

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

290

Synchronously resolves <code>hostname</code>

291

to determine its associated IP

292

address(es). <code>hostname</code>

293

may be an ASCII-only or UTF-8 hostname, or

294

the textual form of an IP address (in which case this just becomes

295

a wrapper around <a class="link" href="GInetAddress.html#g-inet-address-new-from-string" title="g_inet_address_new_from_string ()"><code class="function">g_inet_address_new_from_string()</code></a>).

296

On success, <a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()"><code class="function">g_resolver_lookup_by_name()</code></a> will return a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

296

On success, <a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()"><code class="function">g_resolver_lookup_by_name()</code></a> will return a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

297

<a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a>, sorted in order of preference and guaranteed to not

298

contain duplicates. That is, if using the result to connect to

299

<code>hostname</code>

302

the result to listen on a socket, it is appropriate to add each

303

result using e.g. <a class="link" href="GSocketListener.html#g-socket-listener-add-address" title="g_socket_listener_add_address ()"><code class="function">g_socket_listener_add_address()</code></a>.

304

If the DNS resolution fails, <code>error</code>

305

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to a

306

value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

305

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to a

306

value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

307

If <code>cancellable</code>

308

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

308

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it can be used to cancel the

309

operation, in which case <code>error</code>

310

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

310

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

311

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

312

If you are planning to connect to a socket on the resolved IP

313

address, it may be easier to create a <a class="link" href="GNetworkAddress.html" title="GNetworkAddress">GNetworkAddress</a> and use its

333

</tr>

334

<tr>

335

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

336

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

336

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

337

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

338

</tr>

339

<tr>

340

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

341

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

341

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

342

343

</tr>

344

</tbody>

346

</div>

347

348

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

349

a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a>

350

of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You

349

a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a>

350

of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You

351

must unref each of the addresses and free the list when you are

352

done with it. (You can use <a class="link" href="GResolver.html#g-resolver-free-addresses" title="g_resolver_free_addresses ()"><code class="function">g_resolver_free_addresses()</code></a> to do this.).

353

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GInetAddress][<acronym title="Free data after the code is done.">transfer full</acronym>]

359

<a name="g-resolver-lookup-by-name-async"></a><h3>g_resolver_lookup_by_name_async ()</h3>

360

<pre class="programlisting">void

361

g_resolver_lookup_by_name_async (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

362

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

362

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

363

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

364

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

365

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

365

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

366

Begins asynchronously resolving <code>hostname</code>

367

to determine its

368

associated IP address(es), and eventually calls <code>callback</code>

390

</tr>

391

<tr>

392

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

393

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

393

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

394

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

395

</tr>

396

<tr>

412

<hr>

413

414

<a name="g-resolver-lookup-by-name-finish"></a><h3>g_resolver_lookup_by_name_finish ()</h3>

415

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

415

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

416

g_resolver_lookup_by_name_finish (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

417

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

418

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

418

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

419

Retrieves the result of a call to

420

<a class="link" href="GResolver.html#g-resolver-lookup-by-name-async" title="g_resolver_lookup_by_name_async ()"><code class="function">g_resolver_lookup_by_name_async()</code></a>.

421

If the DNS resolution failed, <code>error</code>

422

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

422

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

423

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a>. If the operation was cancelled,

424

<code>error</code>

425

will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a>.

444

</tr>

445

<tr>

446

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

447

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

447

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

448

449

</tr>

450

</tbody>

452

</div>

453

454

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

455

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a>

456

of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. See <a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()"><code class="function">g_resolver_lookup_by_name()</code></a>

455

a <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a>

456

of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. See <a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()"><code class="function">g_resolver_lookup_by_name()</code></a>

457

for more details.

458

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GInetAddress][<acronym title="Free data after the code is done.">transfer full</acronym>]

459

</div>

463

464

<a name="g-resolver-free-addresses"></a><h3>g_resolver_free_addresses ()</h3>

465

<pre class="programlisting">void

466

g_resolver_free_addresses (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *addresses</code>);</pre>

466

g_resolver_free_addresses (<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *addresses</code>);</pre>

467

Frees <code>addresses</code>

468

(which should be the return value from

469

<a class="link" href="GResolver.html#g-resolver-lookup-by-name" title="g_resolver_lookup_by_name ()"><code class="function">g_resolver_lookup_by_name()</code></a> or <a class="link" href="GResolver.html#g-resolver-lookup-by-name-finish" title="g_resolver_lookup_by_name_finish ()"><code class="function">g_resolver_lookup_by_name_finish()</code></a>).

479

</colgroup>

480

481

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

482

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a></td>

482

<td class="parameter_description">a <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of <a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a></td>

483

484

</tr></tbody>

485

</table></div>

489

<hr>

490

491

<a name="g-resolver-lookup-by-address"></a><h3>g_resolver_lookup_by_address ()</h3>

492

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

492

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

493

g_resolver_lookup_by_address (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

494

<code><a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a> *address</code>,

495

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

496

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

496

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

497

Synchronously reverse-resolves <code>address</code>

498

to determine its

499

associated hostname.

500

If the DNS resolution fails, <code>error</code>

501

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

501

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

502

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a>.

503

If <code>cancellable</code>

504

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

504

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it can be used to cancel the

505

operation, in which case <code>error</code>

506

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

506

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

507

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

508

509

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

526

</tr>

527

<tr>

528

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

529

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

529

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

530

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

531

</tr>

532

<tr>

533

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

534

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

534

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

535

536

</tr>

537

</tbody>

540

541

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

542

a hostname (either ASCII-only, or in ASCII-encoded

543

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

543

form), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

544

545

</div>

546

Since 2.22

553

<code><a class="link" href="GInetAddress.html" title="GInetAddress">GInetAddress</a> *address</code>,

554

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

555

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

556

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

556

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

557

Begins asynchronously reverse-resolving <code>address</code>

558

to determine its

559

associated hostname, and eventually calls <code>callback</code>

580

</tr>

581

<tr>

582

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

583

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

583

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

584

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

585

</tr>

586

<tr>

602

<hr>

603

604

<a name="g-resolver-lookup-by-address-finish"></a><h3>g_resolver_lookup_by_address_finish ()</h3>

605

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

605

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

606

g_resolver_lookup_by_address_finish (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

607

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

608

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

608

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

609

Retrieves the result of a previous call to

610

<a class="link" href="GResolver.html#g-resolver-lookup-by-address-async" title="g_resolver_lookup_by_address_async ()"><code class="function">g_resolver_lookup_by_address_async()</code></a>.

611

If the DNS resolution failed, <code>error</code>

612

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

612

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

613

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a>. If the operation was cancelled,

614

<code>error</code>

615

will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a>.

634

</tr>

635

<tr>

636

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

637

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

637

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

638

639

</tr>

640

</tbody>

643

644

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

645

a hostname (either ASCII-only, or in ASCII-encoded

646

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

646

form), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

647

648

</div>

649

Since 2.22

651

<hr>

652

653

<a name="g-resolver-lookup-service"></a><h3>g_resolver_lookup_service ()</h3>

654

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

654

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

655

g_resolver_lookup_service (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

656

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

657

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

658

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

656

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

657

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

658

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

659

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

660

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

660

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

661

Synchronously performs a DNS SRV lookup for the given <code>service</code>

662

and

663

<code>protocol</code>

669

and <code>protocol</code>

670

arguments do not include the leading underscore

671

that appears in the actual DNS entry.

672

On success, <a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()"><code class="function">g_resolver_lookup_service()</code></a> will return a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

672

On success, <a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()"><code class="function">g_resolver_lookup_service()</code></a> will return a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

673

<a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>, sorted in order of preference. (That is, you should

674

attempt to connect to the first target first, then the second if

675

the first fails, etc.)

676

If the DNS resolution fails, <code>error</code>

677

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

678

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

677

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

678

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

679

If <code>cancellable</code>

680

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

680

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it can be used to cancel the

681

operation, in which case <code>error</code>

682

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

682

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

683

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

684

If you are planning to connect to the service, it is usually easier

685

to create a <a class="link" href="GNetworkService.html" title="GNetworkService">GNetworkService</a> and use its <a class="link" href="GSocketConnectable.html" title="GSocketConnectable">GSocketConnectable</a>

716

</tr>

717

<tr>

718

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

719

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

719

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

720

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

721

</tr>

722

<tr>

723

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

724

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

724

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

725

726

</tr>

727

</tbody>

729

</div>

730

731

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

732

a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

733

<a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the targets and the

732

a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

733

<a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the targets and the

734

list when you are done with it. (You can use <a class="link" href="GResolver.html#g-resolver-free-targets" title="g_resolver_free_targets ()"><code class="function">g_resolver_free_targets()</code></a> to do

735

this.).

736

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GSrvTarget][<acronym title="Free data after the code is done.">transfer full</acronym>]

742

<a name="g-resolver-lookup-service-async"></a><h3>g_resolver_lookup_service_async ()</h3>

743

<pre class="programlisting">void

744

g_resolver_lookup_service_async (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

745

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

746

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

747

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

745

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

746

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

747

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

748

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

749

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

750

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

750

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

751

Begins asynchronously performing a DNS SRV lookup for the given

752

<code>service</code>

753

and <code>protocol</code>

789

</tr>

790

<tr>

791

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

792

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

792

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

793

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

794

</tr>

795

<tr>

811

<hr>

812

813

<a name="g-resolver-lookup-service-finish"></a><h3>g_resolver_lookup_service_finish ()</h3>

814

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

814

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

815

g_resolver_lookup_service_finish (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

816

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

817

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

817

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

818

Retrieves the result of a previous call to

819

<a class="link" href="GResolver.html#g-resolver-lookup-service-async" title="g_resolver_lookup_service_async ()"><code class="function">g_resolver_lookup_service_async()</code></a>.

820

If the DNS resolution failed, <code>error</code>

821

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

821

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

822

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a>. If the operation was cancelled,

823

<code>error</code>

824

will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a>.

843

</tr>

844

<tr>

845

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

846

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

846

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

847

848

</tr>

849

</tbody>

851

</div>

852

853

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

854

a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

855

<a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. See <a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()"><code class="function">g_resolver_lookup_service()</code></a> for more

854

a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

855

<a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. See <a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()"><code class="function">g_resolver_lookup_service()</code></a> for more

856

details.

857

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GSrvTarget][<acronym title="Free data after the code is done.">transfer full</acronym>]

858

</div>

862

863

<a name="g-resolver-free-targets"></a><h3>g_resolver_free_targets ()</h3>

864

<pre class="programlisting">void

865

g_resolver_free_targets (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *targets</code>);</pre>

865

g_resolver_free_targets (<code><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *targets</code>);</pre>

866

Frees <code>targets</code>

867

(which should be the return value from

868

<a class="link" href="GResolver.html#g-resolver-lookup-service" title="g_resolver_lookup_service ()"><code class="function">g_resolver_lookup_service()</code></a> or <a class="link" href="GResolver.html#g-resolver-lookup-service-finish" title="g_resolver_lookup_service_finish ()"><code class="function">g_resolver_lookup_service_finish()</code></a>).

878

</colgroup>

879

880

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

881

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of <a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a></td>

881

<td class="parameter_description">a <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of <a class="link" href="GSrvTarget.html" title="GSrvTarget">GSrvTarget</a></td>

882

883

</tr></tbody>

884

</table></div>

888

<hr>

889

890

<a name="g-resolver-lookup-records"></a><h3>g_resolver_lookup_records ()</h3>

891

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

891

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

892

g_resolver_lookup_records (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

893

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

893

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

894

<code>GResolverRecordType record_type</code>,

895

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

896

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

896

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

897

Synchronously performs a DNS record lookup for the given <code>rrname</code>

898

and returns

899

a list of records as <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuples. See GResolverRecordType for

899

a list of records as <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuples. See GResolverRecordType for

900

information on what the records contain for each <code>record_type</code>

901

.

902

If the DNS resolution fails, <code>error</code>

903

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

904

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

903

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

904

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> and <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

905

If <code>cancellable</code>

906

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

906

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it can be used to cancel the

907

operation, in which case <code>error</code>

908

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

908

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

909

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

910

911

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

933

</tr>

934

<tr>

935

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

936

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

936

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

937

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

938

</tr>

939

<tr>

940

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

941

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

941

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

942

943

</tr>

944

</tbody>

946

</div>

947

948

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

949

a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

950

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the records and the list

951

when you are done with it. (You can use <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free-full"><code class="function">g_list_free_full()</code></a> with

952

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

949

a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

950

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the records and the list

951

when you are done with it. (You can use <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free-full"><code class="function">g_list_free_full()</code></a> with

952

<a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> to do this.).

953

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GVariant][<acronym title="Free data after the code is done.">transfer full</acronym>]

954

</div>

955

Since 2.34

959

<a name="g-resolver-lookup-records-async"></a><h3>g_resolver_lookup_records_async ()</h3>

960

<pre class="programlisting">void

961

g_resolver_lookup_records_async (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

962

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

962

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

963

<code>GResolverRecordType record_type</code>,

964

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

965

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

966

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

966

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

967

Begins asynchronously performing a DNS lookup for the given

968

<code>rrname</code>

969

, and eventually calls <code>callback</code>

996

</tr>

997

<tr>

998

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

999

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

999

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

1000

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

1001

</tr>

1002

<tr>

1018

<hr>

1019

1020

<a name="g-resolver-lookup-records-finish"></a><h3>g_resolver_lookup_records_finish ()</h3>

1021

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

1021

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

1022

g_resolver_lookup_records_finish (<code><a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver</code>,

1023

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

1024

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

1024

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

1025

Retrieves the result of a previous call to

1026

<a class="link" href="GResolver.html#g-resolver-lookup-records-async" title="g_resolver_lookup_records_async ()"><code class="function">g_resolver_lookup_records_async()</code></a>. Returns a non-empty list of records as

1027

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> tuples. See GResolverRecordType for information on what the

1027

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> tuples. See GResolverRecordType for information on what the

1028

records contain.

1029

If the DNS resolution failed, <code>error</code>

1030

(if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

1030

(if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) will be set to

1031

a value from <a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a>. If the operation was cancelled,

1032

<code>error</code>

1033

will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a>.

1052

</tr>

1053

<tr>

1054

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

1055

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

1055

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1056

1057

</tr>

1058

</tbody>

1060

</div>

1061

1062

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

1063

a non-empty <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> of

1064

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the records and the list

1065

when you are done with it. (You can use <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free-full"><code class="function">g_list_free_full()</code></a> with

1066

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

1063

a non-empty <a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> of

1064

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. You must free each of the records and the list

1065

when you are done with it. (You can use <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free-full"><code class="function">g_list_free_full()</code></a> with

1066

<a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> to do this.).

1067

[<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GVariant][<acronym title="Free data after the code is done.">transfer full</acronym>]

1068

</div>

1069

Since 2.34

1074

<pre class="programlisting">#define G_RESOLVER_ERROR (g_resolver_error_quark ())

1075

</pre>

1076

Error domain for <a class="link" href="GResolver.html" title="GResolver">GResolver</a>. Errors in this domain will be from the

1077

<a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> enumeration. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> for more information on

1077

<a class="link" href="GResolver.html#GResolverError" title="enum GResolverError">GResolverError</a> enumeration. See <a href="../glib/glib-Error-Reporting.html#GError">GError</a> for more information on

1078

error domains.

1079

</div>

1080

</div>

1089

<hr>

1090

1091

<a name="GResolverError"></a><h3>enum GResolverError</h3>

1092

An error code used with <a class="link" href="GResolver.html#G-RESOLVER-ERROR:CAPS" title="G_RESOLVER_ERROR"><code class="literal">G_RESOLVER_ERROR</code></a> in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> returned

1092

An error code used with <a class="link" href="GResolver.html#G-RESOLVER-ERROR:CAPS" title="G_RESOLVER_ERROR"><code class="literal">G_RESOLVER_ERROR</code></a> in a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> returned

1093

from a <a class="link" href="GResolver.html" title="GResolver">GResolver</a> routine.

1094

1095

<a name="id-1.4.16.2.10.3.4"></a><h4>Members</h4>

1135

<a name="GResolver-reload"></a><h3>The <code class="literal">“reload”</code> signal</h3>

1136

<pre class="programlisting">void

1137

user_function (<a class="link" href="GResolver.html" title="GResolver">GResolver</a> *resolver,

1138

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

1138

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

1139

Emitted when the resolver notices that the system resolver

1140

configuration has changed.

1141