套接口库函数参考(十七)

2010-12-30 21:03:01 · 作者: · 浏览: 59160
.

 

参见: WSAAsyncGetHostByAddr(), gethostbyname()

 

5.2.2 gethostbyname()

简述:

    返回对应于给定主机名的主机信息。

 

       #include <winsock.h>

      

       struct hostent FAR *PASCAL FAR gethostbyname(const char

       FAR * addr);

 

       name:指向主机名的指针。

 

注释:

    gethostbyname()返回对应于给定主机名的包含主机名字和地址信息的hostent结构指针。结构的声明与gethostaddr()中一致。

 

       返回的指针指向一个由Windows Sockets实现分配的结构。应用程序不应该试图修改这个结构或者释放它的任何部分。此外,每一线程仅有一份这个结构的拷贝,所以应用程序应该在发出其他Windows Scokets API调用前,把自己所需的信息拷贝下来。

 

       gethostbyname()实现没有必要识别传送给它的IP地址串。对于这样的请求,应该把IP地址串当作一个未知主机名同样处理。如果应用程序有IP地址串需要处理,它应该使用inet_addr()函数把地址串转换为IP地址,然后调用gethostbyaddr()来得到hostent结构。

 

返回值:

    如果没有错误发生,gethost