Skip to main content

XStoreDownloadAndInstallPackagesAsync

Descarga e instala los paquetes de la tienda especificados.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. storeIds   _In_z_count_(storeIdsCount)
Tipo: char**
Lista de cadenas de identificadores de paquete. Un identificador de paquete identifica de forma única un paquete de Microsoft Store. Para obtener más información sobre los identificadores de paquete, consulte Administración y concesión de licencias de contenido descargable (DLC). storeIdsCount   _In_
Tipo: size_t
El número de identificadores en storeIds. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Consulte XAsyncBlock para obtener más información.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

Para recuperar el resultado de descarga e instalación de esta función, llame a XStoreDownloadAndInstallPackagesResult después de llamar a esta función. Para recuperar el número de elementos descargados e instalados, llame a XStoreDownloadAndInstallPackagesResultCount después de llamar a esta función. La función de recuento de resultados es importante, ya que le permitirá determinar el tamaño adecuado de la matriz que se pasará a la función de resultado. Cuando se llama a esta API desde un juego en ejecución, las descargas se consideran de alta prioridad y se colocan al principio de la cola en el orden en que se especifican en el parámetro storeIds de esta API. El siguiente fragmento de código muestra un ejemplo de descarga e instalación de paquetes de la tienda.

Requisitos

Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XStore
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
Última modificación el 28 de agosto de 2026