Skip to main content

XStoreQueryPackageUpdatesAsync

Recupera una lista de las actualizaciones disponibles para los paquetes especificados en el argumento. Use esta lista para descargar e instalar las actualizaciones.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario devuelto por XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Tipo: char**
Lista de cadenas de identificador 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). packageIdentifiersCount   _In_
Tipo: size_t
El número de identificadores de packageIdentifiers. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico. Use el XAsyncBlock para sondear el estado de la llamada y recuperar los resultados de la llamada. Para obtener más información, consulte XAsyncBlock.

Valor devuelto

Tipo: HRESULT Código de error o de operación correcta HRESULT.

Comentarios

Para obtener el identificador de paquete del juego que se está ejecutando actualmente, use XPackageGetCurrentProcessPackageIdentifier, o bien use XPackageEnumeratePackages para obtener los identificadores de paquete de los DLC y los juegos relacionados. Para recuperar la lista de actualizaciones disponibles y el resultado de la ejecución de esta función, llame a XStoreQueryPackageUpdatesResult después de llamar a esta función. Para obtener el número de actualizaciones que se van a recuperar, llame a XStoreQueryPackageUpdatesResultCount después de llamar a esta función. La función de recuento de resultados es importante, ya que le permite determinar el tamaño adecuado de la matriz que se debe pasar a la función de resultado. El siguiente fragmento de código muestra un ejemplo de cómo recuperar las actualizaciones del juego y las actualizaciones opcionales de los paquetes especificados.

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
XStoreQueryPackageUpdatesResult
XStoreQueryPackageUpdatesResultCount
Última modificación el 28 de agosto de 2026