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

Статья
02/28/2024

Функция GetIpStatisticsEx извлекает статистику протокола IP для текущего компьютера. Функция GetIpStatisticsEx отличается от функции GetIpStatistics тем, что GetIpStatisticsEx также поддерживает семейство протоколов IPv6.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG GetIpStatisticsEx(
  [out] PMIB_IPSTATS Statistics,
  [in]  ULONG        Family
);

Параметры

[out] Statistics

Указатель на структуру MIB_IPSTATS , которая получает статистику IP-адресов для локального компьютера.

[in] Family

Семейство протоколов, для которого требуется получить статистику. Этот параметр должен иметь одно из следующих значений:

Значение	Значение
AF_INET	Протокол IP версии 4 (IPv4).
AF_INET6	Протокол IPv6.

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Параметр pStats имеет значение NULL или не указывает на допустимую память, или параметр dwFamily не является допустимым значением.
ERROR_NOT_SUPPORTED	Эта функция не поддерживается в операционной системе, в которой был выполнен вызов функции.
Другое	Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Требования

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