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