StreamSocket.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 pacotes TCP 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 pacotes TCP 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 de um serviço. Na verdade, o serviço pode estar hospedado em vários serviços, de modo que uma pesquisa de DNS retorne vários endereços IP para os vários servidores. Esse método retorna um par de pontos de extremidade para cada um dos servidores encontrados por uma pesquisa de DNS.
- remoteServiceName
-
String
Platform::String
winrt::hstring
O nome ou o número da porta de um serviço remoto. Observe que servidores diferentes podem dar suporte ao serviço nomeado em portas físicas diferentes, portanto, nem todos os pontos de extremidade retornados usarão o mesmo número de porta de serviço.
Retornos
Uma operação de pesquisa assíncrona. Após a conclusão bem-sucedida, a lista retornada contém um EndpointPair para cada host remoto encontrado, sendo um ponto de extremidade um dos hosts remotos e o outro o host local.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Comentários
Esse método obtém uma lista de possíveis objetos EndpointPair que podem ser usados por um StreamSocket para enviar dados para um destino de rede remota usando TCP. A lista retornada é classificada para que os pares de endereços mais adequados para comunicação entre dois pares ocorram anteriormente na lista.
Um StreamSocket pode usar a lista retornada por esse método 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
| Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Comentários
O método GetEndpointPairsAsync obtém uma lista de possíveis objetos EndpointPair que podem ser usados por um StreamSocket para se conectar a um destino de rede remota. A lista retornada é classificada com base no parâmetro sortOptions .
Um StreamSocket pode usar a lista retornada por esse método 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).