StreamSocket.GetEndpointPairsAsync Metodo

Definizione

Spazio dei nomi:

Windows.Networking.Sockets

Overload

GetEndpointPairsAsync(HostName, String)	Ottiene un elenco di oggetti EndpointPair basati su un nome host remoto e un nome di servizio remoto che possono essere utilizzati 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 utilizzati 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, pertanto non tutti gli endpoint restituiti useranno lo stesso numero di porta del servizio.

Restituisce

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

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

OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

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 dei 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 a associare o connettersi a ogni oggetto EndpointPair fino a quando non è possibile stabilire una connessione. Un oggetto EndpointPair dall'elenco verrebbe usato con i metodi ConnectAsync(EndpointPair)

Vedi anche

• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

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.

Restituisce

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Elenco di oggetti EndpointPair .

Attributi

OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

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 streamSocket per connettersi a una destinazione di rete remota. L'elenco restituito viene ordinato in base al parametro sortOptions .

StreamSocket può usare l'elenco restituito da questo metodo per provare a associare o connettersi a ogni oggetto EndpointPair fino a quando non è possibile raggiungere una destinazione remota. Un oggetto EndpointPair dall'elenco verrebbe usato con il metodo ConnectAsync(EndpointPair).

Vedi anche

• GetEndpointPairsAsync(HostName, String)