StoreContext.RequestDownloadStorePackageUpdatesAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Intenta descargar las actualizaciones de paquetes especificadas para la aplicación actual desde Microsoft Store. Este método también muestra un cuadro de diálogo de interfaz de usuario que solicita permiso para la operación.
Importante
Se debe llamar a este método en el subproceso de la interfaz de usuario.
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)Parámetros
- storePackageUpdates
Conjunto de objetos StorePackageUpdate que representan los paquetes actualizados que se van a descargar.
Devoluciones
Objeto que el autor de la llamada puede observar para realizar un seguimiento del progreso y la finalización de la operación. Al finalizar correctamente, el resultado es un objeto StorePackageUpdateResult que proporciona información sobre las actualizaciones del paquete.
- Atributos
Excepciones
Si la propiedad ErrorCode de la excepción tiene el valor 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), esto indica que no se llamó al método en el subproceso de la interfaz de usuario. Si llamas a este método en una aplicación de escritorio que usa el Puente de dispositivo de escritorio, esto también puede indicar que no has configurado el <objeto xref:Windows.Services.Store.StoreContext?text=StoreContext> para especificar qué ventana de aplicación es la ventana propietaria de los diálogos modales mostrados por este método. Para obtener más información, consulte este artículo.
Comentarios
Para obtener la lista de paquetes que tienen actualizaciones disponibles, use el método GetAppAndOptionalStorePackageUpdatesAsync . Después de descargar los paquetes, puede instalarlos mediante el método RequestDownloadAndInstallStorePackageUpdatesAsync . Para obtener más información sobre el uso de este método, incluido un ejemplo de código, consulta Descargar e instalar actualizaciones de paquetes para la aplicación.
Esta operación no se bloqueará. El objeto IAsyncOperationWithProgress devuelto por este método se completará una vez descargados los paquetes de actualización.
Cuando se llama a este método, el sistema operativo muestra un cuadro de diálogo que indica al usuario que hay disponible una actualización de la aplicación para descargar y pide al usuario permiso para continuar con la descarga. Si el usuario no concede permiso para iniciar la descarga, la propiedad OverallState del valor devuelto StorePackageUpdateResult tiene el valor Cancelado.
El método que asigne para controlar las notificaciones de progreso se llama una vez para cada paso del proceso de descarga de cada paquete de esta solicitud. El controlador Progress recibe un argumento StorePackageUpdateStatus que proporciona información sobre el paquete de actualización que generó la notificación de progreso.