StoreContext.RequestDownloadAndInstallStorePackagesAsync 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í.
Sobrecargas
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados 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. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados para la aplicación actual de Microsoft Store, con las opciones de instalación especificadas. 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. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados 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> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function requestDownloadAndInstallStorePackagesAsync(storeIds)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parámetros
Los identificadores de la Tienda de los paquetes de complementos DLC que se van a instalar.
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
Use este método para descargar e instalar nuevos paquetes DLC para la aplicación actual. Cuando se llama a este método, el sistema operativo muestra un cuadro de diálogo que indica al usuario que un paquete de aplicación está disponible para descargar e instalar, y pide al usuario permiso para continuar con la operación. Si el usuario no concede permiso, la propiedad OverallState del valor devuelto StorePackageUpdateResult tiene el valor Cancelado. Para instalar silenciosamente un paquete de aplicación sin mostrar un cuadro de diálogo de notificación, use DownloadAndInstallStorePackagesAsync (este método requiere acceso a una funcionalidad restringida).
El id. de la Tienda de un complemento DLC está disponible en el Centro de partners y también lo devuelve la propiedad StoreId del StoreProduct que representa el complemento DLC. Para obtener más información, consulta Identificadores de la Tienda.
Esta operación no se bloqueará. El objeto IAsyncOperationWithProgress devuelto por este método se completará una vez descargados e instalados los paquetes.
El método que asigne para controlar las notificaciones de progreso se llama una vez para cada paso del proceso de descarga e instalación de cada paquete de esta solicitud. El controlador Progress recibe un argumento StorePackageUpdateStatus que proporciona información sobre el paquete que generó la notificación de progreso.
Nota:
Los paquetes de contenido descargable (DLC) no están disponibles para todas las cuentas de desarrollador.
Consulte también
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Creación de paquetes opcionales y conjuntos relacionados
Se aplica a
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
Intenta descargar e instalar los paquetes de contenido descargable (DLC) especificados para la aplicación actual de Microsoft Store, con las opciones de instalación especificadas. 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> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parámetros
Los identificadores de la Tienda de los paquetes de complementos DLC que se van a instalar.
- storePackageInstallOptions
- StorePackageInstallOptions
Objeto que especifica las opciones de instalación de la operación.
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.
Requisitos de Windows
| Familia de dispositivos |
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (se introdujo en la versión v3.0)
|
Comentarios
Use este método para descargar e instalar nuevos paquetes DLC para la aplicación actual. Esta sobrecarga proporciona la opción de especificar si el sistema operativo puede forzar que la aplicación se reinicie después de instalar los paquetes DLC estableciendo la propiedad AllowForcedAppRestart del parámetro storePackageInstallOptions .
Cuando se llama a este método, el sistema operativo muestra un cuadro de diálogo que indica al usuario que un paquete de aplicación está disponible para descargar e instalar, y pide al usuario permiso para continuar con la operación. Si el usuario no concede permiso, la propiedad OverallState del valor devuelto StorePackageUpdateResult tiene el valor Cancelado. Para instalar silenciosamente un paquete de aplicación sin mostrar un cuadro de diálogo de notificación, use DownloadAndInstallStorePackagesAsync (este método requiere acceso a una funcionalidad restringida).
El id. de la Tienda de un complemento DLC está disponible en el Centro de partners y también lo devuelve la propiedad StoreId del StoreProduct que representa el complemento DLC. Para obtener más información, consulta Identificadores de la Tienda.
Esta operación no se bloqueará. El objeto IAsyncOperationWithProgress devuelto por este método se completará una vez descargados e instalados los paquetes.
El método que asigne para controlar las notificaciones de progreso se llama una vez para cada paso del proceso de descarga e instalación de cada paquete de esta solicitud. El controlador Progress recibe un argumento StorePackageUpdateStatus que proporciona información sobre el paquete que generó la notificación de progreso.
Nota:
Los paquetes DLC no están disponibles para todas las cuentas de desarrollador.
Consulte también
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Creación de paquetes opcionales y conjuntos relacionados
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de