GetTeredoPort 関数 (netioapi.h)
GetTeredoPort 関数は、ローカル コンピューター上のTeredo クライアントによって使用される動的 UDP ポート番号を取得します。
構文
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetTeredoPort(
[out] USHORT *Port
);
パラメーター
[out] Port
UDP ポート番号へのポインター。 正常に戻ると、このパラメーターには、Teredo クライアントで使用されるポート番号が入力されます。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
無効なパラメーターが関数に渡されました。 このエラーは、Null ポインターがPort パラメーターで渡された場合に返されます。 |
|
デバイスの準備ができていません。 このエラーは、Teredo クライアントがローカル コンピューターで起動されていない場合に返されます。 |
|
要求はサポートされていません。 このエラーは、ローカル コンピューター上に IPv6 スタックがない場合に返されます。 |
|
FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。 |
注釈
GetTeredoPort 関数は、Windows Vista 以降で定義されています。
GetTeredoPort 関数は、Teredo サービス ポートに対してTeredo クライアントによって使用されている現在の UDP ポート番号を取得します。 Teredo ポートは動的であり、Teredo クライアントがローカル コンピューターで再起動されるたびに変更できます。 NotifyTeredoPortChange 関数を呼び出すことで、Teredo サービス ポートが変更されたときに通知されるようにアプリケーションを登録できます。
Teredo クライアントでは、RFC 4380 で定義されているマルチキャスト IPv4 アドレス 224.0.0.253 で送信されたマルチキャスト トラフィックをリッスンするために、静的 UDP ポート 3544 も使用されます。 詳細については、「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 |