DatagramSocket.GetEndpointPairsAsync Метод

Определение

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

Windows.Networking.Sockets

Перегрузки

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

GetEndpointPairsAsync(HostName, String)

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

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

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

remoteServiceName

String

Platform::String

winrt::hstring

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

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

IAsyncOperation<IVectorView<EndpointPair>>

IAsyncOperation<IReadOnlyList<EndpointPair>>

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

Атрибуты

OverloadAttribute RemoteAsyncAttribute

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

Возможности приложения

ID_CAP_NETWORKING [Windows Phone]

Комментарии

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

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

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

• ConnectAsync(EndpointPair)
• GetEndpointPairsAsync(HostName, String, HostNameSortOptions)
• HostName

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

Возможности приложения

ID_CAP_NETWORKING [Windows Phone]

Комментарии

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

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

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

• ConnectAsync(EndpointPair)
• EndpointPair
• GetEndpointPairsAsync(HostName, String)
• HostName