BackgroundAccessStatus 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この列挙体は、バックグラウンド アクティビティを実行するアプリの機能を指定します。
アプリはバックグラウンド タスクを登録する前に 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 の要件
デバイス ファミリ |
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 |