共用方式為


getTcp6Table2 函式 (iphlpapi.h)

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 端點時,會比較下列值 (,如) 所列:

  1. 本機 IPv6 位址
  2. 本機範圍識別碼
  3. 本機連接埠
  4. 遠端 IPv6 位址
  5. 遠端範圍識別碼
  6. 遠端連接埠

傳回值

如果函式成功,傳回值會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

另請參閱

GetExtendedTcpTable

GetOwnerModuleFromTcp6Entry

GetTcp6Table

GetTcpStatisticsEx

GetTcpTable

MIB_TCP6ROW

MIB_TCP6ROW2

MIB_TCP6ROW_OWNER_MODULE

MIB_TCP6ROW_OWNER_PID

MIB_TCP6TABLE

MIB_TCP6TABLE2

MIB_TCP6TABLE_OWNER_MODULE

MIB_TCP6TABLE_OWNER_PID