DatagramSocket.GetEndpointPairsAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| GetEndpointPairsAsync(HostName, String) |
Obtém uma lista de objetos EndpointPair com base em um nome de host remoto e um nome de serviço remoto que podem ser usados para enviar datagramas para um destino de rede remota. |
| GetEndpointPairsAsync(HostName, String, HostNameSortOptions) |
Obtém uma lista de objetos EndpointPair com base em um nome de host remoto e no nome do serviço remoto e na ordem de classificação a ser usada. |
GetEndpointPairsAsync(HostName, String)
Obtém uma lista de objetos EndpointPair com base em um nome de host remoto e um nome de serviço remoto que podem ser usados para enviar datagramas para um destino de rede remota.
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))Parâmetros
- remoteHostName
- HostName
O nome do host remoto ou o endereço IP.
- remoteServiceName
-
String
Platform::String
winrt::hstring
O nome do serviço remoto ou a porta UDP.
Retornos
Uma lista de objetos EndpointPair .
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
ID_CAP_NETWORKING [Windows Phone]
|
Comentários
O método GetEndpointPairsAsync obtém uma lista de possíveis objetos EndpointPair que podem ser usados por um DatagramSocket para enviar datagramas para um destino de rede remota. A lista retornada é classificada para que os pares de endereços mais adequados para comunicação entre dois pares ocorram anteriormente na lista.
Um DatagramSocket pode usar a lista retornada pelo método GetEndpointPairsAsync para tentar associar ou conectar-se a cada objeto EndpointPair até que uma conexão possa ser feita. Um objeto EndpointPair da lista seria usado com os métodos ConnectAsync(EndpointPair)
Confira também
Aplica-se a
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
Obtém uma lista de objetos EndpointPair com base em um nome de host remoto e no nome do serviço remoto e na ordem de classificação a ser usada.
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))Parâmetros
- remoteHostName
- HostName
O nome do host remoto ou o endereço IP.
- remoteServiceName
-
String
Platform::String
winrt::hstring
O nome do serviço remoto ou a porta UDP.
- sortOptions
- HostNameSortOptions
A ordem de classificação a ser usada ao retornar a lista.
Retornos
Uma lista de objetos EndpointPair .
- Atributos
Requisitos do Windows
| Funcionalidades do aplicativo |
ID_CAP_NETWORKING [Windows Phone]
|
Comentários
O método GetEndpointPairsAsync obtém uma lista de possíveis objetos EndpointPair que podem ser usados por um DatagramSocket para se conectar a um destino de rede remota. A lista retornada é classificada com base no parâmetro sortOptions .
Um DatagramSocket pode usar a lista retornada pelo método GetEndpointPairsAsync para tentar associar ou conectar-se a cada objeto EndpointPair até que um destino remoto possa ser alcançado. Um objeto EndpointPair da lista seria usado com o método ConnectAsync(EndpointPair).