1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>GetHostByName</title>
8  </head>
9  <body>
10<h1><CODE>nn::socket::GetHostByName</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/socket/HostEnt/Overview.html">HostEnt</a> * GetHostByName(
15     const char8 * name
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>name</th>
32<td>Specifies a pointer to a host name string or to a string that represents the IPv4 host address in dotted-decimal notation. The string must be <CODE>NULL</CODE>-terminated.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">If successful, returns a pointer to a <a href="../../nn/socket/HostEnt.html"><CODE>HostEnt</CODE></a> structure containing the host's information. The structure instance is a library internal buffer. </div>
37<h2>Description</h2>
38    <div class="section">
39<p>Searches for host information based on the host name.</p><p>Since this function might query the DNS server, it blocks until the search is complete. The <CODE>GetHostByName</CODE> function is neither reentrant nor thread-safe. Use the <a href="../../nn/socket/GetAddrInfo.html"><CODE>GetAddrInfo</CODE></a> function instead if you need to call from multiple threads.</p><p>On failure, returns <CODE>NULL</CODE>.</p><!-- write here --></div>
40<h2>See Also</h2>
41    <div class="section">
42<p class="reference"><a href="../../nn/socket/GetHostByAddr.html"><CODE>GetHostByAddr</CODE></a>, <a href="../../nn/socket/GetAddrInfo.html"><CODE>GetAddrInfo</CODE></a><br /> </p>
43    </div>
44<h2>Revision History</h2>
45    <div class="section">
46      <dl class="history">
47        <dt>2010/06/14</dt>
48<dd>Initial version.<br />
49        </dd>
50      </dl>
51    </div>
52  <hr><p>CONFIDENTIAL</p></body>
53</html>