BackgroundAccessStatus 枚举

  • 参考

定义

命名空间:
Windows.ApplicationModel.Background
编辑

此枚举指定应用执行后台活动的能力。

在注册后台任务之前，应用必须成功调用 BackgroundExecutionManager.RequestAccessAsync 。

public enum class BackgroundAccessStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class BackgroundAccessStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum BackgroundAccessStatus
var value = Windows.ApplicationModel.Background.BackgroundAccessStatus.unspecified
Public Enum BackgroundAccessStatus
继承
Enum
BackgroundAccessStatus
属性
ContractVersionAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

字段

AllowedMayUseActiveRealTimeConnectivity 2

应用可以设置后台任务，但它不能使用 RTC) 代理 (实时连接。 这意味着当设备处于连接待机状态时，应用可能无法正常工作。 请注意，未在其清单中指定 RTC 的应用将始终演示此行为。

此值在 Windows 10 版本 1607 中已弃用。

在 Windows 8 和 Windows 8.1 上，BackgroundExecutionManager.RequestAccessAsync 显示一个对话框，询问用户是否应在后台运行应用。 如果用户在对话框中选择了“允许”，则返回此值。 返回此值后，对 BackgroundExecutionManager.RequestAccessAsync 方法的后续调用不会向用户显示对话框。
AllowedSubjectToSystemPolicy 5

用户在电池使用设置中选择了“平衡”或“系统托管”。 在 Windows 10 版本 1607 中引入。
AllowedWithAlwaysOnRealTimeConnectivity 1

应用可以设置后台任务，如果具有此功能，则可以使用实时连接 (RTC) 代理。 这意味着，当设备处于连接待机状态时，应用可以正常运行。

此值在 Windows 10 版本 1607 中已弃用。

在 Windows 8 和 Windows 8.1 上，BackgroundExecutionManager.RequestAccessAsync 显示一个对话框，询问用户是否应在后台运行应用。 如果用户在对话框中选择了“允许”，则返回此值。 返回此值后，对 BackgroundExecutionManager.RequestAccessAsync 方法的后续调用不会向用户显示对话框。
AlwaysAllowed 4

在具有电池的设备上，用户在电池使用设置中向应用授予权限，以始终允许后台访问。 在 Windows 10 版本 1607 中引入。
Denied 3

此值在 Windows 10 版本 1607 中已弃用。

在 Windows 8 和 Windows 8.1 上，BackgroundExecutionManager.RequestAccessAsync 显示一个对话框，询问用户是否应在后台运行应用。 如果用户在对话框中选择“不允许”，则返回此值。 返回此值后，对 BackgroundExecutionManager.RequestAccessAsync 方法的后续调用不会向用户显示对话框。
DeniedBySystemPolicy 6

在具有电池的设备上，用户在电池使用设置中选择了“电池优化”，并且系统已选择不允许此应用程序基于系统资源在后台运行。 在 Windows 10 版本 1607 中引入。
DeniedByUser 7

在具有电池的设备上，用户已禁止应用在电池使用设置中后台运行。 在 Windows 10 版本 1607 中引入。
Unspecified 0

在此状态下，应用无法执行后台活动。

在 Windows 8 和 Windows 8.1 上，BackgroundExecutionManager.RequestAccessAsync 显示一个对话框，询问用户是否应在后台运行应用。 如果用户未在对话框中选择“允许”或“不允许”，或者在未做出选择的情况下将其关闭，则返回此值。

注解

在没有电池的设备上，可在后台应用设置中找到允许应用使用后台活动的设置。 在有电池的设备上，可以在“电池使用设置”中找到后台任务设置。

通过在“声明”选项卡中指定控制通道后台任务，在应用的清单中声明 RTC 功能。有关详细信息，请参阅如何设置后台连接选项。

如果在将应用添加到锁屏界面时所有硬件 RTC 槽已满，并且应用在其清单中指定了 控制通道 以及 计时器 或 推送通知，则会将其添加到锁屏界面，但没有 RTC 功能。 然后，应用可以发出进一步的请求以添加到锁屏界面，而锁屏界面不会向用户显示 UI。 如果在发出一个此类请求时打开硬件槽，应用将采用该槽。

版本历史记录

Windows 版本 SDK 版本 已添加值
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

适用于

另请参阅