StreamSocket.EnableTransferOwnership 方法

定义

命名空间:

Windows.Networking.Sockets

重载

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)	当系统处于连接待机状态时，启用或禁用此 StreamSocket 的流量到达时，套接字代理触发应用的后台任务的功能。
EnableTransferOwnership(Guid)	使应用后台任务在应用未处于活动状态时，此 StreamSocket 的流量到达时由套接字代理触发。

EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)

当系统处于连接待机状态时，启用或禁用此 StreamSocket 的流量到达时，套接字代理触发应用的后台任务的功能。

public:
 virtual void EnableTransferOwnership(Platform::Guid taskId, SocketActivityConnectedStandbyAction connectedStandbyAction) = EnableTransferOwnership;

/// [Windows.Foundation.Metadata.Overload("EnableTransferOwnershipWithConnectedStandbyAction")]
void EnableTransferOwnership(winrt::guid const& taskId, SocketActivityConnectedStandbyAction const& connectedStandbyAction);

[Windows.Foundation.Metadata.Overload("EnableTransferOwnershipWithConnectedStandbyAction")]
public void EnableTransferOwnership(Guid taskId, SocketActivityConnectedStandbyAction connectedStandbyAction);

function enableTransferOwnership(taskId, connectedStandbyAction)

Public Sub EnableTransferOwnership (taskId As Guid, connectedStandbyAction As SocketActivityConnectedStandbyAction)

参数

taskId

Guid

Platform::Guid

winrt::guid

正在启用或禁用的后台任务的 IBackgroundTaskRegistration.TaskId 。

connectedStandbyAction

SocketActivityConnectedStandbyAction

指定在流量到达时是启用或禁用后台任务的激活。

属性

OverloadAttribute

注解

出现0x80070490代码和“找不到元素”消息的异常的最常见原因是系统不支持连接待机。 可以通过调用 EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.DoNotWake)来验证这一点。 如果备用调用成功且未引发异常，则确认原始异常是由系统未设置为连接待机引起的。 这是代码需要处理的条件。

建议的 API 调用模式是调用 EnableTransferOwnership(taskId, SocketActivityConnectedStandbyAction.Wake)。 如果遇到上述异常，请使用 SocketActivityConnectedStandbyAction.DoNotWake 重新尝试调用。

另请参阅

• EnableTransferOwnership(Guid)

EnableTransferOwnership(Guid)

使应用后台任务在应用未处于活动状态时，此 StreamSocket 的流量到达时由套接字代理触发。

public:
 virtual void EnableTransferOwnership(Platform::Guid taskId) = EnableTransferOwnership;

/// [Windows.Foundation.Metadata.Overload("EnableTransferOwnership")]
void EnableTransferOwnership(winrt::guid const& taskId);

[Windows.Foundation.Metadata.Overload("EnableTransferOwnership")]
public void EnableTransferOwnership(Guid taskId);

function enableTransferOwnership(taskId)

Public Sub EnableTransferOwnership (taskId As Guid)

参数

taskId

Guid

Platform::Guid

winrt::guid

当流量到达此 StreamSocket 时，套接字代理将触发的后台任务的 IBackgroundTaskRegistration.TaskId。

属性

OverloadAttribute

注解

有关错误条件的信息，请参阅 EnableTransferOwnership (Guid、SocketActivityConnectedStandbyAction) 的“备注”部分。

另请参阅

• EnableTransferOwnership(Guid, SocketActivityConnectedStandbyAction)