getaddrinfo函数原型2007-05-28 12:15
1．getaddrinfo函数原型
| 函数 | 参数说明 | | int getaddrinfo(const char* nodenameconst char* servname,const struct addrinfo* hints,//struct addrinfo** res); | nodename:节点名可以是主机名，也可以是数字地址。（IPV4的10进点分，或是IPV6的16进制）servname:包含十进制数的端口号或服务名如（ftp,http）hints:是一个空指针或指向一个addrinfo结构的指针，由调用者填写关于它所想返回的信息类型的线索。res:存放返回addrinfo结构链表的指针 |
Getaddrinfo提供独立于协议的名称解析。函数的前两个参数分别是节点名和服务名。节点名可以是主机名，也可以是地址串(IPv4的点分十进制数表示或IPv6的十六进制数字串)。服务名可以是十进制的端口号，也可以是已定义的服务名称，如ftp、http等。注意：其中节点名和服务名都是可选项，即节点名或服务名可以为NULL，此时调用的结果将取缺省设置，后面将详细讨论。函数的第三个参数hints是addrinfo结构的指针，由调用者填写关于它所想返回的信息类型的线索。函数的返回值是一个指向addrinfo结构的链表指针res。2．addrinfo结构| 结构 | 固定的参数 | | typedef struct addrinfo { int ai_flags; int ai_family; int ai_socktype; int ai_protocol; size_t ai_addrlen; char* ai_canonname; struct sockaddr* ai_addr; struct addrinfo* ai_next;} | ai_addrlen must be zero or a null pointer ai_canonname must be zero or a null pointer ai_addr must be zero or a null pointer ai_next must be zero or a null pointer | | 可以改动的参数 | | ai_flags:AI_PASSIVE,AI_CANONNAME,AI_NUMERICHOSTai_family: AF_INET,AF_INET6ai_socktype:SOCK_STREAM,SOCK_DGRAMai_protocol:IPPROTO_IP, IPPROTO_IPV4, IPPROTO_IPV6 etc. |
3 参数说明在getaddrinfo函数之前通常需要对以下6个参数进行以下设置：nodename、servname、hints的ai_flags、ai_family、ai_socktype、ai_protocol在6项参数中，对函数影响最大的是nodename，sername和hints.ai_flag而ai_family只是有地址为v4地址或v6地址的区别。而ai_protocol一般是为0不作改动。其中ai_flags、ai_family、ai_socktype说明如下：| 参数 | 取值 | 值 | 说明 | | ai_family | AF_INET | 2 | IPv4 | | AF_INET6 | 23 | IPv6 | | AF_UNSPEC | 0 | 协议无关 | | ai_protocol | IPPROTO_IP | 0 | IP协议 | | IPPROTO_IPV4 | 4 | IPv4 | | IPPROTO_IPV6 | 41 | IPv6 | | IPPROTO_UDP | 17 | UDP | | IPPROTO_TCP | 6 | TCP | | ai_socktype | SOCK_STREAM | 1 | 流 | | SOCK_DGRAM | 2 | 数据报 | | ai_flags | AI_PASSIVE | 1 | 被动的，用于bind，通常用于server socket | | AI_CANONNAME | 2 | | | AI_NUMERICHOST | 4 | 地址为数字串 |
对于ai_flags值的说明：| AI_NUMERICHOST | AI_CANONNAME | AI_PASSIVE | | 0/1 | 0/1 | 0/1 |
如上表所示，ai_flagsde值范围为0~7，取决于程序如何设置3个标志位，比如设置ai_flags为 “AI_PASSIVE|AI_CANONNAME”，ai_flags值就为3。三个参数的含义分别为：(1)AI_PASSIVE当此标志置位时，表示调用者将在bind()函数调用中使用返回的地址结构。当此标志不置位时，表示将在connect()函数调用中使用。当节点名位NULL，且此标志置位，则返回的地址将是通配地址。如果节点名NULL，且此标志不置位，则返回的地址将是回环地址。(2)AI_CANNONAME当此标志置位时，在函数所返回的第一个addrinfo结构中的ai_cannoname成员中，应该包含一个以空字符结尾的字符串，字符串的内容是节点名的正规名。(3)AI_NUMERICHOST当此标志置位时，此标志表示调用中的节点名必须是一个数字地址字符串。 |
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理
