GetIcmpStatisticsEx 函数 (iphlpapi.h)

GetIcmpStatisticsEx 函数检索 Internet 控制消息协议 (ICMP) 本地计算机的统计信息。 GetIcmpStatisticsEx 函数能够检索 IPv6 ICMP 统计信息。

语法

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

[out] Statistics

指向包含本地计算机的 ICMP 统计信息的MIB_ICMP_EX 结构的指针。

[in] Family

要检索其 ICMP 统计信息的协议系列。必须是下列选项之一：

值	含义
AF_INET	Internet 协议版本 4 (IPv4) 。
AF_INET6	Internet 协议版本 6 (IPv6)。

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	pStats 参数为 NULL 或未指向有效内存，或者 dwFamily 参数不是有效值。
ERROR_NOT_SUPPORTED	执行函数调用的操作系统不支持此函数。
其他	使用 FormatMessage 获取返回错误的消息字符串。

GetIpStatisticsEx 可用于获取本地计算机上的 IPv4 或 IPv6 的 ICMP 统计信息。

GetIcmpStatistics 函数仅返回本地计算机上的 IPv4 的 ICMP 统计信息。