DatagramSocket.GetEndpointPairsAsync Método

Definição

Namespace:

Windows.Networking.Sockets

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

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Uma lista de objetos EndpointPair .

Atributos

OverloadAttribute RemoteAsyncAttribute

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

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

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

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Uma lista de objetos EndpointPair .

Atributos

OverloadAttribute RemoteAsyncAttribute

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

Confira também

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