gethostbyname()返回对应于给定主机名的包含主机名字和地址信息的hostent结构指针。结构的声明与gethostaddr()中一致。 返回对应于给定主机名的主机信息。 #include <winsock2.h> struct hostent FAR *PASCAL FAR gethostbyname(const char FAR * name); name:指向主机名的指针。 Linux版 #include <netdb.h> struct hostent *gethostbyname(const char * hostname); 返回:非空指针——成功,空指针——出错,同时设置h_errno 注释 gethostbyname()返回对应于给定主机名的包含主机名字和地址信息的hostent结构指针。结构的声明与gethostaddr()中一致。 返回的指针指向一个由Windows Sockets实现分配的结构。应用程序不应该试图修改这个结构或者释放它的任何部分。此外,每一线程仅有一份这个结构的拷贝,所以应用程序应该在发出其他Windows Scokets API调用前,把自己所需的信息拷贝下来。 gethostbyname()实现没有必要识别传送给它的IP地址串。对于这样的请求,应该把IP地址串当作一个未知主机名同样处理。如果应用程序有IP地址串需要处理,它应该使用inet_addr()函数把地址串转换为IP地址,然后调用gethostbyaddr()来得到hostent结构。 返回值 如果没有错误发生,gethostbyname()返回如上所述的一个指向hostent结构的指针,否则,返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。 错误代码 WSANOTINITIALISED 在应用这个API前,必须成功地调用WSAStartup()。 WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。 WSAHOST_NOT_FOUND 没有找到授权应答主机。 WSATRY_AGAIN 没有找到非授权主机,或者SERVERFAIL。 WSANO_RECOVERY 无法恢复的错误,FORMERR,REFUSED,NOTIMP。 WSANO_DATA 有效的名字,但没有关于请求类型的数据记录。 WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。 WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了. 需要注意的是gethostbyname()函数属于WinSock API库,而在使用WinSock API之前,必须调用WSA-Startup函数,只有该函数成功返回(表示应用程序与WinSock库成功地建立起连接),应用程序才可以调用其他Windows Sockets DLL中的函数。当程序将要结束时,又必须调用WSACleanup 函数进行清理工作,以便释放其占用的资源。WSACleanup 函数用来结束Windows Sockets DLL的使用。 参见: WSAAsyncGetHostByName(), gethostbyaddr() ############################################################## http://hi.baidu.com/zengzhaonong/blog/item/162213f4c18d6cec7609d7c1.html gethostbyname() -- 用域名或主机名获取IP地址 #include <netdb.h> #include <sys/socket.h> struct hostent *gethostbyname(const char *name); 这个函数的传入值是域名或者主机名,例如"www.google.cn"等等。传出值,是一个hostent的结构。如果函数调用失败,将返回NULL。 struct hostent { char *h_name; /* official domain name of host */ char **h_aliases; /* null-terminated array of domain names */ int h_addrtype; /* host address type(AF_INET)*/ int h_length; /* length of an address, in bytes */ char **h_addr_list; /* null -terminated array of in_addr structs */ #define h_addr h_addr_list[0] }; hostent->h_name 表示的是主机的规范名。例如www.google.com的规范名其实是www.l.google.com。 hostent->h_aliases 表示的是主机的别名.www.google.com就是google他自己的别名。有的时候,有的主机可能有好几个别名,这些,其实都是为了易于用户记忆而为自己的网站多取的名字。 hostent->h_addrtype 表示的是主机ip地址的类型,到底是ipv4(AF_INET),还是pv6(AF_INET6) hostent->h_length 表示的是主机ip地址的长度 hostent->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 <netdb.h> #include <sys/socket.h> #include <stdio.h> 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 ", ptr); return 0; } /* 将主机的规范名打出来 */ printf("official hostname:%s ",hptr->h_name); /* 主机可能有多个别名,将所有别名分别打出来 */ for(pptr = hptr->h_aliases; *pptr != NULL; pptr++) printf(" alias:%s ",*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 ", inet_ntop(hptr->h_addrtype, *pptr, str, sizeof(str))); printf(" first address: %s ", inet_ntop(hptr->h_addrtype, hptr->h_addr, str, sizeof(str))); break; default: printf("unknown address type "); break; } return 0; } 编译运行 ----------------------------- # gcc test.c # ./a.out www.baidu.com official hostname:www.a.shifen.com alias:www.baidu.com address:121.14.88.11 address:121.14.89.11 first address: 121.14.88.11