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 來接聽在多播 IPv4 位址 224.0.0.253 上傳送的多播流量，如 RFC 4380 中所定義。 如需詳細資訊，請參閱 Teredo：透過 UDPthrough 網路位址轉換的通道 IPv6（NAT）。
GetTeredoPort 函式主要是由防火牆驅動程式使用，以便設定適當的例外狀況，以啟用傳入和傳出 Teredo 流量。
需求
目標平台 |
萬用 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
頁首 |
Netioapi.h （包括 Netioapi.h） |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |