Skip to main content

XStoreQueryProductsAsync

Devuelve información de descripción de los productos especificados que están asociados al juego actual, independientemente de si los productos están disponibles para su compra dentro del juego.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. productKinds   _In_
Tipo: XStoreProductKind
Los tipos de productos que se devolverán. storeIds   _In_z_count_(storeIdsCount)
Tipo: char**
Los identificadores de la tienda de los productos que se recuperarán. storeIdsCount   _In_
Tipo: size_t
El número de productos en la lista de storeIds. Este número no debe superar los 100. actionFilters   _In_opt_z_count_(actionFiltersCount)
Tipo: char**
Restringe los resultados según alguna acción almacenada en el documento del producto. De forma predeterminada, esta API devuelve todos los productos, incluso si no se pueden comprar, pero puede usar filtros de acción para restringir los resultados. Por ejemplo, use “Purchase” si solo quiere productos que se puedan comprar, o “License” si solo quiere productos que se puedan licenciar. Otros filtros de acción incluyen “Fulfill”, “Browse”, “Curate”, “Details” y “Redeem”. actionFiltersCount   _In_
Tipo: size_t
El número de filtros en actionFilters. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. Use el XAsyncBlock para comprobar el estado de la llamada y obtener los resultados. Para obtener más información, consulte XAsyncBlock.

Valor devuelto

Tipo: HRESULT Código HRESULT de éxito o de error.

Comentarios

Llame a XStoreQueryProductsResult para recuperar la información de descripción y el resultado de ejecución de esta función. Esta API genera un error si proporciona más de 100 storeIDs en la solicitud. Si trabaja con un catálogo grande, limite cada consulta a menos de 100 productos. Para obtener detalles de todos los productos que los jugadores pueden comprar dentro del juego actual, use XStoreQueryAssociatedProductsAsync en su lugar. El siguiente fragmento de código muestra un ejemplo de recuperación de información de descripción de los productos especificados que están asociados al juego actual.

Requisitos

Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XStore XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Operaciones básicas de la tienda
Concesión a los jugadores de acceso a contenido de complementos
Última modificación el 28 de agosto de 2026