Функция 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 возвращает один из следующих кодов ошибок:
| Возвращаемый код | Описание |
|---|---|
| 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, которые заполняются строкой параметров.