IBackgroundTaskInstance4 接口

定义

命名空间:

Windows.ApplicationModel.Background

提供对后台任务实例的访问，包括有关用户的信息。

public interface class IBackgroundTaskInstance4 : IBackgroundTaskInstance

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
struct IBackgroundTaskInstance4 : IBackgroundTaskInstance

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.Guid(2133455420, 43524, 19208, 151, 176, 6, 216, 116, 205, 171, 245)]
public interface IBackgroundTaskInstance4 : IBackgroundTaskInstance

Public Interface IBackgroundTaskInstance4
Implements IBackgroundTaskInstance

属性

ContractVersionAttribute GuidAttribute

实现

IBackgroundTaskInstance

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

属性

InstanceId	获取后台任务实例的实例 ID。 (继承自 IBackgroundTaskInstance)
Progress	获取或设置后台任务实例的进度状态。 (继承自 IBackgroundTaskInstance)
SuspendedCount	获取资源管理策略导致后台任务挂起的次数。 (继承自 IBackgroundTaskInstance)
Task	获取对此后台任务实例的已注册后台任务的访问权限。 (继承自 IBackgroundTaskInstance)
TriggerDetails	获取与后台任务实例关联的其他信息。 (继承自 IBackgroundTaskInstance)
User	获取后台任务的用户上下文。 调用应用使用 AppServiceConnection.User 传递用户上下文。 应用服务可以使用此属性检索该用户上下文。

方法

GetDeferral()

通知系统后台任务在 IBackgroundTask.Run 方法返回后可能会继续执行工作。 (继承自 IBackgroundTaskInstance)

事件

Canceled

将取消事件处理程序附加到后台任务实例。 对于 Windows Phone 8.x 应用，如果设备内存不足，后台任务可能会终止，而不会发出任何警告，也不引发 OnCanceled 事件。 这有助于确保前台中应用的用户体验。 应该将后台任务设计为处理此情形。 请注意，这仅适用于Windows Phone。 (继承自 IBackgroundTaskInstance)

另请参阅

• IBackgroundTaskInstance