Compartir a través de


StoreContext.RequestDownloadAndInstallStorePackagesAsync Método

Definición

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

Se aplica a