структура MIB_IPFORWARD_ROW2
В структуре MIB_IPFORWARD_ROW2 хранятся сведения о записи IP-маршрута.
Синтаксис
typedef struct _MIB_IPFORWARD_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
IP_ADDRESS_PREFIX DestinationPrefix;
SOCKADDR_INET NextHop;
UCHAR SitePrefixLength;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG Metric;
NL_ROUTE_PROTOCOL Protocol;
BOOLEAN Loopback;
BOOLEAN AutoconfigureAddress;
BOOLEAN Publish;
BOOLEAN Immortal;
ULONG Age;
NL_ROUTE_ORIGIN Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;
Члены
InterfaceLuid
Локальный уникальный идентификатор (LUID) для сетевого интерфейса, связанного с этой записью IP-маршрута.InterfaceIndex
Значение локального индекса для сетевого интерфейса, связанного с этой записью IP-маршрута. Это значение индекса может изменяться, когда сетевой адаптер отключен, а затем включен или при других обстоятельствах и не должен считаться постоянным.DestinationPrefix
Префикс IP-адреса назначения для этого маршрута.NextHop
Для удаленного маршрута — IP-адрес следующей системы или шлюза, который находится вдоль маршрута. Если маршрут направлен на локальный адрес замыкания на себя или IP-адрес по локальной ссылке, следующий прыжок не указан (все нули). Для локального маршрута замыкания на себя этот элемент должен быть IPv4-адресом 0.0.0.0 для записи маршрута IPv4 или адресом IPv6 0::0. для записи маршрута IPv6.SitePrefixLength
Длина (в битах) префикса сайта или сетевой части IP-адреса для этого маршрута. Для записи маршрута IPv4 любое значение, превышающее 32, является недопустимым. Для записи маршрута IPv6 любое значение, превышающее 128, является недопустимым. Значение 255 обычно используется для представления недопустимого значения.ValidLifetime
Максимальное время (в секундах) допустимости записи IP-маршрута. Значение 0xffffffff считается бесконечным.PreferredLifetime
Предпочтительное время (в секундах) для допустимой записи IP-маршрута. Значение 0xffffffff считается бесконечным.Метрика
Значение смещения метрики маршрута для этой записи IP-маршрута. Обратите внимание, что фактическая метрика маршрута, используемая для вычисления предпочтительного маршрута, — это метрика интерфейса, указанная в элементе Metricструктуры MIB_IPINTERFACE_ROW , добавленной в смещение метрики маршрута, указанное в этом элементе Метрики . Семантика этой метрики определяется протоколом маршрутизации, указанным в элементе протокола . Если эта метрика не используется, ее значение должно быть равно -1. Это значение задокументировано в документе RFC 4292. Дополнительные сведения см. в разделе MIB таблицы IP-пересылки.протокол;
Тип механизма маршрутизации NL_ROUTE_PROTOCOL , с которым был добавлен этот IP-маршрут.Замыкания
Значение типа , указывающее, является ли маршрут маршрутом замыкания на себя (шлюз находится на локальном узле).Автоматическая настройкаAddress
Значение типа , указывающее, настроен ли IP-адрес автоматически.Опубликовать
Значение типа , указывающее, публикуется ли маршрут.Бессмертным
Значение типа , указывающее, является ли маршрут бессмертным.Age
Количество секунд с момента добавления или изменения маршрута в таблице сетевой маршрутизации.Исходный домен
Тип источника IP-маршрута NL_ROUTE_ORIGIN .
Комментарии
Функция GetIpForwardTable2 перечисляет записи IP-маршрутов на локальном компьютере и возвращает эти сведения в MIB_IPFORWARD_TABLE2 структуре в виде массива MIB_IPFORWARD_ROW2 записей.
Функция GetIpForwardEntry2 извлекает одну запись IP-маршрута и возвращает эти сведения в MIB_IPFORWARD_ROW2 структуре.
Запись с элементами Prefix и PrefixLengthIP_ADDRESS_PREFIX в элементе DestinationPrefix в структуре MIB_IPFORWARD_ROW2 считается маршрутом по умолчанию. MIB_IPFORWARD_TABLE2 может содержать несколько записей MIB_IPFORWARD_ROW2 с элементами Prefix и PrefixLength IP_ADDRESS_PREFIX равным нулю в элементе DestinationPrefix при наличии нескольких установленных сетевых адаптеров.
Элемент Метрики записи MIB_IPFORWARD_ROW2 — это значение, присваиваемое IP-маршруту для определенного сетевого интерфейса, которое определяет затраты, связанные с использованием этого маршрута. Например, метрика может быть оценена с точки зрения скорости связи, количества прыжков или задержки времени. Автоматическая метрика — это функция в Windows XP и более поздних версиях операционных систем Windows, которая автоматически настраивает метрику для локальных маршрутов, основанных на скорости канала. По умолчанию функция автоматической метрики включена (элемент UseAutomaticMetric структуры MIB_IPINTERFACE_ROW имеет значение TRUE) в Windows XP и более поздних версиях. Вы также можете вручную настроить эту функцию для назначения определенной метрики IP-маршруту.
Метрика маршрута, указанная в элементе Metric структуры MIB_IPFORWARD_ROW2, представляет только смещение метрики маршрута. Полная метрика представляет собой комбинацию смещения этой метрики маршрута, добавляемой в метрику интерфейса, указанную в элементе Metricструктуры MIB_IPINTERFACE_ROW связанного интерфейса. Драйвер может получить метрику интерфейса, вызвав функцию GetIpInterfaceEntry .
Требования
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (включая Netioapi.h) |