共用方式為


GetIpStatisticsEx 函式 (iphlpapi.h)

GetIpStatisticsEx 函式會擷取目前電腦的因特網通訊協定 (IP) 統計數據。 GetIpStatisticsEx 函式與 GetIpStatistics 函式不同,因為 GetIpStatisticsEx 也支援因特網通訊協定第 6 版 (IPv6) 通訊協定系列。

語法

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

參數

[out] Statistics

接收本機電腦 IP 統計數據 之MIB_IPSTATS 結構的指標。

[in] Family

要為其擷取統計數據的通訊協定系列。 此參數必須是下列其中一個值:

意義
AF_INET
因特網通訊協定第 4 版 (IPv4) 。
AF_INET6
網際網路通訊協定第 6 版 (IPv6)。

傳回值

如果函式成功,傳回值會NO_ERROR。

如果函式失敗,傳回值就是下列其中一個錯誤碼。

傳回碼 Description
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
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

GetIpStatistics

GetTcpStatisticsEx

GetUdpStatisticsEx

IP 協助程式函式參考

IP 協助程式起始頁

MIB_IPSTATS