StreamSocket.GetEndpointPairsAsync Méthode

Définition

Espace de noms:

Windows.Networking.Sockets

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

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

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

OverloadAttribute RemoteAsyncAttribute

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

• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

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

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Liste d’objets EndpointPair .

Attributs

OverloadAttribute RemoteAsyncAttribute

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

• GetEndpointPairsAsync(HostName, String)