Saltar al contenido principal

XStoreQueryAssociatedProductsAsync

Obtiene información de descripción de la Store de los productos que los usuarios pueden comprar desde dentro del juego actual.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. 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. Para obtener más información, consulte Paginación. 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 XStoreQueryAssociatedProductsResult después de llamar a esta función. XStoreQueryAssociatedProductsResult contiene un XStoreProductQueryHandle que se enumera llamando a XStoreEnumerateProductsQuery. No es posible conocer de antemano el número de productos que devuelve esta consulta. Esta API solo devuelve productos que los usuarios pueden examinar en Microsoft Store o comprar dentro del juego. Los resultados no incluyen ningún producto que esté oculto, expirado o eliminado de la tienda. Si necesita detalles de un producto de este tipo, use XStoreQueryProductsAsync y pase el identificador de la tienda del producto.

Paginación

Esta función devuelve productos en varias páginas (hasta maxItemsToRetrievePerPage elementos en una sola página). Use XStoreProductsQueryHasMorePages y XStoreProductsQueryNextPageAsync/XStoreProductsQueryNextPageResult para procesar todos los resultados paginados. La paginación no está completa hasta que XStoreProductsQueryHasMorePages devuelve false.
La paginación puede comportarse de forma diferente entre los sandboxes y RETAIL. En un sandbox, los elementos se acumulan hasta maxItemsToRetrievePerPage antes de que se devuelva una página. En RETAIL, es habitual que se devuelvan de 0 a 1 elementos por página.Es importante que todos los juegos que usen esta API implementen y prueben la paginación antes del lanzamiento.Para probar el comportamiento de la paginación en un sandbox, establezca temporalmente maxItemsToRetrievePerPage en un valor inferior al número de productos publicados en su sandbox. Para probar en RETAIL antes del lanzamiento de su juego, publique productos con la opción Enable Private Audience de la página ‘Pricing and availability’ de Partner Center. Para probar en RETAIL después del lanzamiento de su juego, use un paquete piloto.
El código siguiente muestra cómo recuperar resultados de consultas de productos en varias páginas. Asegúrese de que el identificador de consulta se pase a través de la recursión de paginación para evitar pérdidas.

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
XStoreQueryAssociatedProductsResult
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Operaciones básicas de la tienda
Concesión a los jugadores de acceso al contenido de complementos
Última modificación el 19 de octubre de 2026