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

Статья
08/24/2023

Функция GetIcmpStatisticsEx извлекает статистику протокола ICMP для локального компьютера. Функция GetIcmpStatisticsEx может получать статистику IPv6 ICMP.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG GetIcmpStatisticsEx(
  [out] PMIB_ICMP_EX Statistics,
  [in]  ULONG        Family
);

Параметры

[out] Statistics

Указатель на структуру MIB_ICMP_EX , содержащую статистику ICMP для локального компьютера.

[in] Family

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

Значение	Значение
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