StreamSocket.GetEndpointPairsAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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
远程服务的名称或端口号。 请注意，不同的服务器可能支持不同物理端口上的命名服务，因此并非所有返回的终结点都将使用相同的服务端口号。
返回
异步查找操作。 成功完成后，返回的列表包含找到的每个远程主机的一个 EndpointPair ，其中一个终结点是远程主机之一，另一个终结点是本地主机。
- 属性
Windows 要求
| 设备系列 |
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
|
注解
此方法获取 StreamSocket 可用于使用 TCP 将数据发送到远程网络目标的可能 EndpointPair 对象列表。 对返回的列表进行排序，以便最适合两个对等机之间通信的地址对先出现在列表中。
StreamSocket 可以使用此方法返回的列表尝试绑定或连接到每个 EndpointPair 对象，直到可以建立连接。 列表中的 EndpointPair 对象将用于 ConnectAsync (EndpointPair) 方法
另请参阅
适用于
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
返回列表时使用的排序顺序。
返回
EndpointPair 对象的列表。
- 属性
Windows 要求
| 设备系列 |
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
|
注解
GetEndpointPairsAsync 方法获取 StreamSocket 可用于连接到远程网络目标的可能 EndpointPair 对象的列表。 返回的列表根据 sortOptions 参数进行排序。
StreamSocket 可以使用此方法返回的列表尝试绑定或连接到每个 EndpointPair 对象，直到到达远程目标。 列表中的 EndpointPair 对象将用于 ConnectAsync (EndpointPair) 方法。