StreamSocket.GetEndpointPairsAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| 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
リモート サービスの名前またはポート番号。 異なるサーバーが異なる物理ポートで名前付きサービスをサポートする可能性があるため、返されるすべてのエンドポイントで同じサービス ポート番号が使用されるわけではないことに注意してください。
返品
非同期参照操作。 正常に完了すると、返されるリストには、見つかったリモート ホストごとに 1 つの EndpointPair が含まれており、1 つのエンドポイントはリモート ホストの 1 つ、もう 1 つはローカル ホストです。
- 属性
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
リストを返すときに使用する並べ替え順序。
返品
EndpointPair オブジェクトの一覧。
- 属性
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) メソッドと共に使用されます。