EndpointPair(HostName, String, HostName, String) Конструктор

Определение

Пространство имен:

Windows.Networking

Создает новый объект 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)

Параметры

localHostName

HostName

Имя локального узла или IP-адрес объекта EndpointPair .

localServiceName

String

Platform::String

winrt::hstring

Имя локальной службы или номер локального порта TCP или UDP для объекта EndpointPair .

remoteHostName

HostName

Имя удаленного узла или IP-адрес объекта EndpointPair .

remoteServiceName

String

Platform::String

winrt::hstring

Имя удаленной службы или номер удаленного порта TCP или UDP для объекта EndpointPair .

Комментарии

Этот конструктор создает новый объект EndpointPair из локального имени узла, имени локальной службы, имени удаленного узла и имени удаленной службы. Объект EndpointPair предоставляет данные, используемые сетевыми приложениями для локальной конечной точки и удаленной конечной точки для сетевого подключения.

Конечная точка состоит из двух компонентов:

• Имя узла или IP-адрес.

• Имя службы или номер порта TCP или UDP. Пара конечных точек состоит из двух компонентов:

• Локальная конечная точка для сетевого подключения.

• Удаленная конечная точка для сетевого подключения. Параметр localHostName может содержать одно из следующих значений:

• Имя локального узла, которое может быть разрешено системой доменных имен (DNS) или другим поставщиком пространства имен.

• Имя локального узла, соответствующее строке в следующем файле на локальном компьютере: %WINDIR%\system32\drivers\etc\hosts

• Строка, содержащая сетевой адрес IPv4 или IPv6 локального узла. Строка адреса IPv4 имеет десятичную нотацию с точками (например, "192.168.1.111"). IPv6-адрес имеет шестнадцатеричную нотацию (например, "21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A"). Если параметр localHostName является строкой localhost, он представляет все адреса замыкания на себя на локальном компьютере.

Метод NetworkInformation.GetHostNames в пространстве имен Windows.Networking.Connectivity можно использовать для получения списка имен узлов или IP-адресов, связанных с локальным компьютером. Затем для параметра localHostName можно использовать одно из этих имен узлов или IP-адресов.

Параметру localHostName также можно присвоить значение NULL. Если значение localHostName имеет значение NULL до установки сетевого подключения клиентским приложением, система автоматически предоставит локальный IP-адрес для использования приложением.

Параметр localServiceName может содержать одно из следующих значений:

• Числовой литерал для номера порта TCP или UDP (например, 80 для TCP-порта, используемого для http).
• Строковый псевдоним для номера порта (например, http), соответствующий строке в следующем файле на локальном компьютере: %WINDIR%\system32\drivers\etc\services
• Имя службы, которое может быть разрешено поставщиком пространства имен с помощью записи SRV. Параметр localServiceName также может содержать пустую строку. Если имя локальной службы является пустой строкой для локальной конечной точки перед установкой сетевого подключения, система автоматически предоставит номер IP-порта TCP или UDP для приложения, который будет использоваться при установке сетевого подключения.

Конструктор завершится ошибкой, если параметр localServiceName имеет значение NULL.

Параметр remoteHostName может содержать одно из следующих значений:

• Имя удаленного узла, которое может быть разрешено системой доменных имен (DNS) или другим поставщиком пространства имен.
• Имя узла, соответствующее строке в следующем файле на локальном компьютере: %WINDIR%\system32\drivers\etc\hosts
• Строка, содержащая сетевой адрес IPv4 или IPv6 удаленного узла. Строка адреса IPv4 имеет десятичную нотацию с точками (например, "192.168.1.111"). IPv6-адрес имеет шестнадцатеричную нотацию (например, "21DA:00D3:0010:2F3B:02AA:00FF:FE28:9C5A"). Если параметр remoteHostName является строкой localhost, он представляет все адреса замыкания на себя на локальном компьютере.

Конструктор завершится ошибкой, если параметр remoteHostName имеет значение NULL или содержит пустую строку.

Параметр remoteServiceName может содержать одно из следующих значений:

• Числовой литерал для номера порта TCP или UDP (например, 80 для TCP-порта, используемого для http).
• Строковый псевдоним для номера порта (например, http), соответствующий строке в следующем файле на локальном компьютере: %WINDIR%\system32\drivers\etc\services
• Имя службы, которое может быть разрешено поставщиком пространства имен с помощью записи SRV. Конструктор завершится ошибкой, если параметр remoteServiceName имеет значение NULL или содержит пустую строку.

См. также раздел

• Windows.Networking