Saltar al contenido principal

XStoreQueryAssociatedProductsForStoreIdAsync

Obtiene información de descripción de la Store de los productos que se pueden comprar relacionados con un producto de destino especificado por su identificador de la tienda.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. storeId   _In_
Tipo: const char*
El identificador de la tienda del producto para el que se recuperan los productos asociados. productKinds   _In_
Tipo: XStoreProductKind
El tipo de productos que se van a devolver. maxItemsToRetrievePerPage   _In_
Tipo: uint32_t
El número máximo de elementos que se recuperarán por página. El número de elementos devueltos por página puede variar de 0 a maxItemsToRetrievePerPage. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. 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 HRESULT de operación correcta o código de error.

Comentarios

Para obtener la información de descripción de la Store y el resultado de la ejecución de esta función, llame a XStoreQueryAssociatedProductsForStoreIdResult después de llamar a esta función. XStoreQueryAssociatedProductsForStoreIdResult contiene un XStoreProductQueryHandle que se enumera llamando a XStoreEnumerateProductsQuery.
Esta API admite el mismo patrón de paginación que se describe en XStoreQueryAssociatedProductsAsync.La paginación puede comportarse de forma diferente entre los sandboxes y RETAIL. Compruebe su implementación de la paginación y asegúrese de probarla en RETAIL antes del lanzamiento.Para obtener más información, consulte Paginación.
No es posible conocer de antemano el número de productos que devuelve esta consulta. Use la API para encontrar complementos asociados a un producto de destino mediante su identificador de la tienda. Esta capacidad es especialmente útil para los Franchise Game Hubs. Un Franchise Game Hub puede enumerar complementos de varios juegos, pero no puede indicar a qué juego están asociados estos complementos. Ejemplos de escenarios de uso:
  • Los desarrolladores ejecutan XPackageEnumeratePackages para enumerar los productos XPackageKind::Game instalados y, después, para uno de esos juegos, ejecutan XStoreQueryAssociatedProductsForStoreIdAsync con el storeId obtenido de XPackageDetails. Los desarrolladores ejecutan XPackageEnumeratePackages para XPackageKind::Content para enumerar los DLC instalados. Los resultados de la enumeración de contenido y de la consulta de productos se cruzan para que los desarrolladores puedan identificar ahora qué DLC están instalados para el juego específico.
  • Los desarrolladores ejecutan XStoreQueryAssociatedProductsAsync para obtener una lista de los productos que se pueden comprar asociados al juego actual. Después, con el storeId del XStoreProduct del juego de destino, los desarrolladores ejecutan XStoreQueryAssociatedProductsForStoreIdAsync para averiguar qué DLC están asociados a él.
El siguiente fragmento de código muestra un ejemplo de consulta de productos asociados a un producto de destino mediante su identificador de la tienda. Los resultados se procesan en varias páginas.

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
XStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Última modificación el 19 de octubre de 2026