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


Функция InitializeIpForwardEntry

Функция InitializeIpForwardEntry инициализирует структуру MIB_IPFORWARD_ROW2 со значениями по умолчанию для записи IP-маршрута на локальном компьютере.

Синтаксис

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Параметры

  • Строка [out]
    При входе указатель на MIB_IPFORWARD_ROW2 запись структуры для записи IP-маршрута.

    При возврате структура MIB_IPFORWARD_ROW2, на которую указывает этот параметр, инициализируется значениями по умолчанию для записи IP-маршрута.

Возвращаемое значение

None

Remarks

Драйвер должен использовать функцию InitializeIpForwardEntry для инициализации элементов записи структуры MIB_IPFORWARD_ROW2 со значениями по умолчанию для записи IP-маршрута для последующего использования с функцией CreateIpForwardEntry2 .

При входе драйвер должен передать InitializeIpForwardEntry новую структуру MIB_IPFORWARD_ROW2 для инициализации.

В выходных данных элементы структуры MIB_IPFORWARD_ROW2, на которую указывает параметр Row , инициализируются следующим образом.

  • ValidLifetime и PreferredLifetime
    Задайте бесконечное значение.

  • Замыкания на себя, автонастройкаAddress, Публикация и Бессмертный
    Задайте значение TRUE.

  • SitePrefixLength, метрика и протокол
    Задайте недопустимые значения.

  • Все остальные члены
    Задайте нулевое значение.

После вызова драйвером InitializeIpForwardEntry драйвер может изменить элементы в записи MIB_IPFORWARD_ROW2, которую он хочет изменить, а затем вызвать CreateIpForwardEntry2 , чтобы добавить новую запись IP-маршрута на локальный компьютер.

Требования

Целевая платформа

Универсальное

Версия

Доступно в Windows Vista и более поздних версиях операционных систем Windows.

Заголовок

Netioapi.h (включая Netioapi.h)

Библиотека

Netio.lib

IRQL

< DISPATCH_LEVEL

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

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2