StoreContext.RequestDownloadStorePackageUpdatesAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Services.Store
Edit

Mencoba mengunduh pembaruan paket yang ditentukan untuk aplikasi saat ini dari Microsoft Store. Metode ini juga menampilkan dialog UI yang meminta izin untuk operasi.

Penting

Metode ini harus dipanggil pada utas UI.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);
function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)
Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

Parameter

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

Kumpulan objek StorePackageUpdate yang mewakili paket yang diperbarui untuk diunduh.

Mengembalikan

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

Objek yang dapat diamati pemanggil untuk melacak kemajuan dan penyelesaian operasi. Setelah berhasil diselesaikan, hasilnya adalah objek StorePackageUpdateResult yang menyediakan info tentang pembaruan paket.

Atribut
RemoteAsyncAttribute

Pengecualian

COMException

Jika properti ErrorCode pengecualian memiliki nilai 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), ini menunjukkan bahwa metode tidak dipanggil pada utas UI. Jika Anda memanggil metode ini dalam aplikasi desktop yang menggunakan Desktop Bridge, ini juga dapat menunjukkan bahwa Anda tidak mengonfigurasi <objek xref:Windows.Services.Store.StoreContext?text=StoreContext> untuk menentukan jendela aplikasi mana yang merupakan jendela pemilik untuk dialog modal yang ditunjukkan oleh metode ini. Untuk informasi selengkapnya, lihat artikel ini.

Keterangan

Untuk mendapatkan daftar paket yang memiliki pembaruan yang tersedia, gunakan metode GetAppAndOptionalStorePackageUpdatesAsync . Setelah mengunduh paket, Anda dapat menginstalnya dengan menggunakan metode RequestDownloadAndInstallStorePackageUpdatesAsync . Untuk informasi selengkapnya tentang menggunakan metode ini, termasuk contoh kode, lihat Mengunduh dan menginstal pembaruan paket untuk aplikasi Anda.

Operasi ini tidak akan memblokir. Objek IAsyncOperationWithProgress yang dikembalikan oleh metode ini akan selesai setelah paket pembaruan diunduh.

Saat Anda memanggil metode ini, OS menampilkan dialog yang memberi tahu pengguna bahwa pembaruan aplikasi tersedia untuk diunduh dan meminta izin pengguna untuk melanjutkan pengunduhan. Jika pengguna tidak memberikan izin untuk memulai pengunduhan, properti OverallState dari nilai pengembalian StorePackageUpdateResult memiliki nilai Dibatalkan.

Metode yang Anda tetapkan untuk menangani pemberitahuan Kemajuan dipanggil satu kali untuk setiap langkah dalam proses pengunduhan untuk setiap paket dalam permintaan ini. Handler Kemajuan menerima argumen StorePackageUpdateStatus yang menyediakan info tentang paket pembaruan yang memunculkan pemberitahuan kemajuan.

Berlaku untuk

Lihat juga