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 unXStoreProductQueryHandle 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.
-
Los desarrolladores ejecutan
XPackageEnumeratePackagespara enumerar los productos XPackageKind::Game instalados y, después, para uno de esos juegos, ejecutanXStoreQueryAssociatedProductsForStoreIdAsynccon el storeId obtenido deXPackageDetails. Los desarrolladores ejecutanXPackageEnumeratePackagespara 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
XStoreQueryAssociatedProductsAsyncpara obtener una lista de los productos que se pueden comprar asociados al juego actual. Después, con el storeId delXStoreProductdel juego de destino, los desarrolladores ejecutanXStoreQueryAssociatedProductsForStoreIdAsyncpara averiguar qué DLC están asociados a él.
Requisitos
Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
Consulte también
XStoreXStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
