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

適用於

另請參閱