Функция GetIfEntry2
Функция GetIfEntry2 извлекает сведения для указанного интерфейса на локальном компьютере.
Внимание
Для разработчиков драйверов рекомендуется использовать GetIfEntry2Ex с MibIfEntryNormalWithoutStatistics, чтобы избежать взаимоблокировки при обслуживании NDIS OID.
Синтаксис
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Параметры
- Строка [in, out]
Указатель на структуру MIB_IF_ROW2 , которая при успешном возвращении получает сведения для интерфейса на локальном компьютере. При входных данных драйвер должен задать элемент InterfaceLuid или элемент InterfaceIndex структуры MIB_IF_ROW2 для получения сведений.
Возвращаемое значение
GetIfEntry2 возвращает STATUS_SUCCESS, если функция выполнена успешно.
Если функция завершается ошибкой, GetIfEntry2 возвращает один из следующих кодов ошибок:
| Код возврата | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Недопустимый параметр был передан функции. Эта ошибка возвращается, если указатель NULL передается в параметре Row . |
| STATUS_NOT_FOUND | Не удалось найти указанный интерфейс. Эта ошибка возвращается, если функция не может найти сетевой интерфейс, указанный членом InterfaceLuid или InterfaceIndex структуры MIB_IF_ROW2, на которую указывает параметр Row. |
| Другое | Используйте функцию FormatMessage, чтобы получить строку сообщения для возвращаемой ошибки. |
Замечания
При входе драйвер должен инициализировать по крайней мере элемент InterfaceLuid или InterfaceIndex в структуре MIB_IF_ROW2, передаваемой в параметре Row. Элементы используются в порядке, указанном ранее. Таким образом, если указан InterfaceLuid , этот элемент используется для определения интерфейса. Если для элемента InterfaceLuid не задано значение (значение этого элемента было равно нулю), элемент InterfaceIndex будет использоваться для определения интерфейса.
В выходных данных остальные поля структуры MIB_IF_ROW2, в которые указываются параметры строки .
Требования
Целевая платформа |
Универсальный |
Версия |
Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
Верхний колонтитул |
Netioapi.h (include Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |