Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Структура MIB_IF_ROW2 хранит сведения о конкретном интерфейсе.
Синтаксис
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface : 1;
BOOLEAN FilterInterface : 1;
BOOLEAN ConnectorPresent : 1;
BOOLEAN NotAuthenticated : 1;
BOOLEAN NotMediaConnected : 1;
BOOLEAN Paused : 1;
BOOLEAN LowPower : 1;
BOOLEAN EndPointInterface : 1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Members
InterfaceLuid
Тип: NET_LUID
Локальный уникальный идентификатор (LUID) для сетевого интерфейса.
InterfaceIndex
Тип: NET_IFINDEX
Индекс, определяющий сетевой интерфейс. Это значение индекса может измениться, если сетевой адаптер отключен, а затем включен и не должен считаться постоянным.
InterfaceGuid
Тип: GUID
GUID сетевого интерфейса.
Alias[IF_MAX_STRING_SIZE + 1]
Тип: WCHAR[IF_MAX_STRING_SIZE + 1]
Строка Юникода с завершением NULL, содержащая псевдоним сетевого интерфейса.
Description[IF_MAX_STRING_SIZE + 1]
Тип: WCHAR[IF_MAX_STRING_SIZE + 1]
Строка Юникода с завершением NULL, содержащая описание сетевого интерфейса.
PhysicalAddressLength
Тип: ULONG
Длина в байтах физического аппаратного адреса, указанного членом PhysicalAddress .
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Тип: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Физический аппаратный адрес адаптера для этого сетевого интерфейса.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Тип: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Постоянный физический аппаратный адрес адаптера для этого сетевого интерфейса.
Mtu
Тип: ULONG
Максимальный размер единицы передачи (MTU) в байтах для этого сетевого интерфейса.
Type
Тип: IFTYPE
Тип интерфейса, определенный центром назначенных Интернетом имен (IANA). Дополнительные сведения см. в разделе http://www.iana.org/assignments/ianaiftype-mib. Возможные значения для типа интерфейса перечислены в файле заголовка Ipifcons.h .
В таблице ниже перечислены распространенные значения для типа интерфейса, хотя возможны многие другие значения.
TunnelType
Тип: TUNNEL_TYPE
Метод инкапсуляции, используемый туннелем, если элемент TypeIF_TYPE_TUNNEL. Тип туннеля определяется центром назначения имен Интернета (IANA). Дополнительные сведения см. в разделе http://www.iana.org/assignments/ianaiftype-mib. Этот элемент может быть одним из значений из типа перечисления TUNNEL_TYPE , определенного в файле заголовка Ifdef.h .
MediaType
Тип: NDIS_MEDIUM
Тип носителя NDIS для интерфейса. Этот элемент может быть одним из значений из типа перечисления NDIS_MEDIUM , определенного в файле заголовка Ntddndis.h .
PhysicalMediumType
Тип: NDIS_PHYSICAL_MEDIUM
Физический средний тип NDIS. Этот элемент может быть одним из значений из типа перечисления NDIS_PHYSICAL_MEDIUM , определенного в файле заголовка Ntddndis.h .
AccessType
Тип: NET_IF_ACCESS_TYPE
Тип доступа к интерфейсу. Этот элемент может быть одним из значений из типа перечисления NET_IF_ACCESS_TYPE , определенного в файле заголовка Ifdef.h .
DirectionType
Тип: NET_IF_DIRECTION_TYPE
Тип направления интерфейса. Этот элемент может быть одним из значений из типа перечисления NET_IF_DIRECTION_TYPE , определенного в файле заголовка Ifdef.h .
InterfaceAndOperStatusFlags
Набор флагов, предоставляющих сведения об интерфейсе. Эти флаги объединяются с побитовой операцией OR. Если ни один из флагов не применяется, этот элемент имеет значение нулю.
InterfaceAndOperStatusFlags.HardwareInterface
Тип: BOOLEAN
Задайте, если сетевой интерфейс предназначен для оборудования.
InterfaceAndOperStatusFlags.FilterInterface
Тип: BOOLEAN
Задайте, если сетевой интерфейс предназначен для модуля фильтра.
InterfaceAndOperStatusFlags.ConnectorPresent
Тип: BOOLEAN
Если соединитель присутствует в сетевом интерфейсе. Это значение задается, если существует физический сетевой адаптер.
InterfaceAndOperStatusFlags.NotAuthenticated
Тип: BOOLEAN
Задайте, если порт по умолчанию для сетевого интерфейса не прошел проверку подлинности. Если сетевой интерфейс не проходит проверку подлинности целевого объекта, сетевой интерфейс не находится в рабочем режиме. Хотя это относится как к проводным, так и к беспроводным сетевым подключениям, проверка подлинности более распространена для беспроводных сетевых подключений.
InterfaceAndOperStatusFlags.NotMediaConnected
Тип: BOOLEAN
Установите, если сетевой интерфейс не находится в состоянии, подключенном к мультимедиа. Если сетевой кабель отключен для проводной сети, это будет установлено. Для беспроводной сети это значение устанавливается для сетевого адаптера, который не подключен к сети.
InterfaceAndOperStatusFlags.Paused
Тип: BOOLEAN
Задайте, если сетевой стек для сетевого интерфейса находится в приостановленном или приостановленном состоянии. Это не означает, что компьютер находится в состоянии гибернации.
InterfaceAndOperStatusFlags.LowPower
Тип: BOOLEAN
Задайте, если сетевой интерфейс находится в состоянии низкой мощности.
InterfaceAndOperStatusFlags.EndPointInterface
Тип: BOOLEAN
Задайте, если сетевой интерфейс является конечным устройством, а не истинным сетевым интерфейсом, который подключается к сети. Это можно задать устройствами, такими как смарт-телефоны, которые используют сетевую инфраструктуру для обмена данными с компьютером, но не обеспечивают подключение к внешней сети. Для этих типов устройств необходимо задать этот флаг.
OperStatus
Тип: IF_OPER_STATUS
Рабочее состояние интерфейса, определенное в RFC 2863 как IfOperStatus. Дополнительные сведения см. в разделе http://www.ietf.org/rfc/rfc2863.txt. Этот элемент может быть одним из значений из типа перечисления IF_OPER_STATUS , определенного в файле заголовка Ifdef.h .
AdminStatus
Тип: NET_IF_ADMIN_STATUS
Административное состояние интерфейса, определенное в RFC 2863. Дополнительные сведения см. в разделе http://www.ietf.org/rfc/rfc2863.txt. Этот элемент может быть одним из значений из типа перечисления NET_IF_ADMIN_STATUS , определенного в файле заголовка Ifdef.h .
MediaConnectState
Тип: NET_IF_MEDIA_CONNECT_STATE
Состояние подключения интерфейса. Этот элемент может быть одним из значений из типа перечисления NET_IF_MEDIA_CONNECT_STATE , определенного в файле заголовка Ifdef.h .
NetworkGuid
Тип: NET_IF_NETWORK_GUID
GUID, связанный с сетью, к которой принадлежит интерфейс.
ConnectionType
Тип: NET_IF_CONNECTION_TYPE
Тип подключения сетевого интерфейса NDIS. Этот элемент может быть одним из значений из типа перечисления NET_IF_CONNECTION_TYPE , определенного в файле заголовка Ifdef.h .
TransmitLinkSpeed
Тип: ULONG64
Скорость в битах в секунду канала передачи.
ReceiveLinkSpeed
Тип: ULONG64
Скорость в битах в секунду от канала получения.
InOctets
Тип: ULONG64
Количество октетов данных, полученных без ошибок через этот интерфейс. Это значение включает в себя октеты в одноадресных, широковещательных и многоадресных пакетах.
InUcastPkts
Тип: ULONG64
Количество одноадресных пакетов, полученных без ошибок через этот интерфейс.
InNUcastPkts
Тип: ULONG64
Количество неадресных пакетов, полученных без ошибок через этот интерфейс. Это значение включает широковещательные и многоадресные пакеты.
InDiscards
Тип: ULONG64
Количество входящих пакетов, которые были выбраны для отмены, даже если ошибки не обнаружены, чтобы предотвратить доставку пакетов в протокол более высокого уровня.
InErrors
Тип: ULONG64
Количество входящих пакетов, которые были отменены из-за ошибок.
InUnknownProtos
Тип: ULONG64
Количество входящих пакетов, которые были отменены, так как протокол был неизвестен.
InUcastOctets
Тип: ULONG64
Количество октетов данных, полученных без ошибок в одноадресных пакетах через этот интерфейс.
InMulticastOctets
Тип: ULONG64
Количество октетов данных, полученных без ошибок в пакетах многоадресной рассылки через этот интерфейс.
InBroadcastOctets
Тип: ULONG64
Количество октетов данных, полученных без ошибок в широковещательных пакетах через этот интерфейс.
OutOctets
Тип: ULONG64
Количество октетов данных, передаваемых без ошибок через этот интерфейс. Это значение включает в себя октеты в одноадресных, широковещательных и многоадресных пакетах.
OutUcastPkts
Тип: ULONG64
Количество одноадресных пакетов, передаваемых без ошибок через этот интерфейс.
OutNUcastPkts
Тип: ULONG64
Количество неадресных пакетов, передаваемых без ошибок через этот интерфейс. Это значение включает широковещательные и многоадресные пакеты.
OutDiscards
Тип: ULONG64
Количество исходящих пакетов, которые были отменены, даже если они не имели ошибок.
OutErrors
Тип: ULONG64
Количество исходящих пакетов, которые были удалены из-за ошибок.
OutUcastOctets
Тип: ULONG64
Количество октетов данных, передаваемых без ошибок в одноадресных пакетах через этот интерфейс.
OutMulticastOctets
Тип: ULONG64
Количество октетов данных, передаваемых без ошибок в пакетах многоадресной рассылки через этот интерфейс.
OutBroadcastOctets
Тип: ULONG64
Количество октетов данных, передаваемых без ошибок в широковещательных пакетах через этот интерфейс.
OutQLen
Тип: ULONG64
Длина очереди передачи. Это поле сейчас не используется.
Замечания
Структура MIB_IF_ROW2 определена в Windows Vista и более поздних версиях.
Значения поля Type определяются в файле заголовка Ipifcons.h . В настоящее время поддерживаются только возможные значения, перечисленные в описании элемента Type .
Обратите внимание, что файл заголовка Netioapi.h автоматически включается в файл заголовка Iphlpapi.h . Файл заголовка Netioapi.h никогда не следует использовать напрямую.
Требования
| Требование | Ценность |
|---|---|
| Минимальный поддерживаемый клиент | Windows Vista [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2008 [только классические приложения] |
| Header | netioapi.h (include Iphlpapi.h) |