XStoreProductsQueryNextPageAsync

Article
06/22/2023

Gets the next page of query results.

Syntax

HRESULT XStoreProductsQueryNextPageAsync(  
         const XStoreProductQueryHandle productQueryHandle,  
         XAsyncBlock* async  
)

Parameters

productQueryHandle _In_
Type: XStoreProductQueryHandle

The handle to the query to check for more pages. On the first call to XStoreProductsQueryHasMorePages, this will be the XStoreProductQueryHandle returned by XStoreQueryProductForCurrentGameResult, XStoreQueryProductForPackageResult.md, XStoreQueryEntitledProductsResult, XStoreQueryProductsAsync, or XStoreQueryProductsResult. On subsequent calls, the query handle returned by XStoreProductsQueryNextPageResult should be used.

async _Inout_
Type: XAsyncBlock*

An XAsyncBlock defining the asynchronous work being done. The XAsyncBlock can be used to poll for the call's status and retrieve call results. See XAsyncBlock for more information.

Return value

Type: HRESULT

HRESULT success or error code.

Remarks

This function is used to query for additional product information after a product query has been enumerated with XStoreEnumerateProductsQuery. Before calling this function you should check for the existence of additional product query information by calling XStoreProductsQueryHasMorePages. To retrieve the next page of query results as well as the execution result of this function call XStoreProductsQueryNextPageResult after calling this 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