GetTeredoPort 函数检索 Teredo 客户端在本地计算机上使用的动态 UDP 端口号。
语法
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
参数
-
端口 [out]
指向 UDP 端口号的指针。 成功返回时,此参数将填充 Teredo 客户端使用的端口号。
返回值
GetTeredoPort 如果函数成功,则返回STATUS_SUCCESS。
如果函数失败,GetTeredoPort 返回以下错误代码之一:
| 返回代码 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 将无效参数传递给函数。 如果在端口 参数中传递 指针 NULL 指针,则返回此错误。 |
| ERROR_NOT_READY | 设备未准备就绪。 如果未在本地计算机上启动 Teredo 客户端,则返回此错误。 |
| STATUS_NOT_SUPPORTED | 不支持该请求。 如果本地计算机上没有 IPv6 堆栈,则返回此错误。 |
| 其他 | 使用 FormatMessage 函数获取返回的错误的消息字符串。 |
言论
GetTeredoPort 函数检索 Teredo 客户端用于 Teredo 服务端口的当前 UDP 端口号。 Teredo 端口是动态的,可以在本地计算机上重启 Teredo 客户端时更改。 驱动程序可以通过调用 NotifyTeredoPortChange 函数来注册,以在 Teredo 服务端口更改时收到通知。
Teredo 客户端还使用静态 UDP 端口 3544 侦听在 RFC 4380 中定义的多播 IPv4 地址 224.0.0.253 上发送的多播流量。 有关详细信息,请参阅 Teredo:通过 UDPthrough 网络地址转换(NAT)的隧道 IPv6。
GetTeredoPort 函数主要由防火墙驱动程序使用,以便配置适当的异常,以启用传入和传出 Teredo 流量。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows作系统中可用。 |
页眉 |
Netioapi.h (包括 Netioapi.h) |
图书馆 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |