StreamSocket.GetEndpointPairsAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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).