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 SeriesDocumentación conceptual
- Operaciones básicas de la tienda
- Concesión a los jugadores de acceso a contenido de complementos
- Limitación de frecuencia pormenorizada para las API de Microsoft Store
Consulte también
XStore XStoreQueryProductsResultXStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Operaciones básicas de la tienda
Concesión a los jugadores de acceso a contenido de complementos
