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


Функция InitializeIpForwardEntry

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

Синтаксис

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Параметры

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

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

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

Никакой

Замечания

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

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

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

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

  • AutoconfigureAddress, Publishи Immortal
    Установите значение TRUE.

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

  • Все остальные члены
    Установите значение нулю.

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

Требования

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

универсальные

Версия

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

Заголовок

Netioapi.h (include Netioapi.h)

Библиотека

Netio.lib

IRQL

< DISPATCH_LEVEL

См. также

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2