Skip to main content

XStoreQueryAssociatedProductsForStoreIdAsync

Obtém informações da listagem da loja para produtos que podem ser comprados relacionados a um produto de destino especificado pela sua Store ID.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. storeId   _In_
Tipo: const char*
A Store ID do produto para o qual os produtos associados são recuperados. productKinds   _In_
Tipo: XStoreProductKind
O tipo de produtos a serem retornados. maxItemsToRetrievePerPage   _In_
Tipo: uint32_t
O número máximo de itens a serem recuperados por página. O número de itens retornados por página pode variar de 0 a maxItemsToRetrievePerPage. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo realizado. Use o XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada. Para obter mais informações, consulte XAsyncBlock.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.

Comentários

Para obter as informações da listagem da loja e o resultado da execução desta função, chame XStoreQueryAssociatedProductsForStoreIdResult depois de chamar esta função. XStoreQueryAssociatedProductsForStoreIdResult contém um XStoreProductQueryHandle que é enumerado chamando XStoreEnumerateProductsQuery.
Esta API oferece suporte ao mesmo padrão de paginação descrito em XStoreQueryAssociatedProductsAsync.A paginação pode se comportar de forma diferente entre áreas restritas e RETAIL. Verifique sua implementação de paginação e não deixe de testar em RETAIL antes do lançamento.Para obter mais informações, consulte Paginação.
Não é possível saber antecipadamente o número de produtos que esta consulta retorna. Use a API para encontrar complementos associados a um produto de destino usando a Store ID dele. Essa capacidade é especialmente útil para hubs de jogos de franquia. Um hub de jogos de franquia pode enumerar complementos de vários jogos, mas não consegue saber a qual jogo esses complementos estão associados. Exemplos de cenários de uso:
  • Os desenvolvedores executam XPackageEnumeratePackages para enumerar os produtos XPackageKind::Game instalados e, em seguida, para um desses jogos, executam XStoreQueryAssociatedProductsForStoreIdAsync usando a storeId obtida de XPackageDetails. Os desenvolvedores executam XPackageEnumeratePackages para XPackageKind::Content para enumerar o DLC instalado. Os resultados da enumeração de conteúdo e da consulta de produtos são cruzados para que os desenvolvedores possam identificar quais DLCs estão instalados para o jogo específico.
  • Os desenvolvedores executam XStoreQueryAssociatedProductsAsync para obter uma lista de produtos que podem ser comprados associados ao jogo atual. Em seguida, usando a storeId do XStoreProduct do jogo de destino, os desenvolvedores executam XStoreQueryAssociatedProductsForStoreIdAsync para descobrir quais DLCs estão associados a ele.
O snippet de código a seguir mostra um exemplo de consulta de produtos associados a um produto de destino usando a Store ID dele. Os resultados são processados em várias páginas.

Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XStore
XStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Last modified on October 6, 2026