Функция InitializeIpInterfaceEntry

Функция InitializeIpInterfaceEntry инициализирует элементы записи структуры MIB_IPINTERFACE_ROW со значениями по умолчанию.

Синтаксис

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Параметры

• строк [in, out]
  Указатель на структуру MIB_IPINTERFACE_ROW для инициализации. При успешном возвращении поля в этом параметре инициализированы с сведениями по умолчанию для интерфейса на локальном компьютере.

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

InitializeIpInterfaceEntry возвращает STATUS_SUCCESS, если функция выполнена успешно.

Если функция завершается ошибкой, InitializeIpInterfaceEntry возвращает один из следующих кодов ошибок:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Недопустимый параметр был передан функции. Эта ошибка возвращается, если указатель NULL передается в параметре строки
Другие	Используйте функцию FormatMessage, чтобы получить строку сообщения для возвращаемой ошибки.

Замечания

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

• семьи
  Установите значение AF_UNSPEC.

• InterfaceLuid
  Присвойте значение неопределенного значения.

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

Драйвер должен использовать функцию InitializeIpInterfaceEntry для инициализации полей записи структуры MIB_IPINTERFACE_ROW со значениями по умолчанию. Затем драйвер может изменить поля в записи MIB_IPINTERFACE_ROW, которую он хочет изменить, а затем вызвать функцию SetIpInterfaceEntry.

Требования

Целевая платформа	универсальные
Версия	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Заголовок	Netioapi.h (include Netioapi.h)
Библиотека	Netio.lib
IRQL	< DISPATCH_LEVEL

См. также

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry