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;
} ADDRINFOA, *PADDRINFOA;
ai_addrlen: 指向的缓冲区的长度(以字节为单位)。
ai_canonname: 主机的规范名称。
ai_addr: 指向 sockaddr 结构的指针。每个返回的addrinfo结构中的ai_addr成员指向一个填充的套接字地址结构。
每个返回的addrinfo结构的长度(以字节为单位)在ai_addrlen成员中指定。
struct sockaddr { ushort sa_family; char sa_data[14]; }; |
struct sockaddr_in { short sin_family; //指代协议族,在socket编程中只能是 AF_INET u_short sin_port; //存储端口号(使用网络字节顺序) struct in_addr sin_addr; //存储IP地址,使用in_addr这个数据结构 char sin_zero[8];//为了让sockaddr与sockaddr_in两个数据结构保持大小相同而保留的空字节。 }; |
ai_next: 指向链表中下一个结构的指针。此参数在链接列表的最后一个addrinfo结构中设置为NULL。
ai_flags: 指示在getaddrinfo函数中使用的选项的标志。
Value | Meaning |
AI_PASSIVE | 套接字地址将用于调用bind 函数 |
AI_CANONNAME | 返回规范名称 |
AI_NUMERICHOST | 传递给getaddrinfo函数的nodename参数必须是数字字符串。 |
AI_ALL | If this bit is set, a request is made for IPv6 addresses and IPv4 addresses with AI_V4MAPPED. |
AI_ADDRCONFIG | 只有配置了全局地址后,getaddrinfo才会解析。 IPv6和IPv4环回地址不被认为是有效的全局地址。 |
AI_V4MAPPED | 如果对IPv6地址的getaddrinfo请求失败,则对IPv4地址进行名称服务请求,这些地址将转换为IPv4映射IPv6地址格式。 |
AI_NON_AUTHORITATIVE | 地址信息可以来自非授权命名空间提供商 |
AI_SECURE | 地址信息来自安全信道。 |
AI_RETURN_PREFERRED_NAMES | 地址信息是用于用户的优选名称。 |
AI_FQDN |
getaddrinfo将返回名称最终解析为的完全限定域名。 完全限定域名在ai_canonname成员中返回。 这与AI_CANONNAME位标记不同,后者返回在DNS中注册的规范名称,该名称可能与平面名称解析为的完全限定域名不同。 只能设置AI_FQDN和AI_CANONNAME位中的一个。 如果EAI_BADFLAGS同时存在这两个标志,getaddrinfo函数将失败。 |
AI_FILESERVER | 命名空间提供程序提示正在查询的主机名正在文件共享方案中使用。 命名空间提供程序可以忽略此提示。 |
ai_family: The address family.
AF_UNSPEC | 地址系列未指定。 |
AF_INET | IPv4 address family. |
AF_NETBIOS | NetBIOS地址系列。 |
AF_INET6 | IPv6 address family. |
AF_IRDA | The Infrared Data Association address family. |
AF_BTH | Bluetooth address family. |
ai_protocol: 协议类型。
Value | Meaning |
IPPROTO_TCP | 传输控制协议(TCP)。 当ai_family成员为AF_INET或AF_INET6且ai_socktype成员为SOCK_STREAM时,这是一个可能的值 |
IPPROTO_UDP | 用户数据报协议(UDP)。 当ai_family成员为AF_INET或AF_INET6且类型参数为SOCK_DGRAM时,这是一个可能的值。 |
IPPROTO_RM | PGM协议用于可靠的组播。 当ai_family成员为AF_INET且ai_socktype成员为SOCK_RDM时,这是一个可能的值。 在为Windows Vista及更高版本发布的Windows SDK上,此值也称为IPPROTO_PGM。 |
可能的选项特定于指定的地址系列和套接字类型。
如果为ai_protocol指定了值0,则调用者不希望指定协议,服务提供者将选择要使用的ai_protocol。 对于IPv4和IPv6之外的协议,将ai_protocol设置为零。
下表列出了ai_protocol成员的通用值,尽管其他许多值也是可能的。
ai_socktype: 套接字类型
Value | Meaning |
SOCK_STREAM | 使用OOB数据传输机制提供顺序,可靠,双向,基于连接的字节流。使用Internet地址系列(AF_INET或AF_INET6)的传输控制协议(TCP)。如果ai_family成员是AF_IRDA,则SOCK_STREAM是唯一支持的套接字类型。 |
SOCK_DGRAM | 支持数据报,它是无连接的,不可靠的固定(通常小)最大长度的缓冲区。对Internet地址系列(AF_INET或AF_INET6)使用用户数据报协议(UDP)。 |
SOCK_RAW | 提供一个原始套接字,允许应用程序处理下一个上层协议头。要操作IPv4标头,必须在套接字上设置IP_HDRINCL套接字选项。要操作IPv6头,必须在套接字上设置IPV6_HDRINCL套接字选项。 |
SOCK_RDM | 提供可靠的消息数据报。这种类型的示例是在Windows中的实用通用多播(PGM)多播协议实现,通常被称为可靠多播节目。 |
SOCK_SEQPACKET | 基于数据报提供伪流包。 |