XStoreProductsQueryNextPageResult

Article
06/22/2023

Gets the next page of results from a product query.

Syntax

HRESULT XStoreProductsQueryNextPageResult(  
         XAsyncBlock* async,  
         XStoreProductQueryHandle* productQueryHandle  
)

Parameters

async _Inout_
Type: XAsyncBlock*

The XAsyncBlock that was passed to XStoreQueryProductForCurrentGameResult or XStoreQueryProductForPackageResult.md. The XAsyncBlock can be used to poll for the call's status and retrieve call results. See XAsyncBlock for more information.

productQueryHandle _Out_
Type: XStoreProductQueryHandle*

On return contains a query handle pointing to the next page of the query. The returned query handle is used to keep track of the current page of results for the query and should be used in the next call to XStoreProductsQueryHasMorePages and XStoreProductsQueryNextPageAsync.

Return value

Type: HRESULT

S_OK on success; otherwise, returns an error code.

Remarks

This result function allows you to retrieve the execution results of XStoreProductsQueryNextPageAsync, as well as the next page of query results that was called for if the execution was successful. As such, this function should be called after XStoreProductsQueryNextPageAsync has been called, usually in the context of a callback function. See XStoreQueryAssociatedProductsAsync for a usage example.

Requirements

Header: XStore.h (included in XGameRuntime.h)

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles

Share via