DatagramSocket.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 datagrammes à 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 datagrammes à 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 distant ou adresse IP.

remoteServiceName

String

Platform::String

winrt::hstring

Nom du service distant ou port UDP.

Retours

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Liste d’objets EndpointPair .

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

ID_CAP_NETWORKING [Windows Phone]

Remarques

La méthode GetEndpointPairsAsync obtient une liste d’objets EndpointPair possibles qui peuvent être utilisés par un DatagramSocket pour envoyer des datagrammes à une destination réseau distante. 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 DatagramSocket peut utiliser la liste retournée par la méthode GetEndpointPairsAsync 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

• ConnectAsync(EndpointPair)
• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
• HostName

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

Fonctionnalités de l’application

ID_CAP_NETWORKING [Windows Phone]

Remarques

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

Un DatagramSocket peut utiliser la liste retournée par la méthode GetEndpointPairsAsync 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

• ConnectAsync(EndpointPair)
• EndpointPair
• GetEndpointPairsAsync(HostName, String)
• HostName