gethostbyname

gethostbyname() - 简述

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

头文件：#include <netdb.h>
        
原型：struct hostent FAR *PASCAL FAR gethostbyname(const char  FAR * addr);

参数：name(指向主机名的指针)。

gethostbyname() - 注释

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

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

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

gethostbyname() - 返回值

如果没有错误发生，gethostbyname()返回如上所述的一个指向hostent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：
WSANOTINTIALISED  在应用这个API前，必须成功地调用WSAStartup()。
WSAENTDOWN        Windows Sockets实现检测到了网络子系统的错误。
WSAHOST_NOT_FOUND 没有找到授权应答主机。
WSATRY_AGAIN      没有找到非授权主机，或者SERVERFAIL。
WSANO_RECOVERY    无法恢复的错误，FORMERR，REFUSED，NOTIMP。
WSANO_DATA        有效的名字，但没有关于请求类型的数据记录。
WSAEINPROGRESS    一个阻塞的Windows Sockets操作正在进行。
WSAEINTR          阻塞调用被WSACancelBlockingCall()取消了。

参见： WSAAsyncGetHostByName()，gethostbyaddr()

gethostbyname() - 举例说明

struct hostent *gethostbyname(const char *name)；
这个函数的传入值是域名或者主机名，例如"www.google.com","wpc"等等。
传出值，是一个hostent的结构（如下）。如果函数调用失败，将返回NULL。

struct hostent {
  char  *h_name;
  char  **h_aliases;
  int   h_addrtype;
  int   h_length;
  char  **h_addr_list;
  };
解释一下这个结构：
其中，
char *h_name 表示的是主机的规范名。例如www.google.com的规范名其实是www.l.google.com。
char   **h_aliases 表示的是主机的别名。www.google.com就是google他自己的别名。有的时候，有的主机可能有好几个别名，这些，其实都是为了易于用户记忆而为自己的网站多取的名字。
int   h_addrtype 表示的是主机ip地址的类型，到底是ipv4(AF_INET)，还是ipv6(AF_INET6)
int   h_length 表示的是主机ip地址的长度
int   **h_addr_lisst 表示的是主机的ip地址，注意，这个是以网络字节序存储的。千万不要直接用printf带%s参数来打这个东西，会有问题。所以到真正需要打印出这个IP的话，需要调用inet_ntop()。

const char *inet_ntop(int af, const void *src, char *dst, socklen_t cnt) ：
这个函数，是将类型为af的网络地址结构src，转换成主机序的字符串形式，存放在长度为cnt的字符串中。
这个函数，其实就是返回指向dst的一个指针。如果函数调用错误，返回值是NULL。

下面是例程，有详细的注释。

#include

int main(int argc, char **argv)
{
 char *ptr,**pptr;
 struct hostent *hptr;
 char str[32];
 /* 取得命令后第一个参数，即要解析的域名或主机名 */
 ptr = argv[1];
 /* 调用gethostbyname()。调用结果都存在hptr中 */
 if( (hptr = gethostbyname(ptr) ) == NULL )
 {
  printf("gethostbyname error for host:%s\n", ptr);
  return 0; /* 如果调用gethostbyname发生错误，返回1 */
 }
 /* 将主机的规范名打出来 */
 printf("official hostname:%s\n",hptr->h_name);
 /* 主机可能有多个别名，将所有别名分别打出来 */
 for(pptr = hptr->h_aliases; *pptr != NULL; pptr++)
  printf("  alias:%s\n",*pptr);
 /* 根据地址类型，将地址打出来 */
 switch(hptr->h_addrtype)
 {
  case AF_INET:
  case AF_INET6:
          pptr=hptr->h_addr_list;
          /* 将刚才得到的所有地址都打出来。其中调用了inet_ntop()函数 */
          for(;*pptr!=NULL;pptr++)
                  printf("  address:%s\n", inet_ntop(hptr->h_addrtype, *pptr, str, sizeof(str)));
                  break;
  default:
            printf("unknown address type\n");
            break;
 }
 return 0;
}