NET_ADDRESS_INFO结构(iphlpapi.h)

NET_ADDRESS_INFO结构包含 ParseNetworkString 函数返回的 IP 地址信息。

Syntax

typedef struct NET_ADDRESS_INFO_ {
  NET_ADDRESS_FORMAT Format;
  union {
    struct {
      WCHAR Address[DNS_MAX_NAME_BUFFER_LENGTH];
      WCHAR Port[6];
    } NamedAddress;
    SOCKADDR_IN  Ipv4Address;
    SOCKADDR_IN6 Ipv6Address;
    SOCKADDR     IpAddress;
  };
} NET_ADDRESS_INFO, *PNET_ADDRESS_INFO;

Members

Format

类型: NET_ADDRESS_FORMAT

此结构中联合中的网络地址的格式。 此成员是 Iphlpapi.h 头文件中声明的NET_ADDRESS_FORMAT枚举值的枚举值。

NamedAddress

DNS 命名地址和端口。

NamedAddress.Address[DNS_MAX_NAME_BUFFER_LENGTH]

类型: WCHAR[DNS_MAX_NAME_BUFFER_LENGTH]

格式化为 以 NULL 结尾的宽字符字符串的 DNS 名称。 此字符串的最大长度是在 Windns.h 头文件中定义的DNS_MAX_NAME_BUFFER_LENGTH常量。

NamedAddress.Port[6]

类型: WCHAR[6]

格式为 NULL 终止宽字符串的网络端口。

Ipv4Address

类型: SOCKADDR_IN

表示为 SOCKADDR_IN 结构的 IPv4 地址。

Ipv6Address

类型: SOCKADDR_IN6

表示为 SOCKADDR_IN6 结构的 IPv6 地址。

IpAddress

类型: SOCKADDR

表示为 SOCKADDR 结构的 IPv4 或 IPv6 地址。

注解

NET_ADDRESS_INFO结构在 Windows Vista 及更高版本上定义。

NET_ADDRESS_INFO结构由 ParseNetworkString 函数返回。

SOCKADDR_IN、SOCKADDR_IN6和 SOCKADDR 结构用于NET_ADDRESS_INFO结构。 SOCKADDR_IN和 SOCKADDR 结构在 Winsock2.h 头文件自动包含的 Ws2def.h 头文件中定义。 SOCKADDR_IN6结构在 Ws2ipdef.h 头文件中定义, Ws2tcpip.h 头文件自动包含该文件。 若要使用NET_ADDRESS_INFO结构,必须在 Iphlpapi.h 头文件之前包含 Winsock2.hWs2tcpip.h 头文件。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
Header iphlpapi.h

另请参阅

NET_ADDRESS_FORMAT

ParseNetworkString

SOCKADDR