Compartilhar via


StreamSocket.GetEndpointPairsAsync Método

Definição

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).

Confira também

Aplica-se a