StreamSocket.GetEndpointPairsAsync Método

Definición

Espacio de nombres:

Windows.Networking.Sockets

Sobrecargas

GetEndpointPairsAsync(HostName, String)	Obtiene una lista de objetos EndpointPair basados en un nombre de host remoto y un nombre de servicio remoto que se pueden usar para enviar paquetes TCP a un destino de red remota.
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)	Obtiene una lista de objetos EndpointPair basados en un nombre de host remoto y un nombre de servicio remoto y el criterio de ordenación que se va a usar.

GetEndpointPairsAsync(HostName, String)

Obtiene una lista de objetos EndpointPair basados en un nombre de host remoto y un nombre de servicio remoto que se pueden usar para enviar paquetes TCP a un destino de red 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

Nombre de host de un servicio. El servicio podría hospedarse realmente en varios servicios, de modo que una búsqueda dns devuelva varias direcciones IP para los distintos servidores. Este método devuelve un par de puntos de conexión para cada uno de los servidores encontrados por una búsqueda DNS.

remoteServiceName

String

Platform::String

winrt::hstring

Nombre o número de puerto de un servicio remoto. Tenga en cuenta que los distintos servidores pueden admitir el servicio con nombre en distintos puertos físicos, por lo que no todos los puntos de conexión devueltos usarán el mismo número de puerto de servicio.

Devoluciones

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Una operación de búsqueda asincrónica. Al finalizar correctamente, la lista devuelta contiene un EndpointPair para cada host remoto encontrado, siendo un punto de conexión uno de los hosts remotos y el otro el host local.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Este método obtiene una lista de posibles objetos EndpointPair que un StreamSocket puede usar para enviar datos a un destino de red remota mediante TCP. La lista devuelta se ordena para que los pares de direcciones más adecuados para la comunicación entre dos elementos del mismo nivel se produzcan anteriormente en la lista.

Un StreamSocket puede usar la lista devuelta por este método para intentar enlazar o conectarse a cada objeto EndpointPair hasta que se pueda realizar una conexión. Un objeto EndpointPair de la lista se usaría con los métodos ConnectAsync(EndpointPair)

Consulte también

• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Obtiene una lista de objetos EndpointPair basados en un nombre de host remoto y un nombre de servicio remoto y el criterio de ordenación que se va a usar.

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

Nombre de host remoto o dirección IP.

remoteServiceName

String

Platform::String

winrt::hstring

Nombre del servicio remoto o puerto UDP.

sortOptions

HostNameSortOptions

Criterio de ordenación que se va a usar al devolver la lista.

Devoluciones

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Lista de objetos EndpointPair .

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

El método GetEndpointPairsAsync obtiene una lista de posibles objetos EndpointPair que un StreamSocket puede usar para conectarse a un destino de red remota. La lista devuelta se ordena según el parámetro sortOptions .

StreamSocket puede usar la lista devuelta por este método para intentar enlazar o conectarse a cada objeto EndpointPair hasta que se pueda alcanzar un destino remoto. Un objeto EndpointPair de la lista se usaría con el método ConnectAsync(EndpointPair).

Consulte también

• GetEndpointPairsAsync(HostName, String)