GetUdp6Table 函式 (iphlpapi.h)

發行項
02/28/2024

GetUdp6Table 函式會擷取 IPv6 使用者數據報通訊協定 (UDP) 接聽程式數據表。

語法

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

參數

[out] Udp6Table

緩衝區的指標，接收IPv6 UDP接聽程序數據表做為 MIB_UDP6TABLE 結構。

[in, out] SizePointer

在輸入時，指定 Udp6Table 參數所指向之緩衝區的大小，以位元組為單位。

在輸出中，如果緩衝區不夠大，無法容納傳回的接聽程序數據表，函式會將此參數設定為等於所需的緩衝區大小，以位元組為單位。

[in] Order

布爾值，指定是否應該排序傳回的 UDP 接聽程序數據表。如果此參數為 TRUE，則會依下列順序排序數據表：

本機 IPv6 位址
本機範圍標識碼
本機連接埠

傳回值

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

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

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

備註

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

規格需求

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