Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция 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.
Если функция завершается сбоем, возвращается один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Размер буфера, указанный параметром pOutBufLen , слишком мал для хранения сведений об адаптере. Параметр pOutBufLen указывает на требуемый размер. |
|
Параметр pOutBufLen имеет значение NULL, или вызывающий процесс не имеет доступа на чтение и запись к памяти, на которую указывает pOutBufLen, или вызывающий процесс не имеет доступа на запись в память, на которую указывает параметр pAdapterInfo . |
|
GetPerAdapterInfo не поддерживается операционной системой, работающей на локальном компьютере. |
|
Если функция завершается сбоем, используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки. |
Комментарии
Индекс адаптера может изменяться при отключении адаптера и его включении или при других обстоятельствах и не должен считаться постоянным.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | iphlpapi.h |
| Библиотека | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
См. также раздел
Справочник по вспомогательной функции IP