Функция InitializeIpForwardEntry (netioapi.h)
Функция 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 определена в Windows Vista и более поздних версиях.
Функция 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 |