StreamSocket.GetEndpointPairsAsync Метод

Определение

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

Windows.Networking.Sockets

Перегрузки

GetEndpointPairsAsync(HostName, String)	Возвращает список объектов EndpointPair на основе удаленного имени узла и имени удаленной службы, которые можно использовать для отправки ПАКЕТОВ TCP в удаленное сетевое назначение.
GetEndpointPairsAsync(HostName, String, HostNameSortOptions)	Возвращает список объектов EndpointPair на основе удаленного имени узла и имени удаленной службы, а также порядка сортировки, который необходимо использовать.

GetEndpointPairsAsync(HostName, String)

Возвращает список объектов EndpointPair на основе удаленного имени узла и имени удаленной службы, которые можно использовать для отправки ПАКЕТОВ TCP в удаленное сетевое назначение.

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))

Параметры

remoteHostName

HostName

Имя узла службы. Служба может быть размещена в нескольких службах, поэтому поиск DNS возвращает несколько IP-адресов для различных серверов. Этот метод возвращает по одной паре конечных точек для каждого сервера, найденного при поиске DNS.

remoteServiceName

String

Platform::String

winrt::hstring

Имя или номер порта удаленной службы. Обратите внимание, что разные серверы могут поддерживать именованную службу на разных физических портах, поэтому не все возвращаемые конечные точки будут использовать один и тот же номер порта службы.

Возвращаемое значение

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Асинхронная операция поиска. После успешного завершения возвращенный список содержит одну точку EndpointPair для каждого найденного удаленного узла, при этом одной конечной точкой является один из удаленных узлов, а другой — локальный узел.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Этот метод получает список возможных объектов EndpointPair , которые могут использоваться StreamSocket для отправки данных в удаленное сетевое назначение по протоколу TCP. Возвращаемый список отсортирован таким образом, чтобы пары адресов, которые лучше всего подходили для обмена данными между двумя одноранговниками, отображались ранее в списке.

StreamSocket может использовать список, возвращенный этим методом, для попытки привязки или подключения к каждому объекту EndpointPair до тех пор, пока не будет установлено соединение. Объект EndpointPair из списка будет использоваться с методами ConnectAsync(EndpointPair)

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

• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

GetEndpointPairsAsync(HostName, String, HostNameSortOptions)

Возвращает список объектов EndpointPair на основе удаленного имени узла и имени удаленной службы, а также порядка сортировки, который необходимо использовать.

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))

Параметры

remoteHostName

HostName

Имя удаленного узла или IP-адрес.

remoteServiceName

String

Platform::String

winrt::hstring

Имя удаленной службы или UDP-порт.

sortOptions

HostNameSortOptions

Порядок сортировки, используемый при возврате списка.

Возвращаемое значение

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

Список объектов EndpointPair .

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Метод GetEndpointPairsAsync получает список возможных объектов EndpointPair , которые могут использоваться StreamSocket для подключения к удаленному сетевому назначению. Возвращаемый список сортируется на основе параметра sortOptions .

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

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

• GetEndpointPairsAsync(HostName, String)