エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

EndpointPair.EndpointPair Constructor

新しい EndpointPair オブジェクトを作成します。

構文


var endpointPair = new Windows.Networking.EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName);

パラメーター

localHostName

型: HostName

EndpointPair オブジェクトのローカル ホスト名または IP アドレス。

localServiceName

型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

EndpointPair オブジェクトのローカル サービスの名前またはローカル TCP および UDP ポート番号。

remoteHostName

型: HostName

EndpointPair オブジェクトのリモート ホスト名または IP アドレス。

remoteServiceName

型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

EndpointPair オブジェクトのリモート サービスの名前またはリモート TCP および UDP ポート番号。

解説

このコンストラクターは、ローカル ホスト名、ローカル サービス名、リモート ホスト名、リモート サービス名から新しい EndpointPair オブジェクトを作成します。EndpointPair オブジェクトでは、ネットワーク アプリケーションで使用される、ネットワーク接続のローカル エンド ポイントおよびリモート エンド ポイントのデータが用意されています。

エンドポイントは次の 2 つのコンポーネントで構成されます。

  • ホスト名または IP アドレス。
  • サービス名または TCP か UDP ポート番号。

エンドポイント ペアは次の 2 つのコンポーネントで構成されます。

  • ネットワーク接続のローカル エンドポイントです。
  • ネットワーク接続のリモート エンドポイントです。

localHostName パラメーターは、次のいずれかの値を含むことができます。

  • Domain Name System (DNS) または別の名前空間のプロバイダーで解決できるローカル ホストの名前。
  • ローカル コンピューターで次のファイルの文字列に一致するローカル ホストの名前: %WINDIR%\\system32\drivers\etc\hosts
  • ローカル ホストの IPv4 または IPv6 ネットワーク アドレスを含む文字列。IPv4 アドレス文字列は、ピリオド区切りの 10 進表記 ("192.168.1.111" など) で表されます。IPv6 アドレスは、16 進表記 ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A" など) で表されます。

localHostName のパラメーターが「localhost」の文字列である場合、これはローカル コンピューター上のすべてのループバック アドレスを表します。

Windows.Networking.Connectivity の名前空間の NetworkInformation.GetHostNames のメソッドでローカル コンピューターに関連付けられたホスト名または IP アドレスのリストを取得するために使用できます。これらのホスト名または IP アドレスの 1 つを localHostName パラメーターに使用できます。

localHostName パラメーターは null に設定することもできます。 ネットワーク接続がクライアント アプリケーションによって確立されるまで localHostName が null の場合、使用するアプリケーションのローカル IP アドレスがシステムによって自動的に入力されます。

localServiceName パラメーターは、次のいずれかの値を含むことができます。

  • TCP または UDP ポート番号の数値リテラル (たとえば、http で使用される TCP ポートの場合は 80)。
  • ローカル コンピューター上の %WINDIR%\system32\drivers\etc\services ファイルの文字列と一致するポート番号の文字列エイリアス ("http" など)。
  • SRV レコードを使用して名前空間プロバイダーによって解決できるサービス名。

localServiceName パラメーターに空の文字列を含めることもできます。ネットワーク接続が確立されるまでローカル サービス名がローカル エンドポイントで空の文字列の場合、ネットワーク接続の確立時に使用するアプリケーションの TCP または UDP IP ポート番号がシステムによって自動的に入力されます。

localServiceName パラメーターが null の場合、コンストラクターは失敗します。

remoteHostName パラメーターは、次のいずれかの値を含むことができます。

  • Domain Name System (DNS) または別の名前空間のプロバイダーで解決できるリモート ホストの名前。
  • ローカル コンピューターで次のファイルの文字列に一致するホスト名: %WINDIR%\\system32\drivers\etc\hosts
  • リモート ホストの IPv4 または IPv6 ネットワーク アドレスを含む文字列。IPv4 アドレス文字列は、ピリオド区切りの 10 進表記 ("192.168.1.111" など) で表されます。IPv6 アドレスは、16 進表記 ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A" など) で表されます。

remoteHostName のパラメーターが "localhost" の文字列である場合、これはローカル コンピューター上のすべてのループバック アドレスを表します。

remoteHostName パラメーターが null である場合、またはそのパラメーターに空の文字列が含まれている場合、コンストラクターは失敗します。

remoteServiceName パラメーターは、次のいずれかの値を含むことができます。

  • TCP または UDP ポート番号の数値リテラル (たとえば、http で使用される TCP ポートの場合は 80)。
  • ローカル コンピューター上の %WINDIR%\system32\drivers\etc\services ファイルの文字列と一致するポート番号の文字列エイリアス ("http" など)。
  • SRV レコードを使用して名前空間プロバイダーによって解決できるサービス名。

remoteServiceName パラメーターが null である場合やそのパラメーターに空の文字列が含まれている場合、コンストラクターは失敗します。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Networking
Windows::Networking [C++]

メタデータ

Windows.winmd

DLL

Windows.Networking.dll

参照

EndpointPair
Windows.Networking

 

 

表示:
© 2014 Microsoft