BackgroundAccessStatus 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
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 需求
裝置系列 |
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 |