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 クライアントは、RFC 4380 で定義されているマルチキャスト IPv4 アドレス 224.0.0.253 で送信されるマルチキャスト トラフィックをリッスンするために、静的 UDP ポート 3544 も使用します。 詳細については、「Teredo: UDPthrough ネットワークアドレス変換 (NAT) を介した IPv6 のトンネリング」を参照してください。
GetTeredoPort 関数は、着信および送信 Teredo トラフィックを有効にするための適切な例外を構成するために、主にファイアウォール ドライバーによって使用されます。
要件
対象プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Netioapi.h (Netioapi.h を含む) |
ライブラリ |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |