DatagramSocket.GetEndpointPairsAsync 方法

定義

命名空間:

Windows.Networking.Sockets

多載

GetEndpointPairsAsync(HostName, String)	根據可用來將資料包傳送至遠端網路目的地的遠端主機名和遠端服務名稱，取得 EndpointPair 物件的清單。
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)	根據遠端主機名和遠端服務名稱和要使用的排序次序，取得 EndpointPair 物件的清單。

GetEndpointPairsAsync(HostName, String)

根據可用來將資料包傳送至遠端網路目的地的遠端主機名和遠端服務名稱，取得 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

遠端主機名或 IP 位址。

remoteServiceName

String

Platform::String

winrt::hstring

遠端服務名稱或 UDP 埠。

傳回

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

EndpointPair物件的清單。

屬性

OverloadAttribute RemoteAsyncAttribute

Windows 需求

應用程式功能

ID_CAP_NETWORKING [Windows Phone]

備註

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

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

另請參閱

• ConnectAsync(EndpointPair)
• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
• HostName

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 需求

應用程式功能

ID_CAP_NETWORKING [Windows Phone]

備註

GetEndpointPairsAsync 方法會取得DatagramSocket可用來連線到遠端網路目的地的可能EndpointPair物件清單。 傳回的清單會根據 sortOptions 參數排序。

DatagramSocket可以使用 GetEndpointPairsAsync 方法所傳回的清單，嘗試並系結或連線到每個EndpointPair物件，直到到達遠端目的地為止。 清單中的 EndpointPair 物件會與 ConnectAsync (EndpointPair) 方法搭配使用。

另請參閱

• ConnectAsync(EndpointPair)
• EndpointPair
• GetEndpointPairsAsync(HostName, String)
• HostName