ADDRINFOEX5结构 （ws2def.h）
GetAddrInfoEx 函数使用 addrinfoex4 结构，以在请求特定网络接口时保存主机地址信息。
语法
typedef struct addrinfoex5 {
int ai_flags;
int ai_family;
int ai_socktype;
int ai_protocol;
size_t ai_addrlen;
PWSTR ai_canonname;
struct sockaddr *ai_addr;
void *ai_blob;
size_t ai_bloblen;
GUID *ai_provider;
struct addrinfoex5 *ai_next;
int ai_version;
PWSTR ai_fqdn;
int ai_interfaceindex;
HANDLE ai_resolutionhandle;
unsigned int ai_ttl;
} ADDRINFOEX5, *PADDRINFOEX5, *LPADDRINFOEX5;
成员
ai_flags
指示 GetAddrInfoEx 函数中使用的选项的标志。
ai_flags 成员支持的值在 Winsock2.h 包含文件中定义，并且可以是以下选项的组合。
| 价值 | 意义 |
|---|---|
|
套接字地址将在对 绑定函数的调用中使用。 |
|
规范名称在第一个 ai_canonname 成员中返回。 |
|
传递给 GetAddrInfoEx 函数的 nodename 参数必须是数值字符串。 |
|
如果设置了此位，则会为具有 AI_V4MAPPED的 IPv6 地址和 IPv4 地址发出请求。
Windows Vista 及更高版本支持此选项。 |
|
仅当配置全局地址时，GetAddrInfoEx 才会解析。 IPv6 和 IPv4 环回地址不被视为有效的全局地址。
Windows Vista 及更高版本支持此选项。 |
|
如果 GetAddrInfoEx IPv6 地址请求失败，则会对 IPv4 地址发出名称服务请求，并且这些地址转换为 IPv4 映射的 IPv6 地址格式。
Windows Vista 及更高版本支持此选项。 |
|
地址信息来自非权威结果。
在 GetAddrInfoEx的 pHints 参数中设置此选项时，NS_EMAIL 命名空间提供程序将返回权威和非权威结果。 如果未设置此选项，则仅返回权威结果。 此选项仅在 Windows Vista 及更高版本上受 NS_EMAIL 命名空间支持。 |
|
地址信息来自安全通道。
如果设置了 AI_SECURE 位，则 NS_EMAIL 命名空间提供程序将返回通过增强的安全性获取的结果，以最大程度地减少可能的欺骗。 在 GetAddrInfoExpHints 参数中设置此选项时，NS_EMAIL 命名空间提供程序仅返回通过增强的安全性获取的结果，以最大程度地减少可能的欺骗。 此选项仅在 Windows Vista 及更高版本上受 NS_EMAIL 命名空间支持。 |
|
地址信息适用于具有特定命名空间的发布的首选名称。
在 GetAddrInfoEx的 pHints 参数中设置此选项时，pName 参数中不应提供任何名称，NS_EMAIL 命名空间提供程序将返回发布的首选名称。 此选项仅在 Windows Vista 及更高版本上受 NS_EMAIL 命名空间支持。 |
|
完全限定的域名在第一个 ai_fqdn 成员中返回。
在 GetAddrInfoEx 的 pHints 参数中设置此选项时，pName 参数中指定了平面名称（单一标签），则最终解析为该名称的完全限定域名将返回。 Windows 7、Windows Server 2008 R2 及更高版本支持此选项。 |
|
命名空间提供程序提示正在文件共享方案中使用要查询的主机名。 命名空间提供程序可能会忽略此提示。
Windows 7、Windows Server 2008 R2 及更高版本支持此选项。 |
|
在 getAddrInfoEx 函数调用的名称解析函数中使用 Punycode 禁用自动国际域名编码。
Windows 8、Windows Server 2012 及更高版本支持此选项。 |
|
指示当前对象已扩展：即 addrinfoex2 或更高版本。
Windows 8.1、Windows Server 2012 R2 及更高版本支持此选项。 |
|
解析句柄在 ai_resolutionhandle 成员中返回。
Windows 10、Windows Server 2016 及更高版本支持此选项。 |
|
DNS 记录有效的秒数。 如果存在此标志，GetAddrInfoEx。ppResult 参数将返回 addrinfoex5 结构的列表，其中 ai_ttl 成员将包含 DNS 记录的各个 TTL。 |
ai_family
地址系列。
地址系列的可能值在 Ws2def.h 头文件中定义。 请注意，Ws2def.h 头文件自动包含在 Winsock2.h中，不应直接使用。
当前支持的值是 AF_INET 或 AF_INET6，它们是 IPv4 和 IPv6 的 Internet 地址系列格式。 如果安装了地址系列的 Windows 套接字服务提供商，则支持地址系列的其他选项（例如，用于 NetBIOS 的AF_NETBIOS）。 请注意，AF_地址系列和PF_协议系列常量的值相同（例如，AF_INET 和 PF_INET），因此可以使用任一常量。
下表列出了地址系列的公共值，尽管可能有多个其他值。
ai_socktype
套接字类型。 套接字类型的可能值在 Winsock2.h include 文件中定义。
下表列出了 Windows 套接字 2 支持的套接字类型的可能值：
| 价值 | 意义 |
|---|---|
|
使用 OOB 数据传输机制提供基于连接的有序双向字节流。 将传输控制协议（TCP）用于 Internet 地址系列（AF_INET 或 AF_INET6）。 如果 ai_family 成员 AF_IRDA，则 SOCK_STREAM 是唯一受支持的套接字类型。 |
|
支持数据报，这些数据报是固定（通常较小）最大长度的无连接、不可靠的缓冲区。 将用户数据报协议（UDP）用于 Internet 地址系列（AF_INET 或 AF_INET6）。 |
|
提供一个原始套接字，允许应用程序操作下一层协议标头。 若要操作 IPv4 标头，必须在套接字上设置 IP_HDRINCL 套接字选项。 若要操作 IPv6 标头，必须在套接字上设置 IPV6_HDRINCL 套接字选项。 |
|
提供可靠的消息数据报。 此类型的一个示例是 Windows 中的实用常规多播（PGM）多播协议实现，通常称为 可靠的多播编程。 |
|
提供基于数据报的伪流数据包。 |
在 Windows 套接字 2 中，引入了新的套接字类型。 应用程序可以通过 WSAEnumProtocols 函数动态发现每个可用传输协议的属性。 因此，应用程序可以确定地址系列可能的套接字类型和协议选项，并在指定此参数时使用此信息。 Winsock2.h 和 Ws2def.h 头文件中的套接字类型定义将定期更新，因为定义了新的套接字类型、地址系列和协议。
在 Windows 套接字 1.1 中，唯一可能的套接字类型是 SOCK_DATAGRAM 和 SOCK_STREAM。
ai_protocol
协议类型。 可能的选项特定于指定的地址系列和套接字类型。 Winsock2.h 和 Wsrm.h 头文件中定义了 ai_protocol 的可能值。
在适用于 Windows Vista 及更高版本的 Windows SDK 上，头文件的组织已更改，此成员可以是 Ws2def.h 头文件中定义的 IPPROTO 枚举类型之一。 请注意，Ws2def.h 头文件自动包含在 Winsock2.h中，不应直接使用。
如果为 ai_protocol指定了 0 值，则调用方不希望指定协议，服务提供商将选择要使用的 ai_protocol。 对于 IPv4 和 IPv6 以外的协议，请将 ai_protocol 设置为零。
下表列出了 ai_protocol 成员的常见值，尽管可能有多个其他值。
如果 ai_family 成员 AF_IRDA，则 ai_protocol 必须为 0。
ai_addrlen
ai_addr 成员指向的缓冲区的长度（以字节为单位）。
ai_canonname
主机的规范名称。
ai_addr
指向 sockaddr 结构的指针。 每个返回 addrinfoex4 结构中的 ai_addr 成员指向填充的套接字地址结构。 ai_addrlen 成员中指定了每个返回 addrinfoex4 结构的长度（以字节为单位）。
ai_blob
指向用于返回与地址列表以外的名称关联的特定于提供程序的命名空间信息的数据的指针。 ai_blob 指向的缓冲区的长度（以字节为单位）必须在 ai_bloblen 成员中指定。
ai_bloblen
ai_blob 成员的长度（以字节为单位）。
ai_provider
指向特定命名空间提供程序 GUID 的指针。
ai_next
指向链接列表中的下一个结构的指针。 此参数设置为在链接列表的最后一 addrinfoex4 结构中 NULL。
ai_version
此结构的版本号。 当前用于此版本的结构的值为 4。
ai_fqdn
主机的完全限定域名。
ai_interfaceindex
接口索引，由
ai_resolutionhandle
指向主机的完全限定域名的句柄。
ai_ttl
此 DNS 记录有效的秒数。
言论
ADDRINFOEX5 结构由 GetAddrInfoExW 函数用于在通过 GetAddrInfoExW提示 参数传入的 ai_flags 成员中设置 AI_EXTENDED 或 AI_RETURN_TTL 位时保存主机地址信息。
ADDRINFOEX5 结构是 ADDRINFOEX4 结构的扩展。 除了 ADDRINFOEX4 结构中的所有字段外，它还保存在 ai_ttl 成员中，每个返回的 IP 地址的单个 DNS TTL。
如果在通过 GetAddrInfoEx提示 参数传入的 ai_flags 成员中设置 AI_RETURN_TTL 位，则 GetAddrInfoExWppResult 参数将返回 ADDRINFOEX5 结构的列表。 此列表中的每个节点将包含在 ai_ttl 成员中，sockaddr 成员中存在的 IP 地址的单个 DNS TTL。
例子
请参阅 ADDRINFOEX4 结构主题中的示例代码。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10 内部版本 20348 |
| 支持的最低服务器 | Windows 10 内部版本 20348 |
| 标头 | ws2def.h |