Функция InitializeIpForwardEntry (netioapi.h)

Статья
08/25/2023

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

Синтаксис

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

Параметры

[out] Row

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

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

Эта функция не возвращает значение.

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

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

В выходных данных элементы ValidLifetime и PreferredLifetimeструктуры MIB_IPFORWARD_ROW2 , на которую указывает параметр Row , будут инициализированы как бесконечные, а элементы Loopback, AutoconfigureAddress, Publish и Immortal будут инициализированы значением TRUE. Кроме того, элементы SitePrefixLength, Метрика и Протокол имеют недопустимое значение, а другие поля инициализируются равным нулю.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	netioapi.h (включая Iphlpapi.h)
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll