Skip to main content

XStoreEnumerateProductsQuery

Enumera os resultados de uma consulta de produtos.

Sintaxe

Parâmetros

productQueryHandle   _In_
Tipo: XStoreProductQueryHandle
O identificador da consulta cujos resultados serão enumerados. XStoreProductQueryHandle é retornado por XStoreQueryProductForCurrentGameResult, XStoreQueryProductForPackageResult.md, XStoreQueryEntitledProductsResult, XStoreQueryAssociatedProductsAsync e XStoreQueryProductsResult. context   _In_opt_
Tipo: void*
Contexto definido pelo jogo a ser passado para o retorno de chamada. callback   _In_
Tipo: XStoreProductQueryCallback*
Retorno de chamada definido pelo jogo a ser chamado para cada produto.

Valor retornado

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

Comentários

É seguro chamar esta função em um thread sensível ao tempo. Esta função é usada para enumerar os produtos retornados por uma função que solicita informações de produto. Se necessário, depois de solicitar a enumeração dos produtos, use a função XStoreProductsQueryHasMorePages para verificar se há mais informações de produto. Se houver mais informações de produto a serem lidas, use XStoreProductsQueryNextPageAsync para lê-las. Consulte XStoreQueryAssociatedProductsAsync para obter um exemplo de uso.

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
XStoreQueryAssociatedProductsAsync
XStoreQueryProductsResult
XStoreProductQueryCallback
Last modified on October 6, 2026