BackgroundAccessStatus Enumeration

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.Background
Bearbeiten

Diese Enumeration gibt die Fähigkeit einer App an, Hintergrundaktivitäten auszuführen.

Apps müssen BackgroundExecutionManager.RequestAccessAsync erfolgreich aufrufen, bevor Hintergrundaufgaben registriert werden.

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
Vererbung
Enum
BackgroundAccessStatus
Attribute
ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

AllowedMayUseActiveRealTimeConnectivity 2

Die App kann Hintergrundaufgaben einrichten, aber nicht den RTC-Broker (Real-Time Connectivity) verwenden. Dies bedeutet, dass die App möglicherweise nicht funktioniert, während sich das Gerät im verbundenen Standbymodus befindet. Beachten Sie, dass Apps, die RTC nicht in ihrem Manifest angeben, dieses Verhalten immer demonstrieren.

Dieser Wert ist in Windows 10 Version 1607 veraltet.

Unter Windows 8 und Windows 8.1 hat BackgroundExecutionManager.RequestAccessAsync ein Dialogfeld angezeigt, in dem der Benutzer gefragt wird, ob die App im Hintergrund ausgeführt werden soll. Dieser Wert wurde zurückgegeben, wenn der Benutzer im Dialogfeld "zulassen" ausgewählt hat. Nachdem dieser Wert zurückgegeben wurde, haben nachfolgende Aufrufe der BackgroundExecutionManager.RequestAccessAsync-Methode das Dialogfeld für den Benutzer nicht angezeigt.
AllowedSubjectToSystemPolicy 5

Der Benutzer hat in den Einstellungen für die Akkunutzung die Option Ausbalanciert oder Systemverwaltet ausgewählt. Eingeführt in Windows 10 Version 1607.
AllowedWithAlwaysOnRealTimeConnectivity 1

Die App kann Hintergrundaufgaben einrichten und, wenn dies möglich ist, den RTC-Broker (Echtzeitkonnektivität) verwenden. Dies bedeutet, dass die App funktionieren kann, während sich das Gerät im verbundenen Standbyzustand befindet.

Dieser Wert ist in Windows 10 Version 1607 veraltet.

Unter Windows 8 und Windows 8.1 hat BackgroundExecutionManager.RequestAccessAsync ein Dialogfeld angezeigt, in dem der Benutzer gefragt wird, ob die App im Hintergrund ausgeführt werden soll. Dieser Wert wurde zurückgegeben, wenn der Benutzer im Dialogfeld "zulassen" ausgewählt hat. Nachdem dieser Wert zurückgegeben wurde, haben nachfolgende Aufrufe der BackgroundExecutionManager.RequestAccessAsync-Methode das Dialogfeld für den Benutzer nicht angezeigt.
AlwaysAllowed 4

Auf Geräten, die über einen Akku verfügen, hat der Benutzer der App die Berechtigung in den Einstellungen für die Akkunutzung erteilt, um immer den Hintergrundzugriff zuzulassen. Eingeführt in Windows 10 Version 1607.
Denied 3

Dieser Wert ist in Windows 10 Version 1607 veraltet.

Unter Windows 8 und Windows 8.1 hat BackgroundExecutionManager.RequestAccessAsync ein Dialogfeld angezeigt, in dem der Benutzer gefragt wird, ob die App im Hintergrund ausgeführt werden soll. Dieser Wert wurde zurückgegeben, wenn der Benutzer im Dialogfeld "Nicht zulassen" ausgewählt hat. Nachdem dieser Wert zurückgegeben wurde, haben nachfolgende Aufrufe der BackgroundExecutionManager.RequestAccessAsync-Methode das Dialogfeld für den Benutzer nicht angezeigt.
DeniedBySystemPolicy 6

Auf Geräten, die über einen Akku verfügen, hat der Benutzer in den Akkunutzungseinstellungen die Option Akkuoptimiert ausgewählt, und das System hat sich entschieden, dass diese Anwendung nicht im Hintergrund basierend auf Systemressourcen ausgeführt werden darf. Eingeführt in Windows 10 Version 1607.
DeniedByUser 7

Auf Geräten, die über einen Akku verfügen, hat der Benutzer die Ausführung der App im Hintergrund in den Einstellungen für die Akkunutzung deaktiviert. Eingeführt in Windows 10 Version 1607.
Unspecified 0

Die App kann in diesem Zustand keine Hintergrundaktivität ausführen.

Unter Windows 8 und Windows 8.1 hat BackgroundExecutionManager.RequestAccessAsync ein Dialogfeld angezeigt, in dem der Benutzer gefragt wird, ob die App im Hintergrund ausgeführt werden soll. Dieser Wert wurde zurückgegeben, wenn der Benutzer im Dialogfeld nicht "Zulassen" oder "Nicht zulassen" ausgewählt oder ihn verworfen hat, ohne eine Auswahl zu treffen.

Hinweise

Auf Geräten ohne Akku befinden sich die Einstellungen, die es einer App ermöglichen, Hintergrundaktivitäten zu verwenden, in den Hintergrund-Apps-Einstellungen. Auf Geräten, die über einen Akku verfügen, finden Sie Die Einstellungen für Hintergrundaufgaben in den Einstellungen für die Akkunutzung.

Deklarieren Sie die RTC-Funktion im Manifest Ihrer App, indem Sie die Hintergrundaufgabe Steuerungskanal auf der Registerkarte Deklarationen angeben. Weitere Informationen finden Sie unter Festlegen von Optionen für Hintergrundkonnektivität.

Wenn alle RTC-Hardwareslots zum Zeitpunkt des Hinzufügens der App zum Sperrbildschirm voll sind und die App in ihrem Manifest den Steuerungskanal zusammen mit Timer oder Pushbenachrichtigung angegeben hat, wird sie dem Sperrbildschirm hinzugefügt, jedoch ohne RTC-Funktion. Die App kann dann weitere Anforderungen stellen, um dem Sperrbildschirm hinzugefügt zu werden, die dem Benutzer keine Benutzeroberfläche darstellen. Wenn ein Hardwareslot geöffnet ist, wenn eine solche Anforderung gestellt wird, nimmt die App diesen Slot ein.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

Gilt für:

Weitere Informationen