BackgroundAccessStatus Перечисление

Определение

Это перечисление определяет возможность приложения выполнять фоновые действия.

Приложения должны успешно вызывать 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 заполнены во время добавления приложения на экран блокировки и если приложение указало канал Управления в своем манифесте вместе с таймером или push-уведомлением, оно добавляется на экран блокировки, но без возможности RTC. Затем приложение может выполнять дальнейшие запросы на добавление на экран блокировки, которые не представляют пользовательский интерфейс для пользователя. Если аппаратный слот открыт при выполнении одного такого запроса, приложение займет этот слот.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

Применяется к

См. также раздел