Функция GetIpNetEntry2
Функция GetIpNetEntry2 извлекает сведения для записи соседнего IP-адреса на локальном компьютере.
Синтаксис
NETIOAPI_API GetIpNetEntry2(
_Inout_ PMIB_IPNET_ROW2 Row
);
Параметры
- Строка [вход, выход]
Указатель на запись структуры MIB_IPNET_ROW2 для записи соседнего IP-адреса. При успешном возвращении эта структура обновляется свойствами для соседнего IP-адреса.
Возвращаемое значение
GetIpNetEntry2 возвращает STATUS_SUCCESS, если функция выполнена успешно.
В случае сбоя функции GetIpNetEntry2 возвращает один из следующих кодов ошибок:
Код возврата | Описание |
---|---|
STATUS_INVALID_PARAMETER | В функцию передан недопустимый параметр. Эта ошибка возвращается, если в параметре Row передается указатель NULL, элемент AddressMIB_IPNET_ROW2 структуры, на которую указывает параметр Row, не был задан допустимый адрес IPv4 или IPv6 соседа, либо элементы InterfaceLuid и InterfaceIndex структуры MIB_IPNET_ROW2 не были указаны. |
STATUS_NOT_FOUND | Не удалось найти указанный интерфейс. Эта ошибка возвращается, если функции не удается найти сетевой интерфейс, заданный элементом InterfaceLuid или InterfaceIndex структуры MIB_IPNET_ROW2, на которую указывает параметр Row . |
STATUS_NOT_SUPPORTED | Запрос не поддерживается. Эта ошибка возвращается, если на локальном компьютере не расположен стек IPv4 и IPv4-адрес был указан в элементе Адрес структуры MIB_IPNET_ROW2, на которую указывает параметр Row , или если на локальном компьютере не расположен стек IPv6 и в элементе Address был указан IPv6-адрес. |
Другое | Используйте функцию FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки. |
Комментарии
Функция GetIpNetEntry2 используется для получения записи структуры MIB_IPNET_ROW2 .
При входе драйвер должен инициализировать следующие элементы структуры MIB_IPNET_ROW2, на которую указывает параметр Row .
Адрес
Задайте допустимый соседний адрес IPv4 или IPv6 и семейство.InterfaceLuid или InterfaceIndex
Эти элементы используются в порядке, указанном ранее. Поэтому если указан InterfaceLuid , этот член используется для определения интерфейса. Если для элемента InterfaceLuid не задано значение (значение этого элемента было равно нулю), далее для определения интерфейса используется элемент InterfaceIndex .
В выходных данных при успешном вызове GetIpNetEntry2 извлекает другие свойства для соседнего IP-адреса и заполняет структуру MIB_IPNET_ROW2, на которую указывает параметр Row .
Драйвер может вызвать функцию GetIpNetTable2 , чтобы перечислить записи соседних IP-адресов на локальном компьютере.
Требования
Целевая платформа |
Универсальное |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Заголовок |
Netioapi.h (включая Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |