BackgroundAccessStatus Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Essa enumeração especifica a capacidade de um aplicativo de executar atividades em segundo plano.
Os aplicativos devem chamar BackgroundExecutionManager.RequestAccessAsync com êxito antes de registrar tarefas em segundo plano.
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 BackgroundAccessStatusvar value = Windows.ApplicationModel.Background.BackgroundAccessStatus.unspecifiedPublic Enum BackgroundAccessStatus- Herança
-
BackgroundAccessStatus
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Campos
| AllowedMayUseActiveRealTimeConnectivity | 2 | O aplicativo pode configurar tarefas em segundo plano, mas não pode usar o agente rtc (conectividade em tempo real). Isso significa que o aplicativo pode não funcionar enquanto o dispositivo está em espera conectado. Observe que os aplicativos que não especificam RTC em seu manifesto sempre demonstrarão esse comportamento. Esse valor foi preterido no Windows 10, versão 1607. No Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync exibiu uma caixa de diálogo que perguntava ao usuário se o aplicativo deveria ser executado em segundo plano. Esse valor será retornado se o usuário tiver escolhido "permitir" na caixa de diálogo. Depois que esse valor tiver sido retornado, as chamadas subsequentes para o método BackgroundExecutionManager.RequestAccessAsync não apresentaram a caixa de diálogo ao usuário. |
| AllowedSubjectToSystemPolicy | 5 | O usuário selecionou Balanceado ou Gerenciado pelo Sistema nas configurações de uso da bateria. Introduzido no Windows 10, versão 1607. |
| AllowedWithAlwaysOnRealTimeConnectivity | 1 | O aplicativo pode configurar tarefas em segundo plano e, se tiver a funcionalidade , pode usar o agente rtc (conectividade em tempo real). Isso significa que o aplicativo pode funcionar enquanto o dispositivo está no estado de espera conectado. Esse valor foi preterido no Windows 10, versão 1607. No Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync exibiu uma caixa de diálogo que perguntava ao usuário se o aplicativo deveria ser executado em segundo plano. Esse valor será retornado se o usuário tiver escolhido "permitir" na caixa de diálogo. Depois que esse valor tiver sido retornado, as chamadas subsequentes para o método BackgroundExecutionManager.RequestAccessAsync não apresentaram a caixa de diálogo ao usuário. |
| AlwaysAllowed | 4 | Em dispositivos que têm uma bateria, o usuário deu ao aplicativo permissão nas configurações de uso da bateria para sempre permitir o acesso em segundo plano. Introduzido no Windows 10, versão 1607. |
| Denied | 3 | Esse valor foi preterido no Windows 10, versão 1607. No Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync exibiu uma caixa de diálogo que perguntava ao usuário se o aplicativo deveria ser executado em segundo plano. Esse valor será retornado se o usuário escolher "não permitir" na caixa de diálogo. Depois que esse valor tiver sido retornado, as chamadas subsequentes para o método BackgroundExecutionManager.RequestAccessAsync não apresentaram a caixa de diálogo ao usuário. |
| DeniedBySystemPolicy | 6 | Em dispositivos que têm uma bateria, o usuário selecionou Otimizado para Bateria nas configurações de uso da bateria e o sistema optou por não permitir que esse aplicativo seja executado em segundo plano com base nos recursos do sistema. Introduzido no Windows 10, versão 1607. |
| DeniedByUser | 7 | Em dispositivos que têm uma bateria, o usuário desabilitou a execução do aplicativo em segundo plano nas configurações de uso da bateria. Introduzido no Windows 10, versão 1607. |
| Unspecified | 0 | O aplicativo não pode executar atividade em segundo plano nesse estado. No Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync exibiu uma caixa de diálogo que perguntava ao usuário se o aplicativo deveria ser executado em segundo plano. Esse valor será retornado se o usuário não selecionou "permitir" ou "não permitir" na caixa de diálogo ou o descartou sem fazer uma escolha. |
Comentários
Em dispositivos que não têm uma bateria, as configurações que permitem que um aplicativo use a atividade em segundo plano são encontradas nas configurações de aplicativos em segundo plano. Em dispositivos que têm uma bateria, as configurações de tarefa em segundo plano podem ser encontradas nas configurações de uso da bateria.
Declare a funcionalidade RTC no manifesto do aplicativo especificando a tarefa em segundo plano do canal controle na guia Declarações . Para obter mais informações, consulte Como definir opções de conectividade em segundo plano.
Se todos os slots RTC de hardware estiverem cheios no momento em que o aplicativo for adicionado à tela de bloqueio e se o aplicativo tiver especificado o Canal de controle em seu manifesto, juntamente com a notificação por temporizador ou push, ele será adicionado à tela de bloqueio, mas sem a funcionalidade RTC. Em seguida, o aplicativo pode fazer outras solicitações a serem adicionadas à tela de bloqueio, que não apresentam a interface do usuário ao usuário. Se um slot de hardware estiver aberto quando uma dessas solicitações for feita, o aplicativo assumirá esse slot.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | AllowedSubjectToSystemPolicy |
| 1607 | 14393 | AlwaysAllowed |
| 1607 | 14393 | DeniedBySystemPolicy |
| 1607 | 14393 | DeniedByUser |