Функция GetIfTable2 (netioapi.h)

Статья
08/25/2023

Функция GetIfTable2 извлекает таблицу интерфейса MIB-II.

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

Параметры

[out] Table

Указатель на буфер, который получает таблицу интерфейсов в структуре MIB_IF_TABLE2 .

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

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

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

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

The
Функция GetIfTable2 перечисляет логические и физические интерфейсы в локальной системе и возвращает эти сведения в MIB_IF_TABLE2 структуре. GetIfTable2 — это расширенная версия функции GetIfTable .

Аналогичную функцию GetIfTable2Ex можно использовать для указания уровня возвращаемых интерфейсов. Вызов функции GetIfTable2Ex с параметром Level , равным MibIfTableNormal , получает те же результаты, что и вызов функции GetIfTable2 .

Интерфейсы возвращаются в MIB_IF_TABLE2 структуре в буфере, на который указывает параметр Table . Структура MIB_IF_TABLE2 содержит число интерфейсов и массив MIB_IF_ROW2 структур для каждого интерфейса. Память выделяется функцией GetIfTable2 для структуры MIB_IF_TABLE2 и MIB_IF_ROW2 записей в этой структуре. Если возвращаемые структуры больше не требуются, освободите память, вызвав FreeMibTable.

Обратите внимание, что возвращаемая структура MIB_IF_TABLE2 , на которую указывает параметр Table, может содержать заполнение для выравнивания между элементом NumEntries и первой записью массива MIB_IF_ROW2 в элементе Tableструктуры MIB_IF_TABLE2 . Между MIB_IF_ROW2 записями массива также может присутствовать заполнение для выравнивания. Любой доступ к записи массива MIB_IF_ROW2 должен предполагать наличие заполнения.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	netioapi.h (включая Iphlpapi.h)
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll