StreamSocket.GetEndpointPairsAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
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
Se aplica a
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
Lista de objetos EndpointPair .
- Atributos
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).