Edit

NET_ADDRESS_INFO structure (iphlpapi.h)

  • Article

The NET_ADDRESS_INFO structure contains IP address information returned by the ParseNetworkString function.

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

Type: NET_ADDRESS_FORMAT

The format of the network address in the union in this structure. This member is an enumeration value from the NET_ADDRESS_FORMAT enumeration declared in the Iphlpapi.h header file.

NamedAddress

A DNS named address and port.

NamedAddress.Address[DNS_MAX_NAME_BUFFER_LENGTH]

Type: WCHAR[DNS_MAX_NAME_BUFFER_LENGTH] A DNS name formatted as a NULL-terminated wide character string. The maximum length of this string is the DNS_MAX_NAME_BUFFER_LENGTH constant defined in the Windns.h header file.

NamedAddress.Port[6]

Type: WCHAR[6] The network port formatted as a NULL-terminated wide character string.

Ipv4Address

Type: SOCKADDR_IN

An IPv4 address represented as a SOCKADDR_IN structure.

Ipv6Address

Type: SOCKADDR_IN6

An IPv6 address represented as a SOCKADDR_IN6 structure.

IpAddress

Type: SOCKADDR

An IPv4 or IPv6 address represented as a SOCKADDR structure.

Remarks

The NET_ADDRESS_INFO structure is defined on Windows Vista and later.

The NET_ADDRESS_INFO structure is returned by the ParseNetworkString function.

The SOCKADDR_IN, SOCKADDR_IN6, and SOCKADDR structures are used in the NET_ADDRESS_INFO structure. The SOCKADDR_IN and SOCKADDR structures are defined in the Ws2def.h header file which is automatically included by the Winsock2.h header file. The SOCKADDR_IN6 structure is defined in the Ws2ipdef.h header file which is automatically included by the Ws2tcpip.h header file. In order to use the NET_ADDRESS_INFO structure, the Winsock2.h and Ws2tcpip.h header files must be included before the Iphlpapi.h header file.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header iphlpapi.h

See also

NET_ADDRESS_FORMAT

ParseNetworkString

SOCKADDR