Skip to main content

XStoreQueryProductsAsync

Retorna informações de listagem para os produtos especificados que estão associados ao jogo atual, independentemente de os produtos estarem disponíveis para compra dentro do jogo.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. productKinds   _In_
Tipo: XStoreProductKind
Os tipos de produtos a serem retornados. storeIds   _In_z_count_(storeIdsCount)
Tipo: char**
Os identificadores da loja dos produtos a serem recuperados. storeIdsCount   _In_
Tipo: size_t
O número de produtos na lista de storeIds. Esse número não deve exceder 100. actionFilters   _In_opt_z_count_(actionFiltersCount)
Tipo: char**
Restringe os resultados por alguma ação armazenada no documento do produto. Por padrão, esta API retorna todos os produtos, mesmo que não possam ser comprados, mas você pode usar filtros de ação para restringir os resultados. Por exemplo, use “Purchase” se quiser apenas produtos que podem ser comprados, ou “License” se quiser apenas produtos licenciáveis. Outros filtros de ação incluem “Fulfill”, “Browse”, “Curate”, “Details” e “Redeem”. actionFiltersCount   _In_
Tipo: size_t
O número de filtros em actionFilters. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. Use o XAsyncBlock para verificar o status da chamada e obter os resultados. Para obter mais informações, confira XAsyncBlock.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

Chame XStoreQueryProductsResult para recuperar as informações de listagem e o resultado da execução desta função. Esta API falhará se você fornecer mais de 100 storeIDs na solicitação. Se você estiver trabalhando com um catálogo grande, limite cada consulta a menos de 100 produtos. Para obter detalhes de todos os produtos que os jogadores podem comprar dentro do jogo atual, use XStoreQueryAssociatedProductsAsync. O snippet de código a seguir mostra um exemplo de recuperação de informações de listagem para os produtos especificados que estão associados ao jogo atual.

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 XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Operações básicas da loja
Conceder aos jogadores acesso ao conteúdo de complementos
Last modified on October 6, 2026