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 查閱找到的每個伺服器傳回一個端點組。

remoteServiceName

String

Platform::String

winrt::hstring

遠端服務的名稱或埠號碼。 請注意，不同的伺服器可能支援不同實體埠上的具名服務，因此並非所有傳回的端點都會使用相同的服務埠號碼。

傳回

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 引進)

備註

這個方法會取得StreamSocket可用來使用 TCP 將資料傳送至遠端網路目的地的可能EndpointPair物件清單。 傳回的清單會排序，讓最適合兩個對等之間通訊的位址組在清單中稍早發生。

StreamSocket可以使用此方法傳回的清單來嘗試並系結或連線到每個EndpointPair物件，直到可以建立連線為止。 清單中的 EndpointPair 物件會與 ConnectAsync (EndpointPair) 方法搭配使用

另請參閱

• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

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) 方法搭配使用。

另請參閱

• GetEndpointPairsAsync(HostName, String)