BackgroundAccessStatus Enum

Definisi

Enumerasi ini menentukan kemampuan aplikasi untuk melakukan aktivitas latar belakang.

Aplikasi harus berhasil memanggil BackgroundExecutionManager.RequestAccessAsync sebelum mendaftarkan tugas latar belakang.

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
Warisan
BackgroundAccessStatus
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Bidang

AllowedMayUseActiveRealTimeConnectivity 2

Aplikasi ini dapat mengatur tugas latar belakang, tetapi tidak dapat menggunakan broker konektivitas real-time (RTC). Ini berarti bahwa aplikasi mungkin tidak berfungsi saat perangkat dalam status siaga yang terhubung. Perhatikan bahwa aplikasi yang tidak menentukan RTC dalam manifesnya akan selalu menunjukkan perilaku ini.

Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607.

Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna.

AllowedSubjectToSystemPolicy 5

Pengguna telah memilih Seimbang atau Dikelola Sistem dalam pengaturan penggunaan baterai. Diperkenalkan dalam Windows 10, versi 1607.

AllowedWithAlwaysOnRealTimeConnectivity 1

Aplikasi ini dapat mengatur tugas latar belakang, dan, jika memiliki kemampuan, dapat menggunakan broker konektivitas real-time (RTC). Ini berarti bahwa aplikasi dapat berfungsi saat perangkat berada dalam status siaga yang terhubung.

Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607.

Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna.

AlwaysAllowed 4

Pada perangkat yang memiliki baterai, pengguna telah memberikan izin aplikasi di pengaturan penggunaan baterai untuk selalu mengizinkan akses latar belakang. Diperkenalkan dalam Windows 10, versi 1607.

Denied 3

Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607.

Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "jangan izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna.

DeniedBySystemPolicy 6

Pada perangkat yang memiliki baterai, pengguna telah memilih Baterai yang Dioptimalkan dalam pengaturan penggunaan baterai dan sistem telah memilih untuk tidak mengizinkan aplikasi ini berjalan di latar belakang berdasarkan sumber daya sistem. Diperkenalkan dalam Windows 10, versi 1607.

DeniedByUser 7

Pada perangkat yang memiliki baterai, pengguna telah menonaktifkan aplikasi agar tidak berjalan di latar belakang di pengaturan penggunaan baterai. Diperkenalkan dalam Windows 10, versi 1607.

Unspecified 0

Aplikasi tidak dapat melakukan aktivitas latar belakang dalam status ini.

Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna tidak memilih "izinkan" atau "jangan izinkan" dalam kotak dialog, atau menutupnya tanpa membuat pilihan.

Keterangan

Pada perangkat yang tidak memiliki baterai, pengaturan yang memungkinkan aplikasi untuk menggunakan aktivitas latar belakang ditemukan di pengaturan aplikasi latar belakang. Pada perangkat yang memiliki baterai, pengaturan tugas latar belakang dapat ditemukan di pengaturan penggunaan Baterai.

Deklarasikan kemampuan RTC dalam manifes aplikasi Anda dengan menentukan tugas latar belakang saluran Kontrol di tab Deklarasi . Untuk informasi selengkapnya, lihat Cara mengatur opsi konektivitas latar belakang.

Jika semua slot RTC perangkat keras penuh pada saat aplikasi ditambahkan ke layar kunci, dan jika aplikasi telah menentukan saluran Kontrol dalam manifesnya, bersama dengan Timer atau pemberitahuan Push, aplikasi ditambahkan ke layar kunci, tetapi tanpa kemampuan RTC. Aplikasi kemudian dapat membuat permintaan lebih lanjut untuk ditambahkan ke layar kunci, yang tidak menyajikan UI kepada pengguna. Jika slot perangkat keras terbuka ketika satu permintaan tersebut dibuat, aplikasi akan mengambil slot tersebut.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 AllowedSubjectToSystemPolicy
1607 14393 AlwaysAllowed
1607 14393 DeniedBySystemPolicy
1607 14393 DeniedByUser

Berlaku untuk

Lihat juga