GetIcmpStatisticsEx function (iphlpapi.h)

The GetIcmpStatisticsEx function retrieves Internet Control Message Protocol (ICMP) statistics for the local computer. The GetIcmpStatisticsEx function is capable of retrieving IPv6 ICMP statistics.

Syntax

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

Parameters

[out] Statistics

A pointer to a MIB_ICMP_EX structure that contains ICMP statistics for the local computer.

[in] Family

The protocol family for which to retrieve ICMP statistics. Must be one of the following:

Value	Meaning
AF_INET	Internet Protocol version 4 (IPv4).
AF_INET6	Internet Protocol version 6 (IPv6).

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Return code	Description
ERROR_INVALID_PARAMETER	The pStats parameter is NULL or does not point to valid memory, or the dwFamily parameter is not a valid value.
ERROR_NOT_SUPPORTED	This function is not supported on the operating system on which the function call was made.
Other	Use FormatMessage to obtain the message string for the returned error.

Remarks

The GetIpStatisticsEx can be used to obtain the ICMP statistics for either IPv4 or IPv6 on the local computer.

The GetIcmpStatistics function returns the ICMP statistics for only IPv4 on the local computer.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps | UWP apps]
Minimum supported server	Windows Server 2003 [desktop apps | UWP apps]
Target Platform	Windows
Header	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll

See also

GetIcmpStatistics

GetTcpStatisticsEx

GetUdpStatisticsEx

IP Helper Function Reference

IP Helper Start Page

MIB_ICMP_EX