getTcp6Table2 函式 (iphlpapi.h)

發行項
08/24/2023

GetTcp6Table2函式會擷取 IPv6 的 TCP 連線資料表。

語法

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

參數

[out] TcpTable

緩衝區的指標，接收 IPv6 的 TCP 連接資料表做為 MIB_TCP6TABLE2 結構。

[in, out] SizePointer

在輸入時，指定 TcpTable 參數所指向的緩衝區大小。

在輸出中，如果緩衝區不夠大，無法保存傳回的 TCP 連線資料表，函式會將此參數設定為等於所需的緩衝區大小。

[in] Order

值，指定是否應該排序 TCP 連接資料表。如果此參數為 TRUE，資料表會以遞增順序排序，從最低的本機 IP 位址開始。如果此參數為 FALSE，資料表就會以擷取的順序顯示。

排序 TCP 端點時，會比較下列值 (，如) 所列：

本機 IPv6 位址
本機範圍識別碼
本機連接埠
遠端 IPv6 位址
遠端範圍識別碼
遠端連接埠

傳回值

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

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

傳回碼	描述
ERROR_INSUFFICIENT_BUFFER	TcpTable參數指向的緩衝區不夠大。所需的大小會在 SizePointer 參數所指向的變數中傳回。
ERROR_INVALID_PARAMETER	SizePointer參數為Null，或GetTcp6Table2無法寫入SizePointer參數所指向的記憶體。
ERROR_NOT_SUPPORTED	本機系統上使用的作業系統不支援此函式。
其他	使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

GetTcp6Table2函式是在 Windows Vista 和更新版本上定義。

GetTcp6Table2函式是GetTcp6Table函式的增強版本，也會擷取 TCP 連線 TCP 卸載狀態的相關資訊。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	iphlpapi.h
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll