Поделиться через

Функция 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