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\n", ptr); return 0; } /* 將主機的規范名打出來 */ 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))); printf(" first address: %s\n", inet_ntop(hptr->h_addrtype, hptr->h_addr, str, sizeof(str))); break; default: printf("unknown address type\n"); 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