XStoreQueryProductsAsync
現在のゲームに関連付けられている指定された製品の掲載情報を、それらがゲーム内で購入可能かどうかに関係なく返します。構文
パラメーター
storeContextHandle _In_Type: XStoreContextHandle XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 productKinds _In_
Type: XStoreProductKind 返す製品の種類。 storeIds _In_z_count_(storeIdsCount)
Type: char** 取得する製品のストア識別子。 storeIdsCount _In_
Type: size_t storeIds のリスト内の製品数。 この数は 100 を超えないようにする必要があります。 actionFilters _In_opt_z_count_(actionFiltersCount)
Type: char** 製品ドキュメントに保存されている何らかのアクションで結果を制限します。 既定では、この API は購入不可能な製品を含むすべての製品を返しますが、アクション フィルターを使用して結果を制限できます。 たとえば、購入可能な製品のみを取得する場合は “Purchase” を使用し、ライセンス可能な製品のみを取得する場合は “License” を使用します。 その他のアクション フィルターには “Fulfill”、“Browse”、“Curate”、“Details”、“Redeem” があります。 actionFiltersCount _In_
Type: size_t actionFilters 内のフィルターの数。 async _Inout_
Type: XAsyncBlock* 実行中の非同期処理を定義する XAsyncBlock。 XAsyncBlock を使用して、呼び出しの状態を確認し、結果を取得します。 詳細については、XAsyncBlock を参照してください。
戻り値
Type: HRESULT HRESULT の成功またはエラー コード。解説
掲載情報とこの関数の実行結果を取得するには、XStoreQueryProductsResult を呼び出します。 要求内に 100 を超える storeID を指定した場合、この API は失敗します。 大きなカタログを扱う場合は、各クエリを 100 個未満の製品に制限してください。 現在のゲーム内でプレイヤーが購入可能なすべての製品の詳細を取得するには、代わりに XStoreQueryAssociatedProductsAsync を使用します。 次のコード スニペットは、現在のゲームに関連付けられた指定された製品の掲載情報を取得する例を示しています。要件
ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One 本体、および XBOX Series 本体関連概念ドキュメント
関連項目
XStore XStoreQueryProductsResultXStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
ストアの基本操作
プレイヤーにアドオン コンテンツへのアクセス権を付与する
