GetUdpTable 函式 (iphlpapi.h)

GetUdpTable函式會擷取 IPv4 使用者資料包通訊協定 (UDP) 接聽程式資料表。

語法

IPHLPAPI_DLL_LINKAGE ULONG GetUdpTable(
  [out]     PMIB_UDPTABLE UdpTable,
  [in, out] PULONG        SizePointer,
  [in]      BOOL          Order
);

[out] UdpTable

接收 IPv4 UDP 接聽程式資料表做為 MIB_UDPTABLE 結構的緩衝區指標。

[in, out] SizePointer

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

在輸出上，如果緩衝區不夠大，無法保存傳回的接聽程式資料表，則函式會將此參數設定為等於所需的緩衝區大小以位元組為單位。

在針對 Windows Vista 和更新版本的 Windows SDK 上，此參數的資料類型會變更為相當於PDWORD的PULONG。

[in] Order

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

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

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

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

在針對 Windows Vista 和更新版本發行的 Windows SDK 上，GetUdpTable函式的傳回值會變更為相當於DWORD的ULONG資料類型。


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