getIpStatisticsEx 函数 (iphlpapi.h)

项目
03/04/2024

GetIpStatisticsEx 函数检索当前计算机的 Internet 协议 (IP) 统计信息。 GetIpStatisticsEx 函数与 GetIpStatistics 函数的不同之处在于，GetIpStatisticsEx 还支持 Internet 协议版本 6 (IPv6) 协议系列。

语法

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

参数

[out] Statistics

指向接收本地计算机的 IP 统计信息的 MIB_IPSTATS 结构的指针。

[in] Family

要检索其统计信息的协议系列。此参数必须是以下值之一：

值	含义
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 的 IP 统计信息。

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

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll