getTeredoPort 函数 (netioapi.h)

GetTeredoPort 函数检索本地计算机上 Teredo 客户端使用的动态 UDP 端口号。

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
  [out] USHORT *Port
);

参数

[out] Port

指向 UDP 端口号的指针。 成功返回后,此参数将填充 Teredo 客户端使用的端口号。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
向该函数传递了无效参数。 如果在 Port 参数中传递 NULL 指针,则返回此错误。
ERROR_NOT_READY
设备未准备就绪。 如果未在本地计算机上启动 Teredo 客户端,则返回此错误。
ERROR_NOT_SUPPORTED
不支持该请求。 如果本地计算机上没有 IPv6 堆栈,则返回此错误。
其他
使用 FormatMessage 获取返回错误的消息字符串。

注解

GetTeredoPort 函数在 Windows Vista 及更高版本上定义。

GetTeredoPort 函数检索 Teredo 客户端用于 Teredo 服务端口的当前 UDP 端口号。 Teredo 端口是动态的,可以在本地计算机上重启 Teredo 客户端时随时更改。 应用程序可以通过调用 NotifyTeredoPortChange 函数注册,以便在 Teredo 服务端口更改时收到通知。

Teredo 客户端还使用静态 UDP 端口 3544 来侦听在 RFC 4380 中定义的多播 IPv4 地址 224.0.0.253 上发送的多播流量。 有关详细信息,请参阅 http://www.ietf.org/rfc/rfc4380.txt

GetTeredoPort 函数主要由防火墙应用程序使用,以便配置相应的例外以允许传入和传出 Teredo 流量。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netioapi.h (包括 Iphlpapi.h)
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange