GetTeredoPort 関数
GetTeredoPort 関数は、Teredo クライアントがローカル コンピューターで使用する動的 UDP ポート番号を取得します。
構文
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
パラメーター
-
ポート [出力]
UDP ポート番号へのポインター。 正常に戻った場合、このパラメーターには Teredo クライアントが使用するポート番号が入力されます。
戻り値
GetTeredoPort は、関数が成功した場合にSTATUS_SUCCESSを返します。
関数が失敗した場合、GetTeredoPort は次のいずれかのエラー コードを返します。
| リターン コード | 形容 |
|---|---|
| STATUS_INVALID_PARAMETER | 無効なパラメーターが関数に渡されました。 このエラーは、NULL ポインターが Port パラメーターで渡された場合に返されます。 |
| ERROR_NOT_READY | デバイスの準備ができていません。 このエラーは、Teredo クライアントがローカル コンピューターで起動されていない場合に返されます。 |
| STATUS_NOT_SUPPORTED | 要求はサポートされていません。 このエラーは、IPv6 スタックがローカル コンピューターに存在しない場合に返されます。 |
| その他の | FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。 |
備考
GetTeredoPort 関数は、Teredo クライアントが Teredo サービス ポートに使用する現在の UDP ポート番号を取得します。 Teredo ポートは動的であり、Teredo クライアントがローカル コンピューターで再起動されるたびに変更できます。 ドライバーは、NotifyTeredoPortChange 関数を呼び出すことによって、Teredo サービス ポートが変更されたときに通知を受け取るために登録できます。
Teredo クライアントは、RFC 4380 で定義されているマルチキャスト IPv4 アドレス 224.0.0.253 で送信されるマルチキャスト トラフィックをリッスンするために、静的 UDP ポート 3544 も使用します。 詳細については、「Teredo: TUNNELing IPv6 over UDPthrough Network Address Translations (NAT)を参照してください。
GetTeredoPort 関数は、着信および送信 Teredo トラフィックを有効にするための適切な例外を構成するために、主にファイアウォール ドライバーによって使用されます。
必要条件
ターゲット プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダ |
Netioapi.h (Netioapi.h を含む) |
図書館 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |