~ubuntu-branches/ubuntu/trusty/glibmm2.4/trusty

 <tbody>

 <tr style="height: 56px;">

  <td style="padding-left: 0.5em;">

  </td>

 </tr>

 </tbody>

<div class="textblock"><p>Asynchronous and cancellable DNS resolver. </p>

<p><a class="el" href="classGio_1_1Resolver.html" title="Asynchronous and cancellable DNS resolver.">Resolver</a> provides cancellable synchronous and asynchronous DNS resolution, for hostnames (<a class="el" href="classGio_1_1Resolver.html#abb5740225148191d2e93d7a6b12caf23" title="Synchronously reverse-resolves address to determine its associated hostname.">lookup_by_address()</a>, <a class="el" href="classGio_1_1Resolver.html#aea1576fa2684d9bca58a589098a8371e" title="Synchronously resolves hostname to determine its associated IP address(es).">lookup_by_name()</a> and their async variants) and SRV (service) records (<a class="el" href="classGio_1_1Resolver.html#aab5e246c4f14e55e079c8a280dd3de5b" title="Synchronously performs a DNS SRV lookup for the given service and protocol in the given domain and re...">lookup_service()</a>).</p>

<p><a class="el" href="classGio_1_1NetworkAddress.html" title="A SocketConnectable for resolving hostnames.">NetworkAddress</a> and <a class="el" href="classGio_1_1NetworkService.html" title="A GSocketConnectable for resolving SRV records.">NetworkService</a> provide wrappers around <a class="el" href="classGio_1_1Resolver.html" title="Asynchronous and cancellable DNS resolver.">Resolver</a> functionality that also implement <a class="el" href="classGio_1_1SocketConnectable.html" title="Interface for potential socket endpoints.">SocketConnectable</a>, making it easy to connect to a remote host/service.</p>

</div><hr/><h2>Constructor &amp; Destructor Documentation</h2>

<a class="anchor" id="a91fb01b808b2e2d315d9ffc149f1f71e"></a><!-- doxytag: member="Gio::Resolver::~Resolver" ref="a91fb01b808b2e2d315d9ffc149f1f71e" args="()" -->

<div class="memitem">

<p>Synchronously reverse-resolves <em>address</em> to determine its associated hostname. </p>

<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>.</p>

<p>If <em>cancellable</em> is non-<code>0</code>, it can be used to cancel the operation, in which case <em>error</em> (if non-<code>0</code>) will be set to IO_ERROR_CANCELLED.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">address</td><td>The address to reverse-resolve. </td></tr>

 

<p>Retrieves the result of a previous call to g_resolver_lookup_by_address_async(). </p>

<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">result</td><td>The result passed to your AsyncReadyCallback. </td></tr>

 

<p>Synchronously resolves <em>hostname</em> to determine its associated IP address(es). </p>

<p><em>hostname</em> may be an ASCII-only or UTF-8 hostname, or the textual form of an IP address (in which case this just becomes a wrapper around g_inet_address_new_from_string()).</p>

<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>.</p>

<p>If <em>cancellable</em> is non-<code>0</code>, it can be used to cancel the operation, in which case <em>error</em> (if non-<code>0</code>) will be set to IO_ERROR_CANCELLED.</p>

<p>If you are planning to connect to a socket on the resolved IP address, it may be easier to create a <a class="el" href="classGio_1_1NetworkAddress.html" title="A SocketConnectable for resolving hostnames.">NetworkAddress</a> and use its <a class="el" href="classGio_1_1SocketConnectable.html" title="Interface for potential socket endpoints.">SocketConnectable</a> interface.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">hostname</td><td>The hostname to look up. </td></tr>

 

<p>Retrieves the result of a call to g_resolver_lookup_by_name_async(). </p>

<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">result</td><td>The result passed to your AsyncReadyCallback. </td></tr>

<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>.</p>

<p>If <em>cancellable</em> is non-<code>0</code>, it can be used to cancel the operation, in which case <em>error</em> (if non-<code>0</code>) will be set to IO_ERROR_CANCELLED.</p>

<p>If you are planning to connect to the service, it is usually easier to create a <a class="el" href="classGio_1_1NetworkService.html" title="A GSocketConnectable for resolving SRV records.">NetworkService</a> and use its <a class="el" href="classGio_1_1SocketConnectable.html" title="Interface for potential socket endpoints.">SocketConnectable</a> interface.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">service</td><td>The service type to look up (eg, "ldap"). </td></tr>

 

<p>Retrieves the result of a previous call to g_resolver_lookup_service_async(). </p>

<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from <a class="el" href="classGio_1_1ResolverError.html">ResolverError</a>. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">result</td><td>The result passed to your AsyncReadyCallback. </td></tr>

      </table>

</div>

<div class="memdoc">

 

</div>

</div>

</div>

</div>

</div>

<a href="http://www.doxygen.org/index.html">

<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>

</body>