Partager via


BackgroundAccessStatus Énumération

Définition

Cette énumération spécifie la capacité d’une application à effectuer une activité en arrière-plan.

Les applications doivent appeler avec succès BackgroundExecutionManager.RequestAccessAsync avant d’inscrire des tâches en arrière-plan.

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
Héritage
BackgroundAccessStatus
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Champs

AllowedMayUseActiveRealTimeConnectivity 2

L’application peut configurer des tâches en arrière-plan, mais elle ne peut pas utiliser le répartiteur de connectivité en temps réel (RTC). Cela signifie que l’application peut ne pas fonctionner lorsque l’appareil est en veille connectée. Notez que les applications qui ne spécifient pas RTC dans leur manifeste démontrent toujours ce comportement.

Cette valeur est déconseillée dans Windows 10, version 1607.

Sur Windows 8 et Windows 8.1, BackgroundExecutionManager.RequestAccessAsync affichait une boîte de dialogue qui demandait à l’utilisateur si l’application devait s’exécuter en arrière-plan. Cette valeur a été retournée si l’utilisateur a choisi « autoriser » dans la boîte de dialogue. Une fois cette valeur retournée, les appels suivants à la méthode BackgroundExecutionManager.RequestAccessAsync n’ont pas montré la boîte de dialogue à l’utilisateur.

AllowedSubjectToSystemPolicy 5

L’utilisateur a sélectionné Équilibré ou Géré par le système dans les paramètres d’utilisation de la batterie. Introduit dans Windows 10, version 1607.

AllowedWithAlwaysOnRealTimeConnectivity 1

L’application peut configurer des tâches en arrière-plan et, si elle en dispose, peut utiliser le répartiteur de connectivité en temps réel (RTC). Cela signifie que l’application peut fonctionner pendant que l’appareil est dans l’état de secours connecté.

Cette valeur est déconseillée dans Windows 10, version 1607.

Sur Windows 8 et Windows 8.1, BackgroundExecutionManager.RequestAccessAsync affichait une boîte de dialogue qui demandait à l’utilisateur si l’application devait s’exécuter en arrière-plan. Cette valeur a été retournée si l’utilisateur a choisi « autoriser » dans la boîte de dialogue. Une fois cette valeur retournée, les appels suivants à la méthode BackgroundExecutionManager.RequestAccessAsync n’ont pas montré la boîte de dialogue à l’utilisateur.

AlwaysAllowed 4

Sur les appareils dotés d’une batterie, l’utilisateur a donné l’autorisation à l’application dans les paramètres d’utilisation de la batterie pour toujours autoriser l’accès en arrière-plan. Introduit dans Windows 10, version 1607.

Denied 3

Cette valeur est déconseillée dans Windows 10, version 1607.

Sur Windows 8 et Windows 8.1, BackgroundExecutionManager.RequestAccessAsync affichait une boîte de dialogue qui demandait à l’utilisateur si l’application devait s’exécuter en arrière-plan. Cette valeur a été retournée si l’utilisateur a choisi « ne pas autoriser » dans la boîte de dialogue. Une fois cette valeur retournée, les appels suivants à la méthode BackgroundExecutionManager.RequestAccessAsync n’ont pas montré la boîte de dialogue à l’utilisateur.

DeniedBySystemPolicy 6

Sur les appareils qui ont une batterie, l’utilisateur a sélectionné Batterie optimisée dans les paramètres d’utilisation de la batterie et le système a choisi de ne pas autoriser cette application à s’exécuter en arrière-plan en fonction des ressources système. Introduit dans Windows 10, version 1607.

DeniedByUser 7

Sur les appareils dotés d’une batterie, l’utilisateur a désactivé l’exécution de l’application en arrière-plan dans les paramètres d’utilisation de la batterie. Introduit dans Windows 10, version 1607.

Unspecified 0

L’application ne peut pas effectuer d’activité en arrière-plan dans cet état.

Sur Windows 8 et Windows 8.1, BackgroundExecutionManager.RequestAccessAsync affichait une boîte de dialogue qui demandait à l’utilisateur si l’application devait s’exécuter en arrière-plan. Cette valeur a été retournée si l’utilisateur n’a pas sélectionné « autoriser » ou « ne pas autoriser » dans la boîte de dialogue, ou l’a ignorée sans faire de choix.

Remarques

Sur les appareils qui n’ont pas de batterie, les paramètres qui permettent à une application d’utiliser l’activité en arrière-plan se trouvent dans les paramètres des applications en arrière-plan. Sur les appareils dotés d’une batterie, les paramètres de tâche en arrière-plan se trouvent dans les paramètres Utilisation de la batterie.

Déclarez la fonctionnalité RTC dans le manifeste de votre application en spécifiant la tâche en arrière-plan du canal de contrôle sous l’onglet Déclarations . Pour plus d’informations, consultez Définition des options de connectivité en arrière-plan.

Si tous les emplacements RTC matériels sont pleins au moment où l’application est ajoutée à l’écran de verrouillage, et si l’application a spécifié le canal de contrôle dans son manifeste, avec la notification Timer ou Push, elle est ajoutée à l’écran de verrouillage, mais sans fonctionnalité RTC. L’application peut ensuite effectuer d’autres demandes d’ajout à l’écran de verrouillage, qui ne présentent pas l’interface utilisateur à l’utilisateur. Si un emplacement matériel est ouvert lorsqu’une demande de ce type est effectuée, l’application prend cet emplacement.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

S’applique à

Voir aussi