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 SeriesDocumentação conceitual
- Operações básicas da loja
- Conceder aos jogadores acesso ao conteúdo de complementos
- Limitação de taxa refinada para APIs da Microsoft Store
Confira também
XStore XStoreQueryProductsResultXStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Operações básicas da loja
Conceder aos jogadores acesso ao conteúdo de complementos
