DatagramSocket.GetEndpointPairsAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
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 埠。
傳回
EndpointPair物件的清單。
- 屬性
Windows 需求
應用程式功能 |
ID_CAP_NETWORKING [Windows Phone]
|
備註
GetEndpointPairsAsync 方法會取得DatagramSocket可用來將資料包傳送至遠端網路目的地的可能EndpointPair物件清單。 傳回的清單會經過排序,讓最適合兩個對等之間通訊的位址組在清單中稍早發生。
DatagramSocket可以使用 GetEndpointPairsAsync 方法傳回的清單來嘗試並系結或連線到每個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 需求
應用程式功能 |
ID_CAP_NETWORKING [Windows Phone]
|
備註
GetEndpointPairsAsync 方法會取得DatagramSocket可用來連線到遠端網路目的地的可能EndpointPair物件清單。 傳回的清單會根據 sortOptions 參數排序。
DatagramSocket可以使用 GetEndpointPairsAsync 方法所傳回的清單,嘗試並系結或連線到每個EndpointPair物件,直到到達遠端目的地為止。 清單中的 EndpointPair 物件會與 ConnectAsync (EndpointPair) 方法搭配使用。