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 umXStoreProductQueryHandle 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.
-
Os desenvolvedores executam
XPackageEnumeratePackagespara enumerar os produtos XPackageKind::Game instalados e, em seguida, para um desses jogos, executamXStoreQueryAssociatedProductsForStoreIdAsyncusando a storeId obtida deXPackageDetails. Os desenvolvedores executamXPackageEnumeratePackagespara 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
XStoreQueryAssociatedProductsAsyncpara obter uma lista de produtos que podem ser comprados associados ao jogo atual. Em seguida, usando a storeId doXStoreProductdo jogo de destino, os desenvolvedores executamXStoreQueryAssociatedProductsForStoreIdAsyncpara descobrir quais DLCs estão associados a ele.
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 SeriesDocumentação conceitual
Confira também
XStoreXStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
