Partager via


EndpointPair(HostName, String, HostName, String) Constructeur

Définition

Crée un objet EndpointPair .

public:
 EndpointPair(HostName ^ localHostName, Platform::String ^ localServiceName, HostName ^ remoteHostName, Platform::String ^ remoteServiceName);
 EndpointPair(HostName const& localHostName, winrt::hstring const& localServiceName, HostName const& remoteHostName, winrt::hstring const& remoteServiceName);
public EndpointPair(HostName localHostName, string localServiceName, HostName remoteHostName, string remoteServiceName);
function EndpointPair(localHostName, localServiceName, remoteHostName, remoteServiceName)
Public Sub New (localHostName As HostName, localServiceName As String, remoteHostName As HostName, remoteServiceName As String)

Paramètres

localHostName
HostName

Nom d’hôte local ou adresse IP de l’objet EndpointPair .

localServiceName
String

Platform::String

winrt::hstring

Nom du service local ou numéro de port TCP ou UDP local pour l’objet EndpointPair .

remoteHostName
HostName

Nom d’hôte distant ou adresse IP de l’objet EndpointPair .

remoteServiceName
String

Platform::String

winrt::hstring

Nom du service distant ou numéro de port TCP ou UDP distant pour l’objet EndpointPair .

Remarques

Ce constructeur crée un objet EndpointPair à partir d’un nom d’hôte local, d’un nom de service local, d’un nom d’hôte distant et d’un nom de service distant. L’objet EndpointPair fournit les données utilisées par les applications réseau pour le point de terminaison local et le point de terminaison distant pour une connexion réseau.

Un point de terminaison se compose de deux composants :

  • Nom d’hôte ou adresse IP.

  • Nom du service ou numéro de port TCP ou UDP. Une paire de points de terminaison se compose de deux composants :

  • Point de terminaison local pour une connexion réseau.

  • Point de terminaison distant pour une connexion réseau. Le paramètre localHostName peut contenir l’un des éléments suivants :

  • Nom de l’hôte local qui peut être résolu par le système DNS (Domain Name System) ou par un autre fournisseur d’espaces de noms.

  • Nom de l’hôte local qui correspond à une chaîne dans le fichier suivant sur l’ordinateur local : %WINDIR%\system32\drivers\etc\hosts

  • Chaîne qui contient une adresse réseau IPv4 ou IPv6 de l’hôte local. Une chaîne d’adresse IPv4 est en notation décimale en pointillés (« 192.168.1.111 », par exemple). Une adresse IPv6 est en notation hexadécimale (« 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A », par exemple). Si le paramètre localHostName est la chaîne « localhost », cela représente toutes les adresses de bouclage sur l’ordinateur local.

La méthode NetworkInformation.GetHostNames dans l’espace de noms Windows.Networking.Connectivity peut être utilisée pour récupérer une liste de noms d’hôte ou d’adresses IP associés à l’ordinateur local. L’un de ces noms d’hôte ou adresses IP peut ensuite être utilisé pour le paramètre localHostName .

Le paramètre localHostName peut également être défini sur null. Si localHostName est null avant qu’une connexion réseau ne soit établie par une application cliente, le système fournit automatiquement l’adresse IP locale que l’application peut utiliser.

Le paramètre localServiceName peut contenir l’un des éléments suivants :

  • Littéral numérique pour un numéro de port TCP ou UDP (80 pour le port TCP utilisé pour http, par exemple).
  • Alias de chaîne pour un numéro de port (« http », par exemple) qui correspond à une chaîne dans le fichier suivant sur l’ordinateur local : %WINDIR%\system32\drivers\etc\services
  • Nom de service qui peut être résolu par un fournisseur d’espace de noms à l’aide d’un enregistrement SRV. Le paramètre localServiceName peut également contenir une chaîne vide. Si le nom du service local est une chaîne vide pour le point de terminaison local avant l’établissement d’une connexion réseau, le système fournit automatiquement un numéro de port IP TCP ou UDP que l’application peut utiliser lors de l’établissement d’une connexion réseau.

Le constructeur échoue si le paramètre localServiceName est null.

Le paramètre remoteHostName peut contenir l’un des éléments suivants :

  • Nom de l’hôte distant qui peut être résolu par le système DNS (Domain Name System) ou par un autre fournisseur d’espaces de noms.
  • Nom de l’hôte qui correspond à une chaîne dans le fichier suivant sur l’ordinateur local : %WINDIR%\system32\drivers\etc\hosts
  • Chaîne qui contient une adresse réseau IPv4 ou IPv6 de l’hôte distant. Une chaîne d’adresse IPv4 est en notation décimale en pointillés (« 192.168.1.111 », par exemple). Une adresse IPv6 est en notation hexadécimale (« 21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A », par exemple). Si le paramètre remoteHostName est la chaîne « localhost », cela représente toutes les adresses de bouclage sur l’ordinateur local.

Le constructeur échoue si le paramètre remoteHostName est null ou contient une chaîne vide.

Le paramètre remoteServiceName peut contenir l’un des éléments suivants :

  • Littéral numérique pour un numéro de port TCP ou UDP (80 pour le port TCP utilisé pour http, par exemple).
  • Alias de chaîne pour un numéro de port (« http », par exemple) qui correspond à une chaîne dans le fichier suivant sur l’ordinateur local : %WINDIR%\system32\drivers\etc\services
  • Nom de service qui peut être résolu par un fournisseur d’espace de noms à l’aide d’un enregistrement SRV. Le constructeur échoue si le paramètre remoteServiceName est null ou contient une chaîne vide.

S’applique à

Voir aussi