XboxLiveEndpointPairTemplate 类

定义

命名空间:

Windows.Networking.XboxLive

表示一种预配置的模式，该模式介绍如何使用套接字在两个设备之间实现最佳和安全通信。 此类定义的模板详细说明了 如何在 XboxLiveEndpointPair 中连接两个终结点。 模板在应用的网络清单中静态声明，随后使用唯一名称字符串进行标识。

注意

模板仅在应用的网络清单中声明。 无法在运行时声明或修改模板。

重要

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

public ref class XboxLiveEndpointPairTemplate 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 XboxLiveEndpointPairTemplate 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 XboxLiveEndpointPairTemplate

Public NotInheritable Class XboxLiveEndpointPairTemplate

继承

Object Platform::Object IInspectable XboxLiveEndpointPairTemplate

属性

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.GetTemplateByName 方法来创建特定预定义模板的实例。

属性

AcceptorBoundPortRangeLower	获取应用网络清单中定义的接受者绑定端口范围的下限。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
AcceptorBoundPortRangeUpper	获取应用网络清单中定义的接受者绑定端口范围的上限。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
EndpointPairs	静态属性，用于获取已使用此模板创建的当前 XboxLiveEndpointPair 对象的列表。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
InitiatorBoundPortRangeLower	获取应用网络清单中定义的发起程序绑定端口范围的下限。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
InitiatorBoundPortRangeUpper	获取应用网络清单中定义的发起程序绑定端口范围的上限。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
Name	获取用于实例化此 对象的应用网络清单) 中声明 (模板的名称。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
SocketKind	获取一个值，该值指定此模板声明的套接字类型。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
Templates	列出应用声明的所有模板的静态属性。 模板在生成时在应用的网络清单中声明，不能在运行时声明或修改。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

方法

CreateEndpointPairAsync(XboxLiveDeviceAddress)	基于当前模板，在本地设备和指定远程设备之间创建 XboxLiveEndpointPair ，并具有创建行为 XboxLiveEndpointPairCreationBehaviors.None。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)	在本地设备和指定的远程设备之间创建 XboxLiveEndpointPair ，同时指定如果此模板和远程设备已存在 XboxLiveEndpointPair 时系统的行为方式。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)	使用创建行为 XboxLiveEndpointPairCreationBehaviors.None，在本地设备和指定的远程设备之间创建终结点对，指定模板指定范围中的特定端口。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)	在本地设备与指定的远程设备之间创建一个终结点对，从模板的指定可接受端口范围指定特定端口，并指定如果此模板、远程设备和端口组合已存在 XboxLiveEndpointPair 时系统的行为方式。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetTemplateByName(String)	为命名模板创建 XboxLiveEndpointPairTemplate 的静态方法。 模板在应用网络清单中定义。 清单中的每个模板都必须具有唯一的名称。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

事件

InboundEndpointPairCreated

当远程设备成功创建从自身到本地计算机的终结点对时引发的事件。 有关新终结点对的详细信息，请参阅事件参数。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。