EndpointPair(HostName, String, HostName, String) Constructor
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un nuevo objeto 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)Parámetros
- localHostName
- HostName
El nombre de host local o la dirección IP del objeto EndpointPair .
- localServiceName
-
String
Platform::String
winrt::hstring
El nombre del servicio local o el número de puerto TCP o UDP local para el objeto EndpointPair .
- remoteHostName
- HostName
El nombre de host remoto o la dirección IP del objeto EndpointPair .
- remoteServiceName
-
String
Platform::String
winrt::hstring
El nombre del servicio remoto o el número de puerto TCP o UDP remoto para el objeto EndpointPair .
Comentarios
Este constructor crea un nuevo objeto EndpointPair a partir de un nombre de host local, un nombre de servicio local, un nombre de host remoto y un nombre de servicio remoto. El objeto EndpointPair proporciona datos usados por las aplicaciones de red para el punto de conexión local y el punto de conexión remoto para una conexión de red.
Un punto de conexión consta de dos componentes:
El nombre de host o la dirección IP.
El nombre del servicio o el número de puerto TCP o UDP. Un par de puntos de conexión consta de dos componentes:
Punto de conexión local para una conexión de red.
Punto de conexión remoto para una conexión de red. El parámetro localHostName puede contener una de las siguientes opciones:
Nombre del host local que puede resolver el sistema de nombres de dominio (DNS) o otro proveedor de espacios de nombres.
Nombre del host local que coincide con una cadena en el siguiente archivo en el equipo local: %WINDIR%\system32\drivers\etc\hosts
Cadena que contiene una dirección de red IPv4 o IPv6 del host local. Una cadena de dirección IPv4 está en notación decimal con puntos ("192.168.1.111", por ejemplo). Una dirección IPv6 está en notación hexadecimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", por ejemplo). Si el parámetro localHostName es la cadena "localhost", representa todas las direcciones de bucle invertido en el equipo local.
El método NetworkInformation.GetHostNames del espacio de nombres Windows.Networking.Connectivity se puede usar para recuperar una lista de nombres de host o direcciones IP asociadas al equipo local. Uno de estos nombres de host o direcciones IP se puede usar para el parámetro localHostName .
El parámetro localHostName también se puede establecer en null. Si localHostName es null antes de que una aplicación cliente establezca una conexión de red, el sistema proporcionará automáticamente la dirección IP local para que la aplicación la use.
El parámetro localServiceName puede contener uno de los siguientes elementos:
- Literal numérico para un número de puerto TCP o UDP (80 para el puerto TCP usado para http, por ejemplo).
- Alias de cadena para un número de puerto ("http", por ejemplo) que coincide con una cadena en el siguiente archivo en el equipo local: %WINDIR%\system32\drivers\etc\services
- Un nombre de servicio que un proveedor de espacios de nombres puede resolver mediante un registro SRV. El parámetro localServiceName también puede contener una cadena vacía. Si el nombre del servicio local es una cadena vacía para el punto de conexión local antes de establecer una conexión de red, el sistema proporcionará automáticamente un número de puerto IP TCP o UDP que la aplicación usará al establecer una conexión de red.
Se producirá un error en el constructor si el parámetro localServiceName es null.
El parámetro remoteHostName puede contener una de las siguientes opciones:
- Nombre del host remoto que puede resolver el sistema de nombres de dominio (DNS) o otro proveedor de espacios de nombres.
- Nombre del host que coincide con una cadena en el siguiente archivo en el equipo local: %WINDIR%\system32\drivers\etc\hosts
- Cadena que contiene una dirección de red IPv4 o IPv6 del host remoto. Una cadena de dirección IPv4 está en notación decimal con puntos ("192.168.1.111", por ejemplo). Una dirección IPv6 está en notación hexadecimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", por ejemplo). Si el parámetro remoteHostName es la cadena "localhost", representa todas las direcciones de bucle invertido en el equipo local.
Se producirá un error en el constructor si el parámetro remoteHostName es null o contiene una cadena vacía.
El parámetro remoteServiceName puede contener uno de los siguientes elementos:
- Literal numérico para un número de puerto TCP o UDP (80 para el puerto TCP usado para http, por ejemplo).
- Alias de cadena para un número de puerto ("http", por ejemplo) que coincide con una cadena en el siguiente archivo en el equipo local: %WINDIR%\system32\drivers\etc\services
- Un nombre de servicio que un proveedor de espacios de nombres puede resolver mediante un registro SRV. Se producirá un error en el constructor si el parámetro remoteServiceName es null o contiene una cadena vacía.