EndpointPair(HostName, String, HostName, String) Construtor

Definição

Namespace:

Windows.Networking

Cria um novo 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

O nome do host local ou o endereço IP do objeto EndpointPair .

localServiceName

String

Platform::String

winrt::hstring

O nome do serviço local ou o número da porta TCP ou UDP local para o objeto EndpointPair .

remoteHostName

HostName

O nome do host remoto ou o endereço IP do objeto EndpointPair .

remoteServiceName

String

Platform::String

winrt::hstring

O nome do serviço remoto ou o número da porta TCP ou UDP remoto para o objeto EndpointPair .

Comentários

Esse construtor cria um novo objeto EndpointPair de um nome de host local, um nome de serviço local, um nome de host remoto e um nome de serviço remoto. O objeto EndpointPair fornece dados usados por aplicativos de rede para o ponto de extremidade local e o ponto de extremidade remoto para uma conexão de rede.

Um ponto de extremidade consiste em dois componentes:

• O nome do host ou endereço IP.

• O nome do serviço ou o número da porta TCP ou UDP. Um par de pontos de extremidade consiste em dois componentes:

• O ponto de extremidade local para uma conexão de rede.

• O ponto de extremidade remoto para uma conexão de rede. O parâmetro localHostName pode conter um dos seguintes:

• O nome do host local que pode ser resolvido pelo DNS (Sistema de Nomes de Domínio) ou por outro provedor de namespace.

• O nome do host local que corresponde a uma cadeia de caracteres no seguinte arquivo no computador local: %WINDIR%\system32\drivers\etc\hosts

• Uma cadeia de caracteres que contém um endereço de rede IPv4 ou IPv6 do host local. Uma cadeia de caracteres de endereço IPv4 está em notação decimal pontilhada ("192.168.1.111", por exemplo). Um endereço IPv6 está em notação hexadecimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", por exemplo). Se o parâmetro localHostName for a cadeia de caracteres "localhost", isso representará todos os endereços de loopback no computador local.

O método NetworkInformation.GetHostNames no namespace Windows.Networking.Connectivity pode ser usado para recuperar uma lista de nomes de host ou endereços IP associados ao computador local. Um desses nomes de host ou endereços IP pode ser usado para o parâmetro localHostName .

O parâmetro localHostName também pode ser definido como nulo. Se o localHostName for nulo antes que uma conexão de rede seja estabelecida por um aplicativo cliente, o sistema fornecerá automaticamente o endereço IP local para o aplicativo usar.

O parâmetro localServiceName pode conter um dos seguintes:

• Um literal numérico para um número de porta TCP ou UDP (80 para a porta TCP usada para http, por exemplo).
• Um alias de cadeia de caracteres para um número de porta ("http", por exemplo) que corresponde a uma cadeia de caracteres no seguinte arquivo no computador local: %WINDIR%\system32\drivers\etc\services
• Um nome de serviço que pode ser resolvido por um provedor de namespace usando um registro SRV. O parâmetro localServiceName também pode conter uma cadeia de caracteres vazia. Se o nome do serviço local for uma cadeia de caracteres vazia para o ponto de extremidade local antes de uma conexão de rede ser estabelecida, o sistema fornecerá automaticamente um número de porta IP TCP ou UDP para o aplicativo usar ao estabelecer uma conexão de rede.

O construtor falhará se o parâmetro localServiceName for nulo.

O parâmetro remoteHostName pode conter um dos seguintes:

• O nome do host remoto que pode ser resolvido pelo DNS (Sistema de Nomes de Domínio) ou por outro provedor de namespace.
• O nome do host que corresponde a uma cadeia de caracteres no seguinte arquivo no computador local: %WINDIR%\system32\drivers\etc\hosts
• Uma cadeia de caracteres que contém um endereço de rede IPv4 ou IPv6 do host remoto. Uma cadeia de caracteres de endereço IPv4 está em notação decimal pontilhada ("192.168.1.111", por exemplo). Um endereço IPv6 está em notação hexadecimal ("21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A", por exemplo). Se o parâmetro remoteHostName for a cadeia de caracteres "localhost", isso representará todos os endereços de loopback no computador local.

O construtor falhará se o parâmetro remoteHostName for nulo ou contiver uma cadeia de caracteres vazia.

O parâmetro remoteServiceName pode conter um dos seguintes:

• Um literal numérico para um número de porta TCP ou UDP (80 para a porta TCP usada para http, por exemplo).
• Um alias de cadeia de caracteres para um número de porta ("http", por exemplo) que corresponde a uma cadeia de caracteres no seguinte arquivo no computador local: %WINDIR%\system32\drivers\etc\services
• Um nome de serviço que pode ser resolvido por um provedor de namespace usando um registro SRV. O construtor falhará se o parâmetro remoteServiceName for nulo ou contiver uma cadeia de caracteres vazia.

Confira também

• Windows.Networking