1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>ip::basic_resolver::query</title> 5<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css"> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="../../../boost_asio.html" title="Boost.Asio"> 8<link rel="up" href="../ip__basic_resolver.html" title="ip::basic_resolver"> 9<link rel="prev" href="protocol_type.html" title="ip::basic_resolver::protocol_type"> 10<link rel="next" href="resolve.html" title="ip::basic_resolver::resolve"> 11</head> 12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 13<table cellpadding="2" width="100%"><tr> 14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td> 15<td align="center"><a href="../../../../../index.html">Home</a></td> 16<td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td> 17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 19<td align="center"><a href="../../../../../more/index.htm">More</a></td> 20</tr></table> 21<hr> 22<div class="spirit-nav"> 23<a accesskey="p" href="protocol_type.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../ip__basic_resolver.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../boost_asio.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="resolve.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h4 class="title"> 27<a name="boost_asio.reference.ip__basic_resolver.query"></a><a class="link" href="query.html" title="ip::basic_resolver::query">ip::basic_resolver::query</a> 28</h4></div></div></div> 29<p> 30 <a class="indexterm" name="boost_asio.indexterm.ip__basic_resolver.query"></a> 31(Deprecated.) 32 The query type. 33 </p> 34<pre class="programlisting">typedef basic_resolver_query< InternetProtocol > query; 35</pre> 36<h6> 37<a name="boost_asio.reference.ip__basic_resolver.query.h0"></a> 38 <span class="phrase"><a name="boost_asio.reference.ip__basic_resolver.query.types"></a></span><a class="link" href="query.html#boost_asio.reference.ip__basic_resolver.query.types">Types</a> 39 </h6> 40<div class="informaltable"><table class="table"> 41<colgroup> 42<col> 43<col> 44</colgroup> 45<thead><tr> 46<th> 47 <p> 48 Name 49 </p> 50 </th> 51<th> 52 <p> 53 Description 54 </p> 55 </th> 56</tr></thead> 57<tbody> 58<tr> 59<td> 60 <p> 61 <a class="link" href="../ip__basic_resolver_query/flags.html" title="ip::basic_resolver_query::flags"><span class="bold"><strong>flags</strong></span></a> 62 </p> 63 </td> 64<td> 65 <p> 66 A bitmask type (C++ Std [lib.bitmask.types]). 67 </p> 68 </td> 69</tr> 70<tr> 71<td> 72 <p> 73 <a class="link" href="../ip__basic_resolver_query/protocol_type.html" title="ip::basic_resolver_query::protocol_type"><span class="bold"><strong>protocol_type</strong></span></a> 74 </p> 75 </td> 76<td> 77 <p> 78 The protocol type associated with the endpoint query. 79 </p> 80 </td> 81</tr> 82</tbody> 83</table></div> 84<h6> 85<a name="boost_asio.reference.ip__basic_resolver.query.h1"></a> 86 <span class="phrase"><a name="boost_asio.reference.ip__basic_resolver.query.member_functions"></a></span><a class="link" href="query.html#boost_asio.reference.ip__basic_resolver.query.member_functions">Member 87 Functions</a> 88 </h6> 89<div class="informaltable"><table class="table"> 90<colgroup> 91<col> 92<col> 93</colgroup> 94<thead><tr> 95<th> 96 <p> 97 Name 98 </p> 99 </th> 100<th> 101 <p> 102 Description 103 </p> 104 </th> 105</tr></thead> 106<tbody> 107<tr> 108<td> 109 <p> 110 <a class="link" href="../ip__basic_resolver_query/basic_resolver_query.html" title="ip::basic_resolver_query::basic_resolver_query"><span class="bold"><strong>basic_resolver_query</strong></span></a> <span class="silver">[constructor]</span> 111 </p> 112 </td> 113<td> 114 <p> 115 Construct with specified service name for any protocol. <br> 116 <span class="silver"> —</span><br> Construct with specified service name for a given protocol. 117 <br> <span class="silver"> —</span><br> Construct with specified host name and service 118 name for any protocol. <br> <span class="silver"> —</span><br> Construct with specified 119 host name and service name for a given protocol. 120 </p> 121 </td> 122</tr> 123<tr> 124<td> 125 <p> 126 <a class="link" href="../ip__basic_resolver_query/hints.html" title="ip::basic_resolver_query::hints"><span class="bold"><strong>hints</strong></span></a> 127 </p> 128 </td> 129<td> 130 <p> 131 Get the hints associated with the query. 132 </p> 133 </td> 134</tr> 135<tr> 136<td> 137 <p> 138 <a class="link" href="../ip__basic_resolver_query/host_name.html" title="ip::basic_resolver_query::host_name"><span class="bold"><strong>host_name</strong></span></a> 139 </p> 140 </td> 141<td> 142 <p> 143 Get the host name associated with the query. 144 </p> 145 </td> 146</tr> 147<tr> 148<td> 149 <p> 150 <a class="link" href="../ip__basic_resolver_query/service_name.html" title="ip::basic_resolver_query::service_name"><span class="bold"><strong>service_name</strong></span></a> 151 </p> 152 </td> 153<td> 154 <p> 155 Get the service name associated with the query. 156 </p> 157 </td> 158</tr> 159</tbody> 160</table></div> 161<h6> 162<a name="boost_asio.reference.ip__basic_resolver.query.h2"></a> 163 <span class="phrase"><a name="boost_asio.reference.ip__basic_resolver.query.data_members"></a></span><a class="link" href="query.html#boost_asio.reference.ip__basic_resolver.query.data_members">Data 164 Members</a> 165 </h6> 166<div class="informaltable"><table class="table"> 167<colgroup> 168<col> 169<col> 170</colgroup> 171<thead><tr> 172<th> 173 <p> 174 Name 175 </p> 176 </th> 177<th> 178 <p> 179 Description 180 </p> 181 </th> 182</tr></thead> 183<tbody> 184<tr> 185<td> 186 <p> 187 <a class="link" href="../ip__basic_resolver_query/address_configured.html" title="ip::basic_resolver_query::address_configured"><span class="bold"><strong>address_configured</strong></span></a> <span class="silver">[static]</span> 188 </p> 189 </td> 190<td> 191 <p> 192 Only return IPv4 addresses if a non-loopback IPv4 address is 193 configured for the system. Only return IPv6 addresses if a non-loopback 194 IPv6 address is configured for the system. 195 </p> 196 </td> 197</tr> 198<tr> 199<td> 200 <p> 201 <a class="link" href="../ip__basic_resolver_query/all_matching.html" title="ip::basic_resolver_query::all_matching"><span class="bold"><strong>all_matching</strong></span></a> <span class="silver">[static]</span> 202 </p> 203 </td> 204<td> 205 <p> 206 If used with v4_mapped, return all matching IPv6 and IPv4 addresses. 207 </p> 208 </td> 209</tr> 210<tr> 211<td> 212 <p> 213 <a class="link" href="../ip__basic_resolver_query/canonical_name.html" title="ip::basic_resolver_query::canonical_name"><span class="bold"><strong>canonical_name</strong></span></a> <span class="silver">[static]</span> 214 </p> 215 </td> 216<td> 217 <p> 218 Determine the canonical name of the host specified in the query. 219 </p> 220 </td> 221</tr> 222<tr> 223<td> 224 <p> 225 <a class="link" href="../ip__basic_resolver_query/numeric_host.html" title="ip::basic_resolver_query::numeric_host"><span class="bold"><strong>numeric_host</strong></span></a> <span class="silver">[static]</span> 226 </p> 227 </td> 228<td> 229 <p> 230 Host name should be treated as a numeric string defining an IPv4 231 or IPv6 address and no name resolution should be attempted. 232 </p> 233 </td> 234</tr> 235<tr> 236<td> 237 <p> 238 <a class="link" href="../ip__basic_resolver_query/numeric_service.html" title="ip::basic_resolver_query::numeric_service"><span class="bold"><strong>numeric_service</strong></span></a> <span class="silver">[static]</span> 239 </p> 240 </td> 241<td> 242 <p> 243 Service name should be treated as a numeric string defining a 244 port number and no name resolution should be attempted. 245 </p> 246 </td> 247</tr> 248<tr> 249<td> 250 <p> 251 <a class="link" href="../ip__basic_resolver_query/passive.html" title="ip::basic_resolver_query::passive"><span class="bold"><strong>passive</strong></span></a> <span class="silver">[static]</span> 252 </p> 253 </td> 254<td> 255 <p> 256 Indicate that returned endpoint is intended for use as a locally 257 bound socket endpoint. 258 </p> 259 </td> 260</tr> 261<tr> 262<td> 263 <p> 264 <a class="link" href="../ip__basic_resolver_query/v4_mapped.html" title="ip::basic_resolver_query::v4_mapped"><span class="bold"><strong>v4_mapped</strong></span></a> <span class="silver">[static]</span> 265 </p> 266 </td> 267<td> 268 <p> 269 If the query protocol family is specified as IPv6, return IPv4-mapped 270 IPv6 addresses on finding no IPv6 addresses. 271 </p> 272 </td> 273</tr> 274</tbody> 275</table></div> 276<p> 277 The <a class="link" href="../ip__basic_resolver_query.html" title="ip::basic_resolver_query"><code class="computeroutput">ip::basic_resolver_query</code></a> 278 class template describes a query that can be passed to a resolver. 279 </p> 280<h6> 281<a name="boost_asio.reference.ip__basic_resolver.query.h3"></a> 282 <span class="phrase"><a name="boost_asio.reference.ip__basic_resolver.query.thread_safety"></a></span><a class="link" href="query.html#boost_asio.reference.ip__basic_resolver.query.thread_safety">Thread 283 Safety</a> 284 </h6> 285<p> 286 <span class="emphasis"><em>Distinct</em></span> <span class="emphasis"><em>objects:</em></span> Safe. 287 </p> 288<p> 289 <span class="emphasis"><em>Shared</em></span> <span class="emphasis"><em>objects:</em></span> Unsafe. 290 </p> 291<h6> 292<a name="boost_asio.reference.ip__basic_resolver.query.h4"></a> 293 <span class="phrase"><a name="boost_asio.reference.ip__basic_resolver.query.requirements"></a></span><a class="link" href="query.html#boost_asio.reference.ip__basic_resolver.query.requirements">Requirements</a> 294 </h6> 295<p> 296 <span class="emphasis"><em>Header: </em></span><code class="literal">boost/asio/ip/basic_resolver.hpp</code> 297 </p> 298<p> 299 <span class="emphasis"><em>Convenience header: </em></span><code class="literal">boost/asio.hpp</code> 300 </p> 301</div> 302<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 303<td align="left"></td> 304<td align="right"><div class="copyright-footer">Copyright © 2003-2020 Christopher M. 305 Kohlhoff<p> 306 Distributed under the Boost Software License, Version 1.0. (See accompanying 307 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 308 </p> 309</div></td> 310</tr></table> 311<hr> 312<div class="spirit-nav"> 313<a accesskey="p" href="protocol_type.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../ip__basic_resolver.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../boost_asio.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="resolve.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> 314</div> 315</body> 316</html> 317