XboxLiveEndpointPairTemplate.CreateEndpointPairForPortsAsync 方法

定义

命名空间:

Windows.Networking.XboxLive

重载

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

CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)

使用创建行为 XboxLiveEndpointPairCreationBehaviors.None，在本地设备和指定的远程设备之间创建终结点对，指定模板指定范围中的特定端口。

重要

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

public:
 virtual IAsyncOperation<XboxLiveEndpointPairCreationResult ^> ^ CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress ^ deviceAddress, Platform::String ^ initiatorPort, Platform::String ^ acceptorPort) = CreateEndpointPairForPortsAsync;

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateEndpointPairForPortsDefaultAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<XboxLiveEndpointPairCreationResult> CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress const& deviceAddress, winrt::hstring const& initiatorPort, winrt::hstring const& acceptorPort);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateEndpointPairForPortsDefaultAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<XboxLiveEndpointPairCreationResult> CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress deviceAddress, string initiatorPort, string acceptorPort);

function createEndpointPairForPortsAsync(deviceAddress, initiatorPort, acceptorPort)

Public Function CreateEndpointPairForPortsAsync (deviceAddress As XboxLiveDeviceAddress, initiatorPort As String, acceptorPort As String) As IAsyncOperation(Of XboxLiveEndpointPairCreationResult)

参数

deviceAddress

XboxLiveDeviceAddress

要连接到的远程设备的 XboxLiveDeviceAddress 。

initiatorPort

String

Platform::String

winrt::hstring

发起程序要使用的端口，来自此模板中指定的可接受发起程序端口范围。

acceptorPort

String

Platform::String

winrt::hstring

接受者要使用的端口，来自此模板中指定的可接受方端口范围。

返回

IAsyncOperation<XboxLiveEndpointPairCreationResult>

异步终结点创建操作。 操作完成后，包含操作的结果。

属性

DefaultOverloadAttribute OverloadAttribute RemoteAsyncAttribute

另请参阅

• CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)

CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)

在本地设备与指定的远程设备之间创建一个终结点对，从模板的指定可接受端口范围指定特定端口，并指定如果此模板、远程设备和端口组合已存在 XboxLiveEndpointPair 时系统的行为方式。

重要

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

public:
 virtual IAsyncOperation<XboxLiveEndpointPairCreationResult ^> ^ CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress ^ deviceAddress, Platform::String ^ initiatorPort, Platform::String ^ acceptorPort, XboxLiveEndpointPairCreationBehaviors behaviors) = CreateEndpointPairForPortsAsync;

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateEndpointPairForPortsWithBehaviorsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<XboxLiveEndpointPairCreationResult> CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress const& deviceAddress, winrt::hstring const& initiatorPort, winrt::hstring const& acceptorPort, XboxLiveEndpointPairCreationBehaviors const& behaviors);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateEndpointPairForPortsWithBehaviorsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<XboxLiveEndpointPairCreationResult> CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress deviceAddress, string initiatorPort, string acceptorPort, XboxLiveEndpointPairCreationBehaviors behaviors);

function createEndpointPairForPortsAsync(deviceAddress, initiatorPort, acceptorPort, behaviors)

Public Function CreateEndpointPairForPortsAsync (deviceAddress As XboxLiveDeviceAddress, initiatorPort As String, acceptorPort As String, behaviors As XboxLiveEndpointPairCreationBehaviors) As IAsyncOperation(Of XboxLiveEndpointPairCreationResult)

参数

deviceAddress

XboxLiveDeviceAddress

要连接到的远程设备的 XboxLiveDeviceAddress 。

initiatorPort

String

Platform::String

winrt::hstring

发起程序要使用的端口，来自此模板中指定的可接受发起程序端口范围。

acceptorPort

String

Platform::String

winrt::hstring

接受者要使用的端口，来自此模板中指定的可接受方端口范围。

behaviors

XboxLiveEndpointPairCreationBehaviors

一个 值，该值指定在已建立请求的终结点对时系统应如何操作。 你的代码可以指定使用现有的 XboxLiveEndpointPair ，或者系统根据模板的质量要求重新评估所有潜在的网络路径。 如果在重新评估后选择了相同的网络路径，则返回相同的 XboxLiveEndpointPair 。 如果找到新路径，则会销毁旧的 XboxLiveEndpointPair ，并返回一个新路径。

返回

IAsyncOperation<XboxLiveEndpointPairCreationResult>

异步终结点创建操作。 操作完成后，包含操作的结果。

属性

DefaultOverloadAttribute OverloadAttribute RemoteAsyncAttribute

另请参阅

• CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)