← Back to branch summary

~kklimonda/ubuntu/natty/glibmm2.4/update

« back to all changes in this revision

Viewing changes to docs/reference/html/classGio_1_1Resolver.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2009-09-09 11:22:01 UTC
  • mfrom: (1.2.40 upstream)
  • Revision ID: james.westby@ubuntu.com-20090909112201-1d7zaa574r0ayghb
Tags: 2.21.5-0ubuntu1
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/classGio_1_1Resolver.html
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
 
<html xmlns="http://www.w3.org/1999/xhtml">
3
 
<head>
4
 
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
 
<title>glibmm: Gio::Resolver Class Reference</title>
6
 
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
 
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
 
</head>
9
 
<body>
10
 
<!-- Generated by Doxygen 1.6.1 -->
11
 
<div class="navigation" id="top">
12
 
  <div class="tabs">
13
 
    <ul>
14
 
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
15
 
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
16
 
      <li><a href="modules.html"><span>Modules</span></a></li>
17
 
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
18
 
      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
19
 
      <li><a href="examples.html"><span>Examples</span></a></li>
20
 
    </ul>
21
 
  </div>
22
 
  <div class="tabs">
23
 
    <ul>
24
 
      <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
25
 
      <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
26
 
      <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
27
 
    </ul>
28
 
  </div>
29
 
  <div class="navpath"><a class="el" href="namespaceGio.html">Gio</a>::<a class="el" href="classGio_1_1Resolver.html">Resolver</a>
30
 
  </div>
31
 
</div>
32
 
<div class="contents">
33
 
<h1>Gio::Resolver Class Reference</h1><!-- doxytag: class="Gio::Resolver" --><!-- doxytag: inherits="Glib::Object" -->
34
 
<p>Asynchronous and cancellable DNS resolver. <a href="#_details">More...</a></p>
35
 
 
36
 
<p>Inherits <a class="el" href="classGlib_1_1Object.html">Glib::Object</a>.</p>
37
 
<div class="dynheader">
38
 
Collaboration diagram for Gio::Resolver:</div>
39
 
<div class="dynsection">
40
 
<div class="center"><img src="classGio_1_1Resolver__coll__graph.png" border="0" usemap="#Gio_1_1Resolver_coll__map" alt="Collaboration graph"/></div>
41
 
<map name="Gio_1_1Resolver_coll__map" id="Gio_1_1Resolver_coll__map">
42
 
<area shape="rect" href="classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,155,111,181"/><area shape="rect" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="5,80,125,107"/></map>
43
 
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
44
 
 
45
 
<p><a href="classGio_1_1Resolver-members.html">List of all members.</a></p>
46
 
<table border="0" cellpadding="0" cellspacing="0">
47
 
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
48
 
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a91fb01b808b2e2d315d9ffc149f1f71e">~Resolver</a> ()</td></tr>
49
 
<tr><td class="memItemLeft" align="right" valign="top">GResolver*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a4d323772493d0cf739816c80f08398d2">gobj</a> ()</td></tr>
50
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a4d323772493d0cf739816c80f08398d2"></a><br/></td></tr>
51
 
<tr><td class="memItemLeft" align="right" valign="top">const GResolver*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a77d572cc0c4a48c47ec06e9a5f2d02a9">gobj</a> () const </td></tr>
52
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a77d572cc0c4a48c47ec06e9a5f2d02a9"></a><br/></td></tr>
53
 
<tr><td class="memItemLeft" align="right" valign="top">GResolver*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#ae1cf170f1700985b286238d5f1dcbab2">gobj_copy</a> ()</td></tr>
54
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#ae1cf170f1700985b286238d5f1dcbab2"></a><br/></td></tr>
55
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
56
 
&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#aea1576fa2684d9bca58a589098a8371e">lookup_by_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; hostname, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
57
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Synchronously resolves <em>hostname</em> to determine its associated IP address(es). <a href="#aea1576fa2684d9bca58a589098a8371e"></a><br/></td></tr>
58
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
59
 
&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a4aaf18d0bcc67d6d139d993b140a8b14">lookup_by_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; hostname)</td></tr>
60
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a0130482bb442e3a006e06d57665c2318">lookup_by_name_async</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; hostname, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
61
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#ae38a0fc714443839c0bb3a0e40dcd082">lookup_by_name_async</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; hostname, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>)</td></tr>
62
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
63
 
&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#afaf6f9f003fd213ebecb893d60f14380">lookup_by_name_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp; result)</td></tr>
64
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Retrieves the result of a call to g_resolver_lookup_by_name_async(). <a href="#afaf6f9f003fd213ebecb893d60f14380"></a><br/></td></tr>
65
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#abb5740225148191d2e93d7a6b12caf23">lookup_by_address</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp; address, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
66
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Synchronously reverse-resolves <em>address</em> to determine its associated hostname. <a href="#abb5740225148191d2e93d7a6b12caf23"></a><br/></td></tr>
67
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a81f793a31c8ddaa2bf26361721c3fd1c">lookup_by_address</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp; address)</td></tr>
68
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a3bfd36d312e60b748df35089d5126b4f">lookup_by_address_async</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp; address, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
69
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a91d05a43f8083af54826fcb3303e0eba">lookup_by_address_async</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp; address, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>)</td></tr>
70
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#ae127e4682bfb20ef0b292e7b98460762">lookup_by_address_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp; result)</td></tr>
71
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Retrieves the result of a previous call to g_resolver_lookup_by_address_async(). <a href="#ae127e4682bfb20ef0b292e7b98460762"></a><br/></td></tr>
72
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#aab5e246c4f14e55e079c8a280dd3de5b">lookup_service</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; service, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; protocol, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; domain, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
73
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Synchronously performs a DNS SRV lookup for the given <em>service</em> and <em>protocol</em> in the given <em>domain</em> and returns an array of <a class="el" href="classGio_1_1SrvTarget.html" title="DNS SRV record target.">SrvTarget</a>. <a href="#aab5e246c4f14e55e079c8a280dd3de5b"></a><br/></td></tr>
74
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a3b131a66a7a7bd3e89713384ff2f6be3">lookup_service</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; service, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; protocol, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; domain)</td></tr>
75
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a49d103c02f6e0e8ad5d4e7abb1967ef0">lookup_service_async</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; service, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; protocol, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; domain, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp; cancellable)</td></tr>
76
 
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#a58d46752ddd5305d811df4707c3ce4a7">lookup_service_async</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; service, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; protocol, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp; domain, const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;<a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">slot</a>)</td></tr>
77
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#aae68cb39415c9286474d92c7aeba2e47">lookup_service_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp; result)</td></tr>
78
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Retrieves the result of a previous call to g_resolver_lookup_service_async(). <a href="#aae68cb39415c9286474d92c7aeba2e47"></a><br/></td></tr>
79
 
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
80
 
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Resolver.html">Resolver</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#ac822ffe60ab0ce2acfdc85ccb908f6fc">get_default</a> ()</td></tr>
81
 
<tr><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#afbb1fb4f9edb0e553dbb61ca2437601c">set_default</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Resolver.html">Resolver</a> &gt;&amp; resolver)</td></tr>
82
 
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
83
 
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
84
 
<br/><br/></td></tr>
85
 
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Resolver.html">Gio::Resolver</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1Resolver.html#aa710fc39dacfe0e34730487741d84fb9">wrap</a> (GResolver* object, bool take_copy=false)</td></tr>
86
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#aa710fc39dacfe0e34730487741d84fb9"></a><br/></td></tr>
87
 
</table>
88
 
<hr/><a name="_details"></a><h2>Detailed Description</h2>
89
 
<p>Asynchronous and cancellable DNS resolver. </p>
90
 
<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...">lookup_service()</a>).</p>
91
 
<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>
92
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000060">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
93
 
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
94
 
<a class="anchor" id="a91fb01b808b2e2d315d9ffc149f1f71e"></a><!-- doxytag: member="Gio::Resolver::~Resolver" ref="a91fb01b808b2e2d315d9ffc149f1f71e" args="()" -->
95
 
<div class="memitem">
96
 
<div class="memproto">
97
 
      <table class="memname">
98
 
        <tr>
99
 
          <td class="memname">virtual Gio::Resolver::~Resolver </td>
100
 
          <td>(</td>
101
 
          <td class="paramname"></td>
102
 
          <td>&#160;)&#160;</td>
103
 
          <td><code> [virtual]</code></td>
104
 
        </tr>
105
 
      </table>
106
 
</div>
107
 
<div class="memdoc">
108
 
 
109
 
</div>
110
 
</div>
111
 
<hr/><h2>Member Function Documentation</h2>
112
 
<a class="anchor" id="ac822ffe60ab0ce2acfdc85ccb908f6fc"></a><!-- doxytag: member="Gio::Resolver::get_default" ref="ac822ffe60ab0ce2acfdc85ccb908f6fc" args="()" -->
113
 
<div class="memitem">
114
 
<div class="memproto">
115
 
      <table class="memname">
116
 
        <tr>
117
 
          <td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Resolver.html">Resolver</a>&gt; Gio::Resolver::get_default </td>
118
 
          <td>(</td>
119
 
          <td class="paramname"></td>
120
 
          <td>&#160;)&#160;</td>
121
 
          <td><code> [static]</code></td>
122
 
        </tr>
123
 
      </table>
124
 
</div>
125
 
<div class="memdoc">
126
 
 
127
 
</div>
128
 
</div>
129
 
<a class="anchor" id="a77d572cc0c4a48c47ec06e9a5f2d02a9"></a><!-- doxytag: member="Gio::Resolver::gobj" ref="a77d572cc0c4a48c47ec06e9a5f2d02a9" args="() const " -->
130
 
<div class="memitem">
131
 
<div class="memproto">
132
 
      <table class="memname">
133
 
        <tr>
134
 
          <td class="memname">const GResolver* Gio::Resolver::gobj </td>
135
 
          <td>(</td>
136
 
          <td class="paramname"></td>
137
 
          <td>&#160;)&#160;</td>
138
 
          <td> const<code> [inline]</code></td>
139
 
        </tr>
140
 
      </table>
141
 
</div>
142
 
<div class="memdoc">
143
 
 
144
 
<p>Provides access to the underlying C GObject. </p>
145
 
 
146
 
<p>Reimplemented from <a class="el" href="classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
147
 
 
148
 
</div>
149
 
</div>
150
 
<a class="anchor" id="a4d323772493d0cf739816c80f08398d2"></a><!-- doxytag: member="Gio::Resolver::gobj" ref="a4d323772493d0cf739816c80f08398d2" args="()" -->
151
 
<div class="memitem">
152
 
<div class="memproto">
153
 
      <table class="memname">
154
 
        <tr>
155
 
          <td class="memname">GResolver* Gio::Resolver::gobj </td>
156
 
          <td>(</td>
157
 
          <td class="paramname"></td>
158
 
          <td>&#160;)&#160;</td>
159
 
          <td><code> [inline]</code></td>
160
 
        </tr>
161
 
      </table>
162
 
</div>
163
 
<div class="memdoc">
164
 
 
165
 
<p>Provides access to the underlying C GObject. </p>
166
 
 
167
 
<p>Reimplemented from <a class="el" href="classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
168
 
 
169
 
</div>
170
 
</div>
171
 
<a class="anchor" id="ae1cf170f1700985b286238d5f1dcbab2"></a><!-- doxytag: member="Gio::Resolver::gobj_copy" ref="ae1cf170f1700985b286238d5f1dcbab2" args="()" -->
172
 
<div class="memitem">
173
 
<div class="memproto">
174
 
      <table class="memname">
175
 
        <tr>
176
 
          <td class="memname">GResolver* Gio::Resolver::gobj_copy </td>
177
 
          <td>(</td>
178
 
          <td class="paramname"></td>
179
 
          <td>&#160;)&#160;</td>
180
 
          <td></td>
181
 
        </tr>
182
 
      </table>
183
 
</div>
184
 
<div class="memdoc">
185
 
 
186
 
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
187
 
 
188
 
</div>
189
 
</div>
190
 
<a class="anchor" id="a81f793a31c8ddaa2bf26361721c3fd1c"></a><!-- doxytag: member="Gio::Resolver::lookup_by_address" ref="a81f793a31c8ddaa2bf26361721c3fd1c" args="(const Glib::RefPtr&lt; InetAddress &gt; &amp;address)" -->
191
 
<div class="memitem">
192
 
<div class="memproto">
193
 
      <table class="memname">
194
 
        <tr>
195
 
          <td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::Resolver::lookup_by_address </td>
196
 
          <td>(</td>
197
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp;&#160;</td>
198
 
          <td class="paramname"> <em>address</em></td>
199
 
          <td>&#160;)&#160;</td>
200
 
          <td></td>
201
 
        </tr>
202
 
      </table>
203
 
</div>
204
 
<div class="memdoc">
205
 
 
206
 
</div>
207
 
</div>
208
 
<a class="anchor" id="abb5740225148191d2e93d7a6b12caf23"></a><!-- doxytag: member="Gio::Resolver::lookup_by_address" ref="abb5740225148191d2e93d7a6b12caf23" args="(const Glib::RefPtr&lt; InetAddress &gt; &amp;address, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
209
 
<div class="memitem">
210
 
<div class="memproto">
211
 
      <table class="memname">
212
 
        <tr>
213
 
          <td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::Resolver::lookup_by_address </td>
214
 
          <td>(</td>
215
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp;&#160;</td>
216
 
          <td class="paramname"> <em>address</em>, </td>
217
 
        </tr>
218
 
        <tr>
219
 
          <td class="paramkey"></td>
220
 
          <td></td>
221
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
222
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
223
 
        </tr>
224
 
        <tr>
225
 
          <td></td>
226
 
          <td>)</td>
227
 
          <td></td><td></td><td></td>
228
 
        </tr>
229
 
      </table>
230
 
</div>
231
 
<div class="memdoc">
232
 
 
233
 
<p>Synchronously reverse-resolves <em>address</em> to determine its associated hostname. </p>
234
 
<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError.</p>
235
 
<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>
236
 
<dl><dt><b>Parameters:</b></dt><dd>
237
 
  <table border="0" cellspacing="2" cellpadding="0">
238
 
    <tr><td valign="top"></td><td valign="top"><em>address</em>&#160;</td><td>The address to reverse-resolve. </td></tr>
239
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&#160;</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a>, or <code>0</code>. </td></tr>
240
 
  </table>
241
 
  </dd>
242
 
</dl>
243
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A hostname (either ASCII-only, or in ASCII-encoded form), or <code>0</code> on error.</dd></dl>
244
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000063">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
245
 
 
246
 
</div>
247
 
</div>
248
 
<a class="anchor" id="a91d05a43f8083af54826fcb3303e0eba"></a><!-- doxytag: member="Gio::Resolver::lookup_by_address_async" ref="a91d05a43f8083af54826fcb3303e0eba" args="(const Glib::RefPtr&lt; InetAddress &gt; &amp;address, const SlotAsyncReady &amp;slot)" -->
249
 
<div class="memitem">
250
 
<div class="memproto">
251
 
      <table class="memname">
252
 
        <tr>
253
 
          <td class="memname">void Gio::Resolver::lookup_by_address_async </td>
254
 
          <td>(</td>
255
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp;&#160;</td>
256
 
          <td class="paramname"> <em>address</em>, </td>
257
 
        </tr>
258
 
        <tr>
259
 
          <td class="paramkey"></td>
260
 
          <td></td>
261
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
262
 
          <td class="paramname"> <em>slot</em></td><td>&#160;</td>
263
 
        </tr>
264
 
        <tr>
265
 
          <td></td>
266
 
          <td>)</td>
267
 
          <td></td><td></td><td></td>
268
 
        </tr>
269
 
      </table>
270
 
</div>
271
 
<div class="memdoc">
272
 
 
273
 
</div>
274
 
</div>
275
 
<a class="anchor" id="a3bfd36d312e60b748df35089d5126b4f"></a><!-- doxytag: member="Gio::Resolver::lookup_by_address_async" ref="a3bfd36d312e60b748df35089d5126b4f" args="(const Glib::RefPtr&lt; InetAddress &gt; &amp;address, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
276
 
<div class="memitem">
277
 
<div class="memproto">
278
 
      <table class="memname">
279
 
        <tr>
280
 
          <td class="memname">void Gio::Resolver::lookup_by_address_async </td>
281
 
          <td>(</td>
282
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1InetAddress.html">InetAddress</a> &gt;&amp;&#160;</td>
283
 
          <td class="paramname"> <em>address</em>, </td>
284
 
        </tr>
285
 
        <tr>
286
 
          <td class="paramkey"></td>
287
 
          <td></td>
288
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
289
 
          <td class="paramname"> <em>slot</em>, </td>
290
 
        </tr>
291
 
        <tr>
292
 
          <td class="paramkey"></td>
293
 
          <td></td>
294
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
295
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
296
 
        </tr>
297
 
        <tr>
298
 
          <td></td>
299
 
          <td>)</td>
300
 
          <td></td><td></td><td></td>
301
 
        </tr>
302
 
      </table>
303
 
</div>
304
 
<div class="memdoc">
305
 
 
306
 
</div>
307
 
</div>
308
 
<a class="anchor" id="ae127e4682bfb20ef0b292e7b98460762"></a><!-- doxytag: member="Gio::Resolver::lookup_by_address_finish" ref="ae127e4682bfb20ef0b292e7b98460762" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
309
 
<div class="memitem">
310
 
<div class="memproto">
311
 
      <table class="memname">
312
 
        <tr>
313
 
          <td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::Resolver::lookup_by_address_finish </td>
314
 
          <td>(</td>
315
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp;&#160;</td>
316
 
          <td class="paramname"> <em>result</em></td>
317
 
          <td>&#160;)&#160;</td>
318
 
          <td></td>
319
 
        </tr>
320
 
      </table>
321
 
</div>
322
 
<div class="memdoc">
323
 
 
324
 
<p>Retrieves the result of a previous call to g_resolver_lookup_by_address_async(). </p>
325
 
<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED. </p>
326
 
<dl><dt><b>Parameters:</b></dt><dd>
327
 
  <table border="0" cellspacing="2" cellpadding="0">
328
 
    <tr><td valign="top"></td><td valign="top"><em>result</em>&#160;</td><td>The result passed to your AsyncReadyCallback. </td></tr>
329
 
  </table>
330
 
  </dd>
331
 
</dl>
332
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A hostname (either ASCII-only, or in ASCII-encoded form), or <code>0</code> on error.</dd></dl>
333
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000064">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
334
 
 
335
 
</div>
336
 
</div>
337
 
<a class="anchor" id="a4aaf18d0bcc67d6d139d993b140a8b14"></a><!-- doxytag: member="Gio::Resolver::lookup_by_name" ref="a4aaf18d0bcc67d6d139d993b140a8b14" args="(const Glib::ustring &amp;hostname)" -->
338
 
<div class="memitem">
339
 
<div class="memproto">
340
 
      <table class="memname">
341
 
        <tr>
342
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1InetAddress.html">InetAddress</a>&gt; &gt; Gio::Resolver::lookup_by_name </td>
343
 
          <td>(</td>
344
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
345
 
          <td class="paramname"> <em>hostname</em></td>
346
 
          <td>&#160;)&#160;</td>
347
 
          <td></td>
348
 
        </tr>
349
 
      </table>
350
 
</div>
351
 
<div class="memdoc">
352
 
 
353
 
</div>
354
 
</div>
355
 
<a class="anchor" id="aea1576fa2684d9bca58a589098a8371e"></a><!-- doxytag: member="Gio::Resolver::lookup_by_name" ref="aea1576fa2684d9bca58a589098a8371e" args="(const Glib::ustring &amp;hostname, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
356
 
<div class="memitem">
357
 
<div class="memproto">
358
 
      <table class="memname">
359
 
        <tr>
360
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1InetAddress.html">InetAddress</a>&gt; &gt; Gio::Resolver::lookup_by_name </td>
361
 
          <td>(</td>
362
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
363
 
          <td class="paramname"> <em>hostname</em>, </td>
364
 
        </tr>
365
 
        <tr>
366
 
          <td class="paramkey"></td>
367
 
          <td></td>
368
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
369
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
370
 
        </tr>
371
 
        <tr>
372
 
          <td></td>
373
 
          <td>)</td>
374
 
          <td></td><td></td><td></td>
375
 
        </tr>
376
 
      </table>
377
 
</div>
378
 
<div class="memdoc">
379
 
 
380
 
<p>Synchronously resolves <em>hostname</em> to determine its associated IP address(es). </p>
381
 
<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>
382
 
<p>On success, g_resolver_lookup_by_name() will return a List of <a class="el" href="classGio_1_1InetAddress.html" title="An IPv4/IPv6 address.">InetAddress</a>, sorted in order of preference. (That is, you should attempt to connect to the first address first, then the second if the first fails, etc.)</p>
383
 
<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError.</p>
384
 
<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>
385
 
<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>
386
 
<dl><dt><b>Parameters:</b></dt><dd>
387
 
  <table border="0" cellspacing="2" cellpadding="0">
388
 
    <tr><td valign="top"></td><td valign="top"><em>hostname</em>&#160;</td><td>The hostname to look up. </td></tr>
389
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&#160;</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a>, or <code>0</code>. </td></tr>
390
 
  </table>
391
 
  </dd>
392
 
</dl>
393
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A List of <a class="el" href="classGio_1_1InetAddress.html" title="An IPv4/IPv6 address.">InetAddress</a>, or <code>0</code> on error. You must unref each of the addresses and free the list when you are done with it. (You can use g_resolver_free_addresses() to do this.)</dd></dl>
394
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000061">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
395
 
 
396
 
</div>
397
 
</div>
398
 
<a class="anchor" id="ae38a0fc714443839c0bb3a0e40dcd082"></a><!-- doxytag: member="Gio::Resolver::lookup_by_name_async" ref="ae38a0fc714443839c0bb3a0e40dcd082" args="(const Glib::ustring &amp;hostname, const SlotAsyncReady &amp;slot)" -->
399
 
<div class="memitem">
400
 
<div class="memproto">
401
 
      <table class="memname">
402
 
        <tr>
403
 
          <td class="memname">void Gio::Resolver::lookup_by_name_async </td>
404
 
          <td>(</td>
405
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
406
 
          <td class="paramname"> <em>hostname</em>, </td>
407
 
        </tr>
408
 
        <tr>
409
 
          <td class="paramkey"></td>
410
 
          <td></td>
411
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
412
 
          <td class="paramname"> <em>slot</em></td><td>&#160;</td>
413
 
        </tr>
414
 
        <tr>
415
 
          <td></td>
416
 
          <td>)</td>
417
 
          <td></td><td></td><td></td>
418
 
        </tr>
419
 
      </table>
420
 
</div>
421
 
<div class="memdoc">
422
 
 
423
 
</div>
424
 
</div>
425
 
<a class="anchor" id="a0130482bb442e3a006e06d57665c2318"></a><!-- doxytag: member="Gio::Resolver::lookup_by_name_async" ref="a0130482bb442e3a006e06d57665c2318" args="(const Glib::ustring &amp;hostname, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
426
 
<div class="memitem">
427
 
<div class="memproto">
428
 
      <table class="memname">
429
 
        <tr>
430
 
          <td class="memname">void Gio::Resolver::lookup_by_name_async </td>
431
 
          <td>(</td>
432
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
433
 
          <td class="paramname"> <em>hostname</em>, </td>
434
 
        </tr>
435
 
        <tr>
436
 
          <td class="paramkey"></td>
437
 
          <td></td>
438
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
439
 
          <td class="paramname"> <em>slot</em>, </td>
440
 
        </tr>
441
 
        <tr>
442
 
          <td class="paramkey"></td>
443
 
          <td></td>
444
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
445
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
446
 
        </tr>
447
 
        <tr>
448
 
          <td></td>
449
 
          <td>)</td>
450
 
          <td></td><td></td><td></td>
451
 
        </tr>
452
 
      </table>
453
 
</div>
454
 
<div class="memdoc">
455
 
 
456
 
</div>
457
 
</div>
458
 
<a class="anchor" id="afaf6f9f003fd213ebecb893d60f14380"></a><!-- doxytag: member="Gio::Resolver::lookup_by_name_finish" ref="afaf6f9f003fd213ebecb893d60f14380" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
459
 
<div class="memitem">
460
 
<div class="memproto">
461
 
      <table class="memname">
462
 
        <tr>
463
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">Glib::ListHandle</a>&lt; <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1InetAddress.html">InetAddress</a>&gt; &gt; Gio::Resolver::lookup_by_name_finish </td>
464
 
          <td>(</td>
465
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp;&#160;</td>
466
 
          <td class="paramname"> <em>result</em></td>
467
 
          <td>&#160;)&#160;</td>
468
 
          <td></td>
469
 
        </tr>
470
 
      </table>
471
 
</div>
472
 
<div class="memdoc">
473
 
 
474
 
<p>Retrieves the result of a call to g_resolver_lookup_by_name_async(). </p>
475
 
<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED. </p>
476
 
<dl><dt><b>Parameters:</b></dt><dd>
477
 
  <table border="0" cellspacing="2" cellpadding="0">
478
 
    <tr><td valign="top"></td><td valign="top"><em>result</em>&#160;</td><td>The result passed to your AsyncReadyCallback. </td></tr>
479
 
  </table>
480
 
  </dd>
481
 
</dl>
482
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A List of <a class="el" href="classGio_1_1InetAddress.html" title="An IPv4/IPv6 address.">InetAddress</a>, or <code>0</code> on error. See g_resolver_lookup_by_name() for more details.</dd></dl>
483
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000062">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
484
 
 
485
 
</div>
486
 
</div>
487
 
<a class="anchor" id="a3b131a66a7a7bd3e89713384ff2f6be3"></a><!-- doxytag: member="Gio::Resolver::lookup_service" ref="a3b131a66a7a7bd3e89713384ff2f6be3" args="(const Glib::ustring &amp;service, const Glib::ustring &amp;protocol, const Glib::ustring &amp;domain)" -->
488
 
<div class="memitem">
489
 
<div class="memproto">
490
 
      <table class="memname">
491
 
        <tr>
492
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a> Gio::Resolver::lookup_service </td>
493
 
          <td>(</td>
494
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
495
 
          <td class="paramname"> <em>service</em>, </td>
496
 
        </tr>
497
 
        <tr>
498
 
          <td class="paramkey"></td>
499
 
          <td></td>
500
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
501
 
          <td class="paramname"> <em>protocol</em>, </td>
502
 
        </tr>
503
 
        <tr>
504
 
          <td class="paramkey"></td>
505
 
          <td></td>
506
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
507
 
          <td class="paramname"> <em>domain</em></td><td>&#160;</td>
508
 
        </tr>
509
 
        <tr>
510
 
          <td></td>
511
 
          <td>)</td>
512
 
          <td></td><td></td><td></td>
513
 
        </tr>
514
 
      </table>
515
 
</div>
516
 
<div class="memdoc">
517
 
 
518
 
</div>
519
 
</div>
520
 
<a class="anchor" id="aab5e246c4f14e55e079c8a280dd3de5b"></a><!-- doxytag: member="Gio::Resolver::lookup_service" ref="aab5e246c4f14e55e079c8a280dd3de5b" args="(const Glib::ustring &amp;service, const Glib::ustring &amp;protocol, const Glib::ustring &amp;domain, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
521
 
<div class="memitem">
522
 
<div class="memproto">
523
 
      <table class="memname">
524
 
        <tr>
525
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a> Gio::Resolver::lookup_service </td>
526
 
          <td>(</td>
527
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
528
 
          <td class="paramname"> <em>service</em>, </td>
529
 
        </tr>
530
 
        <tr>
531
 
          <td class="paramkey"></td>
532
 
          <td></td>
533
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
534
 
          <td class="paramname"> <em>protocol</em>, </td>
535
 
        </tr>
536
 
        <tr>
537
 
          <td class="paramkey"></td>
538
 
          <td></td>
539
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
540
 
          <td class="paramname"> <em>domain</em>, </td>
541
 
        </tr>
542
 
        <tr>
543
 
          <td class="paramkey"></td>
544
 
          <td></td>
545
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
546
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
547
 
        </tr>
548
 
        <tr>
549
 
          <td></td>
550
 
          <td>)</td>
551
 
          <td></td><td></td><td></td>
552
 
        </tr>
553
 
      </table>
554
 
</div>
555
 
<div class="memdoc">
556
 
 
557
 
<p>Synchronously performs a DNS SRV lookup for the given <em>service</em> and <em>protocol</em> in the given <em>domain</em> and returns an array of <a class="el" href="classGio_1_1SrvTarget.html" title="DNS SRV record target.">SrvTarget</a>. </p>
558
 
<p><em>domain</em> may be an ASCII-only or UTF-8 hostname. Note also that the <em>service</em> and <em>protocol</em> arguments &lt;emphasis&gt;do not&lt;/emphasis&gt; include the leading underscore that appears in the actual DNS entry.</p>
559
 
<p>On success, g_resolver_lookup_service() will return a List of <a class="el" href="classGio_1_1SrvTarget.html" title="DNS SRV record target.">SrvTarget</a>, sorted in order of preference. (That is, you should attempt to connect to the first target first, then the second if the first fails, etc.)</p>
560
 
<p>If the DNS resolution fails, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError.</p>
561
 
<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>
562
 
<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>
563
 
<dl><dt><b>Parameters:</b></dt><dd>
564
 
  <table border="0" cellspacing="2" cellpadding="0">
565
 
    <tr><td valign="top"></td><td valign="top"><em>service</em>&#160;</td><td>The service type to look up (eg, "ldap"). </td></tr>
566
 
    <tr><td valign="top"></td><td valign="top"><em>protocol</em>&#160;</td><td>The networking protocol to use for <em>service</em> (eg, "tcp"). </td></tr>
567
 
    <tr><td valign="top"></td><td valign="top"><em>domain</em>&#160;</td><td>The DNS domain to look up the service in. </td></tr>
568
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&#160;</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a>, or <code>0</code>. </td></tr>
569
 
  </table>
570
 
  </dd>
571
 
</dl>
572
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A List of <a class="el" href="classGio_1_1SrvTarget.html" title="DNS SRV record target.">SrvTarget</a>, or <code>0</code> on error. You must free each of the targets and the list when you are done with it. (You can use g_resolver_free_targets() to do this.)</dd></dl>
573
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000065">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
574
 
 
575
 
</div>
576
 
</div>
577
 
<a class="anchor" id="a58d46752ddd5305d811df4707c3ce4a7"></a><!-- doxytag: member="Gio::Resolver::lookup_service_async" ref="a58d46752ddd5305d811df4707c3ce4a7" args="(const Glib::ustring &amp;service, const Glib::ustring &amp;protocol, const Glib::ustring &amp;domain, const SlotAsyncReady &amp;slot)" -->
578
 
<div class="memitem">
579
 
<div class="memproto">
580
 
      <table class="memname">
581
 
        <tr>
582
 
          <td class="memname">void Gio::Resolver::lookup_service_async </td>
583
 
          <td>(</td>
584
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
585
 
          <td class="paramname"> <em>service</em>, </td>
586
 
        </tr>
587
 
        <tr>
588
 
          <td class="paramkey"></td>
589
 
          <td></td>
590
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
591
 
          <td class="paramname"> <em>protocol</em>, </td>
592
 
        </tr>
593
 
        <tr>
594
 
          <td class="paramkey"></td>
595
 
          <td></td>
596
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
597
 
          <td class="paramname"> <em>domain</em>, </td>
598
 
        </tr>
599
 
        <tr>
600
 
          <td class="paramkey"></td>
601
 
          <td></td>
602
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
603
 
          <td class="paramname"> <em>slot</em></td><td>&#160;</td>
604
 
        </tr>
605
 
        <tr>
606
 
          <td></td>
607
 
          <td>)</td>
608
 
          <td></td><td></td><td></td>
609
 
        </tr>
610
 
      </table>
611
 
</div>
612
 
<div class="memdoc">
613
 
 
614
 
</div>
615
 
</div>
616
 
<a class="anchor" id="a49d103c02f6e0e8ad5d4e7abb1967ef0"></a><!-- doxytag: member="Gio::Resolver::lookup_service_async" ref="a49d103c02f6e0e8ad5d4e7abb1967ef0" args="(const Glib::ustring &amp;service, const Glib::ustring &amp;protocol, const Glib::ustring &amp;domain, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
617
 
<div class="memitem">
618
 
<div class="memproto">
619
 
      <table class="memname">
620
 
        <tr>
621
 
          <td class="memname">void Gio::Resolver::lookup_service_async </td>
622
 
          <td>(</td>
623
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
624
 
          <td class="paramname"> <em>service</em>, </td>
625
 
        </tr>
626
 
        <tr>
627
 
          <td class="paramkey"></td>
628
 
          <td></td>
629
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
630
 
          <td class="paramname"> <em>protocol</em>, </td>
631
 
        </tr>
632
 
        <tr>
633
 
          <td class="paramkey"></td>
634
 
          <td></td>
635
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&#160;</td>
636
 
          <td class="paramname"> <em>domain</em>, </td>
637
 
        </tr>
638
 
        <tr>
639
 
          <td class="paramkey"></td>
640
 
          <td></td>
641
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&#160;</td>
642
 
          <td class="paramname"> <em>slot</em>, </td>
643
 
        </tr>
644
 
        <tr>
645
 
          <td class="paramkey"></td>
646
 
          <td></td>
647
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> &gt;&amp;&#160;</td>
648
 
          <td class="paramname"> <em>cancellable</em></td><td>&#160;</td>
649
 
        </tr>
650
 
        <tr>
651
 
          <td></td>
652
 
          <td>)</td>
653
 
          <td></td><td></td><td></td>
654
 
        </tr>
655
 
      </table>
656
 
</div>
657
 
<div class="memdoc">
658
 
 
659
 
</div>
660
 
</div>
661
 
<a class="anchor" id="aae68cb39415c9286474d92c7aeba2e47"></a><!-- doxytag: member="Gio::Resolver::lookup_service_finish" ref="aae68cb39415c9286474d92c7aeba2e47" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
662
 
<div class="memitem">
663
 
<div class="memproto">
664
 
      <table class="memname">
665
 
        <tr>
666
 
          <td class="memname"><a class="el" href="classGlib_1_1ListHandle.html">ListHandle_SrvTarget</a> Gio::Resolver::lookup_service_finish </td>
667
 
          <td>(</td>
668
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> &gt;&amp;&#160;</td>
669
 
          <td class="paramname"> <em>result</em></td>
670
 
          <td>&#160;)&#160;</td>
671
 
          <td></td>
672
 
        </tr>
673
 
      </table>
674
 
</div>
675
 
<div class="memdoc">
676
 
 
677
 
<p>Retrieves the result of a previous call to g_resolver_lookup_service_async(). </p>
678
 
<p>If the DNS resolution failed, <em>error</em> (if non-<code>0</code>) will be set to a value from ResolverError. If the operation was cancelled, <em>error</em> will be set to IO_ERROR_CANCELLED. </p>
679
 
<dl><dt><b>Parameters:</b></dt><dd>
680
 
  <table border="0" cellspacing="2" cellpadding="0">
681
 
    <tr><td valign="top"></td><td valign="top"><em>result</em>&#160;</td><td>The result passed to your AsyncReadyCallback. </td></tr>
682
 
  </table>
683
 
  </dd>
684
 
</dl>
685
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A List of <a class="el" href="classGio_1_1SrvTarget.html" title="DNS SRV record target.">SrvTarget</a>, or <code>0</code> on error. See g_resolver_lookup_service() for more details.</dd></dl>
686
 
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000066">Since glibmm 2.22:</a></b></dt><dd></dd></dl>
687
 
 
688
 
</div>
689
 
</div>
690
 
<a class="anchor" id="afbb1fb4f9edb0e553dbb61ca2437601c"></a><!-- doxytag: member="Gio::Resolver::set_default" ref="afbb1fb4f9edb0e553dbb61ca2437601c" args="(const Glib::RefPtr&lt; Resolver &gt; &amp;resolver)" -->
691
 
<div class="memitem">
692
 
<div class="memproto">
693
 
      <table class="memname">
694
 
        <tr>
695
 
          <td class="memname">static void Gio::Resolver::set_default </td>
696
 
          <td>(</td>
697
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Resolver.html">Resolver</a> &gt;&amp;&#160;</td>
698
 
          <td class="paramname"> <em>resolver</em></td>
699
 
          <td>&#160;)&#160;</td>
700
 
          <td><code> [static]</code></td>
701
 
        </tr>
702
 
      </table>
703
 
</div>
704
 
<div class="memdoc">
705
 
 
706
 
</div>
707
 
</div>
708
 
<hr/><h2>Friends And Related Function Documentation</h2>
709
 
<a class="anchor" id="aa710fc39dacfe0e34730487741d84fb9"></a><!-- doxytag: member="Gio::Resolver::wrap" ref="aa710fc39dacfe0e34730487741d84fb9" args="(GResolver *object, bool take_copy=false)" -->
710
 
<div class="memitem">
711
 
<div class="memproto">
712
 
      <table class="memname">
713
 
        <tr>
714
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGio_1_1Resolver.html">Gio::Resolver</a> &gt; wrap </td>
715
 
          <td>(</td>
716
 
          <td class="paramtype">GResolver *&#160;</td>
717
 
          <td class="paramname"> <em>object</em>, </td>
718
 
        </tr>
719
 
        <tr>
720
 
          <td class="paramkey"></td>
721
 
          <td></td>
722
 
          <td class="paramtype">bool&#160;</td>
723
 
          <td class="paramname"> <em>take_copy</em> = <code>false</code></td><td>&#160;</td>
724
 
        </tr>
725
 
        <tr>
726
 
          <td></td>
727
 
          <td>)</td>
728
 
          <td></td><td></td><td><code> [related]</code></td>
729
 
        </tr>
730
 
      </table>
731
 
</div>
732
 
<div class="memdoc">
733
 
 
734
 
<p>A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
735
 
<dl><dt><b>Parameters:</b></dt><dd>
736
 
  <table border="0" cellspacing="2" cellpadding="0">
737
 
    <tr><td valign="top"></td><td valign="top"><em>object</em>&#160;</td><td>The C instance. </td></tr>
738
 
    <tr><td valign="top"></td><td valign="top"><em>take_copy</em>&#160;</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
739
 
  </table>
740
 
  </dd>
741
 
</dl>
742
 
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
743
 
 
744
 
</div>
745
 
</div>
746
 
<hr/>The documentation for this class was generated from the following file:<ul>
747
 
<li>giomm/resolver.h</li>
748
 
</ul>
749
 
</div>
750
 
<hr size="1"/><address style="text-align: right;"><small>Generated on Tue Sep 1 23:21:18 2009 for glibmm by&#160;
751
 
<a href="http://www.doxygen.org/index.html">
752
 
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
753
 
</body>
754
 
</html>