GetTcpStatisticsEx 函式 (iphlpapi.h)

發行項
08/24/2023

GetTcpStatisticsEx函式會擷取目前電腦的傳輸控制通訊協定 (TCP) 統計資料。 GetTcpStatisticsEx函式與GetTcpStatistics 函式不同，因為 GetTcpStatisticsEx也支援網際網路通訊協定第 6 版 (IPv6) 通訊協定系列。

語法

IPHLPAPI_DLL_LINKAGE ULONG GetTcpStatisticsEx(
  [out] PMIB_TCPSTATS Statistics,
  [in]  ULONG         Family
);

參數

[out] Statistics

接收本機電腦的 TCP 統計資料之MIB_TCPSTATS 結構的指標。

[in] Family

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

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

傳回值

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

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

傳回碼	描述
ERROR_INVALID_PARAMETER	pStats參數為Null或未指向有效的記憶體，或dwFamily參數不是有效的值。
ERROR_NOT_SUPPORTED	在進行函式呼叫的作業系統上不支援此函式。
其他	使用 FormatMessage 取得傳回錯誤的訊息字串。

需求


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	iphlpapi.h
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll