структура NET_ADDRESS_INFO (iphlpapi.h)

Структура NET_ADDRESS_INFO содержит сведения о IP-адресе, возвращаемые функцией ParseNetworkString .

Синтаксис

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

Формат сетевого адреса в союзе в этой структуре. Этот элемент представляет собой значение перечисления из перечисления NET_ADDRESS_FORMAT , объявленного в файле заголовка Iphlpapi.h .

NamedAddress

DNS-адрес и порт.

NamedAddress.Address[DNS_MAX_NAME_BUFFER_LENGTH]

Тип: WCHAR[DNS_MAX_NAME_BUFFER_LENGTH]

DNS-имя, отформатированное в виде строки символов, завершаемой значением NULL. Максимальная длина этой строки — это константа DNS_MAX_NAME_BUFFER_LENGTH , определенная в файле заголовка Windns.h .

NamedAddress.Port[6]

Тип: WCHAR[6]

Сетевой порт, отформатированный как строка широкой символьной строки, завершаемой значением NULL.

Ipv4Address

Тип: SOCKADDR_IN

IPv4-адрес, представленный как структура SOCKADDR_IN .

Ipv6Address

Тип: SOCKADDR_IN6

IPv6-адрес, представленный как структура SOCKADDR_IN6 .

IpAddress

Тип: SOCKADDR

IPv4 или IPv6-адрес, представленный как структура SOCKADDR .

Замечания

Структура NET_ADDRESS_INFO определена в Windows Vista и более поздних версиях.

Структура NET_ADDRESS_INFO возвращается функцией ParseNetworkString .

Структуры SOCKADDR_IN, SOCKADDR_IN6 и SOCKADDR используются в структуре NET_ADDRESS_INFO . Структуры SOCKADDR_IN и SOCKADDR определяются в файле заголовка Ws2def.h , который автоматически включается в файл заголовка Winsock2.h . Структура SOCKADDR_IN6 определяется в файле заголовка Ws2ipdef.h , который автоматически включается в файл заголовка Ws2tcpip.h . Чтобы использовать структуру NET_ADDRESS_INFO , файлы заголовков Winsock2.h и Ws2tcpip.h должны быть включены перед файлом заголовка Iphlpapi.h .

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2008 [только классические приложения]
Header iphlpapi.h

См. также

NET_ADDRESS_FORMAT

ParseNetworkString

SOCKADDR