Функция InitializeIpInterfaceEntry
Функция InitializeIpInterfaceEntry инициализирует члены записи структуры MIB_IPINTERFACE_ROW значениями по умолчанию.
Синтаксис
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
Параметры
- Строка [вход, выход]
Указатель на инициализируемую структуру MIB_IPINTERFACE_ROW . При успешном возвращении поля в этом параметре инициализируются со сведениями по умолчанию для интерфейса на локальном компьютере.
Возвращаемое значение
InitializeIpInterfaceEntry возвращает STATUS_SUCCESS, если функция выполнена успешно.
В случае сбоя функции InitializeIpInterfaceEntry возвращает один из следующих кодов ошибок:
| Код возврата | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | В функцию передан недопустимый параметр. Эта ошибка возвращается, если в параметре Row передается указатель NULL. |
| Другое | Используйте функцию FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки. |
Комментарии
В выходных данных элементы структуры MIB_IPINTERFACE_ROW , на которую указывает параметр Row , инициализируются следующим образом.
Семейство
Задайте значение AF_UNSPEC.InterfaceLuid
Задайте для неустановленного значения.Все остальные члены
Задайте нулевое значение.
Драйвер должен использовать функцию InitializeIpInterfaceEntry для инициализации полей записи MIB_IPINTERFACE_ROW структуры со значениями по умолчанию. Затем драйвер может изменить поля в записи MIB_IPINTERFACE_ROW, которую он хочет изменить, а затем вызвать функцию SetIpInterfaceEntry .
Требования
Целевая платформа |
Универсальное |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (включая Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |