Partager via


StreamSocket.GetEndpointPairsAsync Méthode

Définition

Surcharges

GetEndpointPairsAsync(HostName, String)

Obtient une liste d’objets EndpointPair en fonction d’un nom d’hôte distant et d’un nom de service distant qui peuvent être utilisés pour envoyer des paquets TCP à une destination réseau distante.

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Obtient une liste d’objets EndpointPair en fonction d’un nom d’hôte distant et d’un nom de service distant et de l’ordre de tri à utiliser.

GetEndpointPairsAsync(HostName, String)

Obtient une liste d’objets EndpointPair en fonction d’un nom d’hôte distant et d’un nom de service distant qui peuvent être utilisés pour envoyer des paquets TCP à une destination réseau distante.

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

Paramètres

remoteHostName
HostName

Nom d’hôte d’un service. Le service peut en fait être hébergé sur plusieurs services, de sorte qu’une recherche DNS retourne plusieurs adresses IP pour les différents serveurs. Cette méthode retourne une paire de points de terminaison pour chacun des serveurs trouvés par une recherche DNS.

remoteServiceName
String

Platform::String

winrt::hstring

Nom ou numéro de port d’un service distant. Notez que différents serveurs peuvent prendre en charge le service nommé sur des ports physiques différents, de sorte que tous les points de terminaison retournés n’utilisent pas le même numéro de port de service.

Retours

Opération de recherche asynchrone. Une fois l’exécution réussie, la liste retournée contient un EndpointPair pour chaque hôte distant trouvé, avec un point de terminaison étant l’un des hôtes distants et l’autre étant l’hôte local.

Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Cette méthode obtient la liste des objets EndpointPair possibles qui peuvent être utilisés par un StreamSocket pour envoyer des données à une destination réseau distante à l’aide de TCP. La liste retournée est triée de sorte que les paires d’adresses les mieux adaptées à la communication entre deux homologues se produisent plus tôt dans la liste.

Un StreamSocket peut utiliser la liste retournée par cette méthode pour essayer de lier ou de se connecter à chaque objet EndpointPair jusqu’à ce qu’une connexion puisse être établie. Un objet EndpointPair de la liste est utilisé avec les méthodes ConnectAsync(EndpointPair)

Voir aussi

S’applique à

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Obtient une liste d’objets EndpointPair en fonction d’un nom d’hôte distant et d’un nom de service distant et de l’ordre de tri à utiliser.

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

Paramètres

remoteHostName
HostName

Nom d’hôte distant ou adresse IP.

remoteServiceName
String

Platform::String

winrt::hstring

Nom du service distant ou port UDP.

sortOptions
HostNameSortOptions

Ordre de tri à utiliser lors du retour de la liste.

Retours

Liste d’objets EndpointPair .

Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

La méthode GetEndpointPairsAsync obtient une liste d’objets EndpointPair possibles qui peuvent être utilisés par un StreamSocket pour se connecter à une destination réseau distante. La liste retournée est triée en fonction du paramètre sortOptions .

Un StreamSocket peut utiliser la liste retournée par cette méthode pour essayer de lier ou de se connecter à chaque objet EndpointPair jusqu’à ce qu’une destination distante soit atteinte. Un objet EndpointPair de la liste est utilisé avec la méthode ConnectAsync(EndpointPair).

Voir aussi

S’applique à