Поделиться через

структура IP_INTERFACE_NAME_INFO_W2KSP1 (iptypes.h)

  • Статья

Структура IP_INTERFACE_NAME_INFO содержит сведения об интерфейсе IPv4 на локальном компьютере.

Синтаксис

typedef struct ip_interface_name_info_w2ksp1 {
  ULONG Index;
  ULONG MediaType;
  UCHAR ConnectionType;
  UCHAR AccessType;
  GUID  DeviceGuid;
  GUID  InterfaceGuid;
} IP_INTERFACE_NAME_INFO_W2KSP1, *PIP_INTERFACE_NAME_INFO_W2KSP1;

Члены

Index

Тип: ULONG

Индекс IP-интерфейса для активного экземпляра.

MediaType

Тип: ULONG

Тип интерфейса, определенный центром имен, назначенных Через Интернет (IANA). Возможные значения для типа интерфейса перечислены в файле заголовка Ipifcons.h.

В таблице ниже перечислены общие значения для типа интерфейса; хотя возможны и многие другие значения.

Значение Значение
IF_TYPE_OTHER
1
 Другой тип сетевого интерфейса.
IF_TYPE_ETHERNET_CSMACD
6
 Сетевой интерфейс Ethernet.
IF_TYPE_ISO88025_TOKENRING
9
 Сетевой интерфейс круга маркеров.
IF_TYPE_PPP
23
 Сетевой интерфейс PPP.
IF_TYPE_SOFTWARE_LOOPBACK
24
 Программный сетевой интерфейс замыкания на себя.
IF_TYPE_ATM
37
 Сетевой интерфейс ATM.
IF_TYPE_IEEE80211
71
 Беспроводной сетевой интерфейс IEEE 802.11. В Windows Vista и более поздних версиях беспроводные сетевые карты отображаются как IF_TYPE_IEEE80211.

Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) и Windows XP/2000: Беспроводные сетевые карты отображаются как IF_TYPE_ETHERNET_CSMACD.
IF_TYPE_TUNNEL
131
 Сетевой интерфейс инкапсуляции типа туннеля.
IF_TYPE_IEEE1394
144
 Высокопроизводительный сетевой интерфейс последовательной шины IEEE 1394 (Firewire).

ConnectionType

Тип: UCHAR

Тип подключения интерфейса для адаптера.

Возможные значения для этого элемента определяются в файле заголовка Ipifcons.h.

Значение Значение
IF_CONNECTION_DEDICATED
1
 Тип подключения выделен. Подключение появляется автоматически, если значение медиасреды имеет значение TRUE. Например, подключение Ethernet выделено.
IF_CONNECTION_PASSIVE
2
 Тип подключения пассивный. Удаленный конец должен установить подключение к локальной станции. Например, интерфейс RAS является пассивным.
IF_CONNECTION_DEMAND
3
 Тип подключения — demand-dial. Подключение этого типа возникает в ответ на локальное действие (например, отправка пакета).

AccessType

Тип: UCHAR

Значение перечисления IF_ACCESS_TYPE , указывающее тип доступа для интерфейса.

Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) и Windows XP/2000: Возможные значения для этого элемента определяются в файле заголовка Ipifcons.h.

Значение Значение
IF_ACCESS_LOOPBACK
1
 Тип доступа замыкания на себя. Это значение указывает, что интерфейс циклически передает данные в качестве получаемых данных.
IF_ACCESS_BROADCAST
2
 Тип доступа по локальной сети, включающий Ethernet. Это значение указывает, что интерфейс обеспечивает встроенную поддержку служб многоадресной или широковещательной рассылки.
IF_ACCESS_POINT_TO_POINT
3
 Тип доступа "точка — точка". Это значение указывает на поддержку CoNDIS/WAN, за исключением интерфейсов NBMA, не являющихся широковещательными.

Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) и Windows XP/2000: Это значение определено как IF_ACCESS_POINTTOPOINT в файле заголовка Ipifcons.h.
IF_ACCESS_POINT_TO_MULTI_POINT
4
 Тип доступа с точками к нескольким точкам. Это значение указывает на поддержку не широковещательных носителей с множественным доступом, включая внутренний интерфейс RAS и собственный банкомат.

Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) и Windows XP/2000: Это значение определено как IF_ACCESS_POINTTOMULTIPOINT в файле заголовка Ipifcons.h.

DeviceGuid

Тип: GUID

GUID, определяющий базовое устройство для интерфейса. Этот элемент может быть нулевым ИДЕНТИФИКАТОРом GUID.

InterfaceGuid

Тип: GUID

ИДЕНТИФИКАТОР GUID, который идентифицирует интерфейс, сопоставленный с устройством. Необязательный элемент. Этот элемент может быть нулевым ИДЕНТИФИКАТОРом GUID.

Комментарии

В microsoft пакет средств разработки программного обеспечения для Windows (SDK) версия структуры для использования в Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий определяется как IP_INTERFACE_NAME_INFO_W2KSP1. При компиляции приложения, если целевой платформой является Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500или WINVER >= 0x0500), структура IP_INTERFACE_NAME_INFO_W2KSP1 определяется в IP_INTERFACE_NAME_INFO структуре.

Элементы, определения и назначенные значения MediaType, ConnectionType и AccessType доступны в файле заголовка Ipifcons.h.

Необязательный член InterfaceGuid часто устанавливается для интерфейсов коммутируемого доступа и может использоваться для различения нескольких интерфейсов коммутируемого подключения, использующих один и тот же GUID устройства.

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 1 (SP1) [только классические приложения]
Верхняя часть iptypes.h (включая Iphlpapi.h)

См. также раздел

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack