getUdp6Table 函数 (iphlpapi.h)

项目
02/28/2024

GetUdp6Table 函数 (UDP) 侦听器表检索 IPv6 用户数据报协议。

语法

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

参数

[out] Udp6Table

指向以MIB_UDP6TABLE结构的形式接收 IPv6 UDP 侦听器表的缓冲区的指针。

[in, out] SizePointer

输入时，指定 Udp6Table 参数指向的缓冲区的大小（以字节为单位）。

在输出时，如果缓冲区不够大，无法容纳返回的侦听器表，则函数会将此参数设置为等于所需的缓冲区大小（以字节为单位）。

[in] Order

一个布尔值，指定是否应对返回的 UDP 侦听器表进行排序。如果此参数为 TRUE，则按以下顺序对表进行排序：

本地 IPv6 地址
本地范围 ID
本地端口

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

返回代码	说明
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
Library	Iphlpapi.lib
DLL	Iphlpapi.dll