StreamSocket.GetEndpointPairsAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| GetEndpointPairsAsync(HostName, String) |
Ottiene un elenco di oggetti EndpointPair basati su un nome host remoto e un nome di servizio remoto che possono essere usati per inviare pacchetti TCP a una destinazione di rete remota. |
| GetEndpointPairsAsync(HostName, String, HostNameSortOptions) |
Ottiene un elenco di oggetti EndpointPair in base a un nome host remoto e al nome del servizio remoto e all'ordinamento da utilizzare. |
GetEndpointPairsAsync(HostName, String)
Ottiene un elenco di oggetti EndpointPair basati su un nome host remoto e un nome di servizio remoto che possono essere usati per inviare pacchetti TCP a una destinazione di rete 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))Parametri
- remoteHostName
- HostName
Nome host di un servizio. Il servizio potrebbe effettivamente essere ospitato in più servizi, in modo che una ricerca DNS restituisca più indirizzi IP per i vari server. Questo metodo restituisce una coppia di endpoint per ognuno dei server trovati da una ricerca DNS.
- remoteServiceName
-
String
Platform::String
winrt::hstring
Nome o numero di porta di un servizio remoto. Si noti che server diversi potrebbero supportare il servizio denominato su porte fisiche diverse, quindi non tutti gli endpoint restituiti useranno lo stesso numero di porta del servizio.
Valori restituiti
Operazione di ricerca asincrona. Al termine, l'elenco restituito contiene un endpointPair per ogni host remoto trovato, con un endpoint che rappresenta uno degli host remoti e l'altro come host locale.
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Commenti
Questo metodo ottiene un elenco di possibili oggetti EndpointPair che possono essere usati da un oggetto StreamSocket per inviare dati a una destinazione di rete remota tramite TCP. L'elenco restituito viene ordinato in modo che le coppie di indirizzi più adatte per la comunicazione tra due peer si verifichino in precedenza nell'elenco.
Un oggetto StreamSocket può usare l'elenco restituito da questo metodo per provare e associare o connettersi a ogni oggetto EndpointPair fino a quando non è possibile stabilire una connessione. Un oggetto EndpointPair dall'elenco verrà usato con i metodi ConnectAsync(EndpointPair)
Vedi anche
Si applica a
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
Ottiene un elenco di oggetti EndpointPair in base a un nome host remoto e al nome del servizio remoto e all'ordinamento da utilizzare.
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))Parametri
- remoteHostName
- HostName
Nome host remoto o indirizzo IP.
- remoteServiceName
-
String
Platform::String
winrt::hstring
Nome del servizio remoto o porta UDP.
- sortOptions
- HostNameSortOptions
Ordinamento da utilizzare per la restituzione dell'elenco.
Valori restituiti
Elenco di oggetti EndpointPair .
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Commenti
Il metodo GetEndpointPairsAsync ottiene un elenco di possibili oggetti EndpointPair che possono essere usati da un oggetto StreamSocket per connettersi a una destinazione di rete remota. L'elenco restituito viene ordinato in base al parametro sortOptions .
Un oggetto StreamSocket può usare l'elenco restituito da questo metodo per provare e associare o connettersi a ogni oggetto EndpointPair fino a quando non è possibile raggiungere una destinazione remota. Un oggetto EndpointPair dall'elenco verrà usato con il metodo ConnectAsync(EndpointPair).