XboxLiveEndpointPair 类

定义

命名空间:

Windows.Networking.XboxLive

XboxLiveEndpointPair 是在两台设备之间建立的安全和网络质量关系，用于基于套接字的通信。

Windows.Networking.XboxLive API 利用 IPv4、IPv6 和 Microsoft 的网络地址转换 (NAT) 遍历技术和服务 (（如 Teredo) ）来确定和配置终结点之间可用的最佳网络路径，在各种环境中实现对等 (P2P) 连接。 它还建立了流量加密和防止篡改，作为减少作弊的一项措施。 此外，它还通过 Xbox Live 生态系统&dmash 对用户和应用程序进行身份验证;将连接信息与其他 Xbox Live 服务集成。 然后，此信息可用于匹配，以尝试将具有相似连接统计信息的玩家彼此匹配。

Windows.Networking.XboxLive API 补充和扩展了 TCP 和 UDP 等传统网络传输，以及可用的套接字 API WinSock 和 Windows.Networking.Sockets。 使用此 API 创建 XboxLiveEndpointPair ，然后使用首选的传输 API 进行实际数据传输。 XboxLiveEndpointPair 概念本身与 Windows.Networking.EndpointPair 相关，因为它可以解释为一组本地和远程 IP 地址和端口;但对于 XboxLiveEndpointPair，这些属性是只读的 (，因为系统会) 协商它们，并且具有关联的有效期 (因为 XboxLiveEndpointPair 表示一个活动的安全关系，) 可以出于各种原因终止。

重要

此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

public ref class XboxLiveEndpointPair sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveEndpointPair final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveEndpointPair

Public NotInheritable Class XboxLiveEndpointPair

继承

Object Platform::Object IInspectable XboxLiveEndpointPair

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Xbox One System Apps Extensions for the UWP (在 10.0.0.1 中引入) Xbox Live Extension SDK (在 10.0.10240.0 中引入) Xbox One Extensions for the UWP (在 10.0.10240.0 中引入) Windows Desktop Extension SDK (在 10.0.16299.0 中引入)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (在 v1.0 中引入)

注解

不要使用构造函数创建此类的实例。 相反，请使用 XboxLiveEndpointPairTemplate 类中的 CreateEndpointPairAsync 或 CreateEndpointPairForPorts 方法之一，以便创建遵循特定通信模板的终结点对。

属性

LocalHostName	重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
LocalPort	获取本地终结点的端口。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
RemoteDeviceAddress	获取远程终结点的 XboxLiveDeviceAddress 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
RemoteHostName	获取远程终结点的 主机名 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
RemotePort	获取远程终结点的端口。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
State	获取一个值，该值表示此 XboxLiveEndpointPair 的状态。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
Template	获取用于实例化此终结点对的 XboxLiveEndpointPairTemplate 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

方法

DeleteAsync()	开始正常终止两个终结点之间的 XboxLiveEndpointPair 安全关系。 已尽力尝试通知远程设备，但不能保证在远程设备不再可用或无法访问时收到此通知。 远程设备可能会让 XboxLiveEndpointPair 超时。 无论远程设备或 XboxLiveEndpointPair 的先前状态如何，该操作都将成功完成。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	查找与从第一个主机和端口到第二个主机和端口的流量关联的现有 XboxLiveEndpointPair 实例（如果存在）。 使用此方法可从传入流量向后传送到与该流量关联的 XboxLiveEndpointPair 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	查找与两个给定套接字地址之间的流量关联的现有 XboxLiveEndpointPair 实例（如果存在），其中套接字地址作为包含 Winsock SOCKADDR_STORAGE 或相关结构的字节数组提供。 使用此方法可从传入流量向后传送到与该流量关联的 XboxLiveEndpointPair 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetLocalSocketAddressBytes(Byte[])	获取本地终结点的套接字地址信息作为字节数组。 此方法使用本地设备的 SOCKADDR_STORAGE 地址填充指定的字节缓冲区，以便在利用 Xbox Live 多人游戏网络 API 的后续 Winsock 操作中使用。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetRemoteSocketAddressBytes(Byte[])	获取远程终结点的套接字地址信息，作为字节数组。 此方法使用远程设备的 SOCKADDR_STORAGE 地址填充指定的字节缓冲区，以便在利用 Xbox Live 多人游戏网络 API 的后续 Winsock 操作中使用。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

事件

StateChanged

当 XboxLiveEndpointPair 的状态更改时引发的事件。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。