XStoreQueryAssociatedProductsForStoreIdAsync
ストア ID で指定されたターゲット製品に関連する、購入可能な製品のストア登録情報を取得します。構文
パラメーター
storeContextHandle _In_Type: XStoreContextHandle XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 storeId _In_
Type: const char* 関連製品を取得する対象の製品のストア ID。 productKinds _In_
Type: XStoreProductKind 返す製品の種類。 maxItemsToRetrievePerPage _In_
Type: uint32_t 1 ページあたりに取得する項目の最大数。 1 ページあたりに返される項目の数は、0 から
maxItemsToRetrievePerPage まで異なる場合があります。
async _Inout_Type: XAsyncBlock* 実行中の非同期処理を定義する XAsyncBlock。 XAsyncBlock を使用して、呼び出しの状態のポーリングと呼び出し結果の取得を行います。 詳細については、XAsyncBlock を参照してください。
戻り値
Type: HRESULT HRESULT の成功またはエラー コード。解説
この関数のストア登録情報と実行結果を取得するには、この関数を呼び出した後に XStoreQueryAssociatedProductsForStoreIdResult を呼び出します。 XStoreQueryAssociatedProductsForStoreIdResult には、XStoreEnumerateProductsQuery を呼び出して列挙するXStoreProductQueryHandle が含まれます。
この API は XStoreQueryAssociatedProductsAsync で説明されているのと同じページング パターンをサポートします。ページングは、サンドボックスと RETAIL の間で動作が異なる場合があります。
ページング実装を検証し、リリース前に必ず RETAIL でテストしてください。詳細については、ページングを参照してください。
-
開発者は
XPackageEnumeratePackagesを実行してインストール済みの XPackageKind::Game 製品を列挙し、その中の 1 つのゲームに対して、XPackageDetailsから取得した storeId を使用してXStoreQueryAssociatedProductsForStoreIdAsyncを実行します。開発者は XPackageKind::Content 用にXPackageEnumeratePackagesを実行してインストール済み DLC を列挙します。コンテンツ列挙と製品クエリの結果を相互参照することで、開発者は特定のゲームにどの DLC がインストールされているかを識別できるようになります。 -
開発者は
XStoreQueryAssociatedProductsAsyncを実行して現在のゲームに関連付けられている購入可能な製品のリストを取得します。次に、ターゲット ゲームのXStoreProductの storeId を使用してXStoreQueryAssociatedProductsForStoreIdAsyncを実行し、関連付けられている DLC を調べます。
要件
ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ本体、および XBOX Series 本体関連概念ドキュメント
関連項目
XStoreXStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
