GetTeredoPort 函数
GetTeredoPort 函数检索 Teredo 客户端在本地计算机上使用的动态 UDP 端口号。
语法
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
参数
- 端口 [out]
指向 UDP 端口号的指针。 成功返回时，此参数将填充 Teredo 客户端使用的端口号。
返回值
如果函数成功，GetTeredoPort 将返回STATUS_SUCCESS。
如果函数失败， GetTeredoPort 将返回以下错误代码之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_INVALID_PARAMETER | 传递给函数的参数无效。 如果在 Port 参数中传递 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 |