EndpointPair(HostName, String, HostName, String) コンストラクター

  • リファレンス

定義

名前空間:
Windows.Networking
編集

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

public:
 EndpointPair(HostName ^ localHostName, Platform::String ^ localServiceName, HostName ^ remoteHostName, Platform::String ^ remoteServiceName);
 EndpointPair(HostName const& localHostName, winrt::hstring const& localServiceName, HostName const& remoteHostName, winrt::hstring const& remoteServiceName);
public EndpointPair(HostName localHostName, string localServiceName, HostName remoteHostName, string remoteServiceName);
function EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName)
Public Sub New (localHostName As HostName, localServiceName As String, remoteHostName As HostName, remoteServiceName As String)

パラメーター

localHostName
HostName

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

localServiceName
String

Platform::String

winrt::hstring

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

remoteHostName
HostName

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

remoteServiceName
String

Platform::String

winrt::hstring

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

注釈

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

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

  • ホスト名または IP アドレス。

  • サービス名または TCP または UDP ポート番号。 エンドポイント ペアは、次の 2 つのコンポーネントで構成されます。

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

  • ネットワーク接続のリモート エンドポイント。 localHostName パラメーターには、次のいずれかを含めることができます。

  • ドメイン ネーム システム (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 アドレスのいずれかを localHostName パラメーターに使用できます。

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

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

  • TCP または UDP ポート番号の数値リテラル (たとえば、http に使用される TCP ポートの場合は 80)。
  • ローカル コンピューター上の次のファイル内の文字列と一致するポート番号 ("http"など) の文字列エイリアス: %WINDIR%\system32\drivers\etc\services
  • SRV レコードを使用して名前空間プロバイダーによって解決できるサービス名。 localServiceName パラメーターには、空の文字列を含めることもできます。 ネットワーク接続が確立される前にローカル エンドポイントのローカル サービス名が空の文字列である場合、システムはネットワーク接続の確立時に使用する TCP または UDP IP ポート番号を自動的に提供します。

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

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

  • ドメイン ネーム システム (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)。
  • ローカル コンピューター上の次のファイル内の文字列と一致するポート番号 ("http"など) の文字列エイリアス: %WINDIR%\system32\drivers\etc\services
  • SRV レコードを使用して名前空間プロバイダーによって解決できるサービス名。 remoteServiceName パラメーターが null であるか、空の文字列が含まれている場合、コンストラクターは失敗します。

適用対象

こちらもご覧ください