StoreContext.DownloadAndInstallStorePackagesAsync 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í.
Descarga e instala los paquetes de contenido descargable (DLC) especificados para la aplicación actual desde Microsoft Store sin mostrar un cuadro de diálogo de interfaz de usuario de notificación al usuario.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ DownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = DownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function downloadAndInstallStorePackagesAsync(storeIds)
Public Function DownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)
Parámetros
Los identificadores de la Tienda de los complementos que corresponden a los paquetes DLC que se van a instalar para la aplicación actual.
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
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)
|
Características de aplicaciones |
storePackageManagement
|
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 descarga e instala de forma silenciosa los paquetes sin mostrar un cuadro de diálogo de notificación. Este método requiere la funcionalidad storePackageManagement restringida para realizar esta operación. Si no tiene acceso a esta funcionalidad restringida, puede usar los métodos RequestDownloadAndInstallStorePackagesAsync en su lugar (estos métodos muestran un cuadro de diálogo de notificación que solicita el permiso del usuario para instalar el paquete).
Nota
Los paquetes DLC no están disponibles para todas las cuentas de desarrollador.
Nota
La funcionalidad restricted storePackageManagement solo está disponible para aplicaciones de escritorio y juegos que usan el Puente de dispositivo de escritorio y para juegos xbox que usan paquetes XVC y se desarrollan como parte de un programa de asociados administrados, como el programa de ID@Xbox. Estas aplicaciones y juegos tienen esta funcionalidad de forma predeterminada.
El id. de la Tienda de un complemento 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.