BackgroundAccessStatus Enumerazione

Definizione

Questa enumerazione specifica la capacità di un'app di eseguire attività in background.

Le app devono chiamare correttamente BackgroundExecutionManager.RequestAccessAsync prima di registrare le attività in background.

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
Ereditarietà
BackgroundAccessStatus
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Campi

AllowedMayUseActiveRealTimeConnectivity 2

L'app può configurare le attività in background, ma non può usare il broker di connettività in tempo reale (RTC). Ciò significa che l'app potrebbe non funzionare mentre il dispositivo è in standby connesso. Si noti che le app che non specificano RTC nel manifesto dimostreranno sempre questo comportamento.

Questo valore è deprecato in Windows 10 versione 1607.

In Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync visualizza una finestra di dialogo che richiede all'utente se l'app deve essere eseguita in background. Questo valore è stato restituito se l'utente ha scelto "Consenti" nella finestra di dialogo. Dopo la restituzione di questo valore, le chiamate successive al metodo BackgroundExecutionManager.RequestAccessAsync non presentavano la finestra di dialogo all'utente.

AllowedSubjectToSystemPolicy 5

L'utente ha selezionato Bilanciato o Gestito dal sistema nelle impostazioni di utilizzo della batteria. Introdotta in Windows 10 versione 1607.

AllowedWithAlwaysOnRealTimeConnectivity 1

L'app può configurare le attività in background e, se ha la funzionalità, può usare il broker di connettività in tempo reale. Ciò significa che l'app può funzionare mentre il dispositivo si trova nello stato di standby connesso.

Questo valore è deprecato in Windows 10 versione 1607.

In Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync visualizza una finestra di dialogo che richiede all'utente se l'app deve essere eseguita in background. Questo valore è stato restituito se l'utente ha scelto "Consenti" nella finestra di dialogo. Dopo la restituzione di questo valore, le chiamate successive al metodo BackgroundExecutionManager.RequestAccessAsync non presentavano la finestra di dialogo all'utente.

AlwaysAllowed 4

Nei dispositivi con batteria, l'utente ha concesso l'autorizzazione dell'app nelle impostazioni di utilizzo della batteria per consentire sempre l'accesso in background. Introdotta in Windows 10 versione 1607.

Denied 3

Questo valore è deprecato in Windows 10 versione 1607.

In Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync visualizza una finestra di dialogo che richiede all'utente se l'app deve essere eseguita in background. Questo valore è stato restituito se l'utente ha scelto "non consentire" nella finestra di dialogo. Dopo la restituzione di questo valore, le chiamate successive al metodo BackgroundExecutionManager.RequestAccessAsync non presentavano la finestra di dialogo all'utente.

DeniedBySystemPolicy 6

Nei dispositivi con batteria, l'utente ha selezionato Ottimizzazione batteria nelle impostazioni di utilizzo della batteria e il sistema ha scelto di non consentire l'esecuzione in background dell'applicazione in base alle risorse di sistema. Introdotta in Windows 10 versione 1607.

DeniedByUser 7

Nei dispositivi con batteria, l'utente ha disabilitato l'esecuzione dell'app in background nelle impostazioni di utilizzo della batteria. Introdotta in Windows 10 versione 1607.

Unspecified 0

L'app non può eseguire attività in background in questo stato.

In Windows 8 e Windows 8.1, BackgroundExecutionManager.RequestAccessAsync visualizza una finestra di dialogo che richiede all'utente se l'app deve essere eseguita in background. Questo valore è stato restituito se l'utente non ha selezionato "consenti" o "non consentire" nella finestra di dialogo o lo ha ignorato senza effettuare una scelta.

Commenti

Nei dispositivi che non hanno una batteria, le impostazioni che consentono a un'app di usare l'attività in background si trovano nelle impostazioni delle app in background. Nei dispositivi con batteria, le impostazioni delle attività in background sono disponibili nelle impostazioni Uso batteria.

Dichiarare la funzionalità RTC nel manifesto dell'app specificando l'attività in background Canale di controllo nella scheda Dichiarazioni . Per altre informazioni, vedere Come impostare le opzioni di connettività in background.

Se tutti gli slot RTC hardware sono pieni al momento dell'aggiunta dell'app alla schermata di blocco e se l'app ha specificato canale di controllo nel manifesto, insieme a Timer o Notifica push, viene aggiunto alla schermata di blocco, ma senza funzionalità RTC. L'app può quindi effettuare ulteriori richieste da aggiungere alla schermata di blocco, che non presentano l'interfaccia utente all'utente. Se uno slot hardware è aperto quando viene effettuata una richiesta di questo tipo, l'app accetta tale slot.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

Si applica a

Vedi anche