StreamSocket.GetEndpointPairsAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Networking.Sockets

オーバーロード

GetEndpointPairsAsync(HostName, String)

リモート ネットワーク宛先に TCP パケットを送信するために使用できるリモート ホスト名とリモート サービス名に基づいて EndpointPair オブジェクトの一覧を取得します。
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

リモート ホスト名とリモート サービス名、および使用する並べ替え順序に基づいて EndpointPair オブジェクトの一覧を取得します。

GetEndpointPairsAsync(HostName, String)

編集

リモート ネットワーク宛先に TCP パケットを送信するために使用できるリモート ホスト名とリモート サービス名に基づいて EndpointPair オブジェクトの一覧を取得します。

public:
 static IAsyncOperation<IVectorView<EndpointPair ^> ^> ^ GetEndpointPairsAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName);
/// [Windows.Foundation.Metadata.Overload("GetEndpointPairsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<EndpointPair>> GetEndpointPairsAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName);
[Windows.Foundation.Metadata.Overload("GetEndpointPairsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<EndpointPair>> GetEndpointPairsAsync(HostName remoteHostName, string remoteServiceName);
function getEndpointPairsAsync(remoteHostName, remoteServiceName)
Public Shared Function GetEndpointPairsAsync (remoteHostName As HostName, remoteServiceName As String) As IAsyncOperation(Of IReadOnlyList(Of EndpointPair))

パラメーター

remoteHostName
HostName

サービスのホスト名。 このサービスは実際には複数のサービスでホストされる可能性があるため、DNS 参照はさまざまなサーバーの複数の IP アドレスを返します。 このメソッドは、DNS 参照によって検出されたサーバーごとに 1 つのエンドポイント ペアを返します。

remoteServiceName
String

Platform::String

winrt::hstring

リモート サービスの名前またはポート番号。 異なるサーバーが異なる物理ポートで名前付きサービスをサポートする可能性があるため、返されるすべてのエンドポイントで同じサービス ポート番号が使用されるわけではないことに注意してください。

戻り値

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

非同期参照操作。 正常に完了すると、返されるリストには、見つかった各リモート ホストに対して 1 つの EndpointPair が 含まれており、1 つのエンドポイントはリモート ホストの 1 つ、もう 1 つはローカル ホストです。

属性
OverloadAttribute RemoteAsyncAttribute

Windows の要件

デバイス ファミリ
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v3.0 で導入)

注釈

このメソッドは、StreamSocket が TCP を使用してリモート ネットワーク宛先にデータを送信するために使用できる EndpointPair オブジェクトの一覧を取得します。 返されたリストは、2 つのピア間の通信に最も適したアドレス ペアがリストの前に表示されるように並べ替えられます。

StreamSocket は、このメソッドによって返されるリストを使用して、接続が可能になるまで、各 EndpointPair オブジェクトをバインドまたは接続することができます。 リストの EndpointPair オブジェクトは、 ConnectAsync(EndpointPair) メソッドと共に使用されます

こちらもご覧ください

適用対象

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

編集

リモート ホスト名とリモート サービス名、および使用する並べ替え順序に基づいて EndpointPair オブジェクトの一覧を取得します。

public:
 static IAsyncOperation<IVectorView<EndpointPair ^> ^> ^ GetEndpointPairsAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName, HostNameSortOptions sortOptions);
/// [Windows.Foundation.Metadata.Overload("GetEndpointPairsWithSortOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<EndpointPair>> GetEndpointPairsAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName, HostNameSortOptions const& sortOptions);
[Windows.Foundation.Metadata.Overload("GetEndpointPairsWithSortOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<EndpointPair>> GetEndpointPairsAsync(HostName remoteHostName, string remoteServiceName, HostNameSortOptions sortOptions);
function getEndpointPairsAsync(remoteHostName, remoteServiceName, sortOptions)
Public Shared Function GetEndpointPairsAsync (remoteHostName As HostName, remoteServiceName As String, sortOptions As HostNameSortOptions) As IAsyncOperation(Of IReadOnlyList(Of EndpointPair))

パラメーター

remoteHostName
HostName

リモート ホスト名または IP アドレス。

remoteServiceName
String

Platform::String

winrt::hstring

リモート サービス名または UDP ポート。

sortOptions
HostNameSortOptions

リストを返すときに使用する並べ替え順序。

戻り値

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

EndpointPair オブジェクトの一覧。

属性
OverloadAttribute RemoteAsyncAttribute

Windows の要件

デバイス ファミリ
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v3.0 で導入)

注釈

GetEndpointPairsAsync メソッドは、StreamSocket がリモート ネットワークの宛先に接続するために使用できる EndpointPair オブジェクトの一覧を取得します。 返されるリストは、sortOptions パラメーターに基づいて 並べ替 えられます。

StreamSocket は、このメソッドによって返されるリストを使用して、リモートの宛先に到達できるようになるまで、各 EndpointPair オブジェクトをバインドまたは接続できます。 リストの EndpointPair オブジェクトは、 ConnectAsync(EndpointPair) メソッドと共に使用されます。

こちらもご覧ください

適用対象