Skip to main content

XStoreDownloadPackageUpdatesAsync

Descarga las actualizaciones de los paquetes especificados sin instalarlas. Esto permite que su juego controle cuándo se produce la instalación de las actualizaciones para evitar que el juego se cierre mientras el usuario está jugando.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Tipo: char**
Lista de identificadores de paquete. Un identificador de paquete es una cadena de identificación única para 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). packageIdentifiersCount   _In_
Tipo: size_t
El número de identificadores en packageIdentifiers. 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 Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error.

Comentarios

Esta función solo descarga una actualización, pero no la instala. Para descargar e instalar una actualización en una sola llamada, use la función XStoreDownloadAndInstallPackageUpdatesAsync. Para recuperar el resultado de esta función, llame a XStoreDownloadPackageUpdatesResult después de llamar a esta función. Consulte XStoreQueryGameAndDlcPackageUpdatesAsync para ver un ejemplo de uso. Cuando se llama a esta API desde un juego en ejecución, las descargas se consideran de prioridad alta y se colocan al principio de la cola en el orden en el que se especifican en el parámetro storeIds de esta API.

Requisitos

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

Consulte también

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
Última modificación el 28 de agosto de 2026