Функция GetPerAdapterInfo (iphlpapi.h)

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

Синтаксис

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

Параметры

[in] IfIndex

Индекс интерфейса. Функция GetPerAdapterInfo извлекает сведения для адаптера, соответствующего этому интерфейсу.

[out] pPerAdapterInfo

Указатель на структуру IP_PER_ADAPTER_INFO , которая получает сведения об адаптере.

[in] pOutBufLen

Указатель на переменную ULONG , указывающую размер структуры IP_PER_ADAPTER_INFO . Если этого размера недостаточно для хранения сведений, GetPerAdapterInfo заполняет эту переменную требуемым размером и возвращает код ошибки ERROR_BUFFER_OVERFLOW.

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

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

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

Код возврата	Описание
ERROR_BUFFER_OVERFLOW	Размер буфера, указанный параметром pOutBufLen , слишком мал для хранения сведений об адаптере. Параметр pOutBufLen указывает на требуемый размер.
ERROR_INVALID_PARAMETER	Параметр pOutBufLen имеет значение NULL, или вызывающий процесс не имеет доступа на чтение и запись к памяти, на которую указывает pOutBufLen, или вызывающий процесс не имеет доступа на запись в память, на которую указывает параметр pAdapterInfo .
ERROR_NOT_SUPPORTED	GetPerAdapterInfo не поддерживается операционной системой, работающей на локальном компьютере.
Другое	Если функция завершается сбоем, используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки.

 

 

Комментарии

Индекс адаптера может изменяться при отключении адаптера и его включении или при других обстоятельствах и не должен считаться постоянным.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	iphlpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll

См. также раздел

Справочник по вспомогательной функции IP

Начальная страница вспомогательного ip-адреса

IP_PER_ADAPTER_INFO