メインコンテンツへスキップ

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 でテストしてください。詳細については、ページングを参照してください。
このクエリが返す製品の数を事前に知ることはできません。 この API を使用して、ストア ID を使用してターゲット製品に関連付けられたアドオンを検索します。 この機能は、特にフランチャイズ ゲーム ハブに便利です。フランチャイズ ゲーム ハブでは複数のゲームのアドオンを列挙できますが、これらのアドオンがどのゲームに関連付けられているかを判別できません。 使用シナリオの例:
  • 開発者は XPackageEnumeratePackages を実行してインストール済みの XPackageKind::Game 製品を列挙し、その中の 1 つのゲームに対して、XPackageDetails から取得した storeId を使用して XStoreQueryAssociatedProductsForStoreIdAsync を実行します。開発者は XPackageKind::Content 用に XPackageEnumeratePackages を実行してインストール済み DLC を列挙します。コンテンツ列挙と製品クエリの結果を相互参照することで、開発者は特定のゲームにどの DLC がインストールされているかを識別できるようになります。
  • 開発者は XStoreQueryAssociatedProductsAsync を実行して現在のゲームに関連付けられている購入可能な製品のリストを取得します。次に、ターゲット ゲームの XStoreProduct の storeId を使用して XStoreQueryAssociatedProductsForStoreIdAsync を実行し、関連付けられている DLC を調べます。
次のコード スニペットは、ストア ID を使用してターゲット製品に関連付けられた製品をクエリする例を示しています。 結果は複数のページにわたって処理されます。

要件

ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ本体、および XBOX Series 本体

関連概念ドキュメント

関連項目

XStore
XStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
最終更新日 2026年10月19日