語言

BackgroundAccessStatus 列舉

定義

此列舉會指定應用程式執行背景活動的能力。

應用程式必須先成功呼叫 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
繼承
BackgroundAccessStatus
屬性

Windows 需求

規格需求 Description
裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

欄位

名稱 值 Description
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

適用於

另請參閱