共用方式為

getTeredoPort 函式 (netioapi.h)

  • 發行項

GetTeredoPort 函式會擷取本機電腦上 Teredo 用戶端所使用的動態 UDP 埠號碼。

語法

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

參數

[out] Port

UDP 埠號碼的指標。 成功傳回時，此參數會填入 Teredo 用戶端所使用的埠號碼。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 Description
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 來接聽在多播 IPv4 位址 224.0.0.253 上傳送的多播流量，如 RFC 4380 中所定義。 如需詳細資訊，請參閱http://www.ietf.org/rfc/rfc4380.txt。

GetTeredoPort 函式主要是由防火牆應用程式使用，以便設定適當的例外狀況，以允許傳入和傳出 Teredo 流量。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netioapi.h (包含 Iphlpapi.h)
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange