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,則會依下列順序排序資料表:
- 本機 IP 位址
- 本機連接埠
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
傳回碼 | 描述 |
---|---|
|
pUdpTable參數所指向的緩衝區不夠大。 必要的大小會在pdwSize參數所指向的ULONG變數中傳回。
如果 pUdpTable 參數為 Null,也會傳回此錯誤。 |
|
pdwSize參數為Null,或GetUdpTable無法寫入pdwSize參數所指向的記憶體。 |
|
本機系統上使用的作業系統不支援此函式。 |
|
使用 FormatMessage 取得傳回錯誤的訊息字串。 |
備註
在針對 Windows Vista 和更新版本發行的 Windows SDK 上,GetUdpTable函式的傳回值會變更為相當於DWORD的ULONG資料類型。
需求
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | iphlpapi.h |
程式庫 | Iphlpapi.lib |
Dll | Iphlpapi.dll |