Skip to main content

XStoreQueryPackageUpdatesAsync

引数で指定されたパッケージの利用可能な更新の一覧を取得します。このリストを使用して、更新をダウンロードしてインストールします。

構文

パラメーター

storeContextHandle   _In_
Type: XStoreContextHandle
XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Type: char**
パッケージ識別子文字列のリスト。 パッケージ識別子は、Microsoft Store からのパッケージを一意に識別します。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理とライセンスを参照してください。 packageIdentifiersCount   _In_
Type: size_t
packageIdentifiers 内の識別子の数。 async   _Inout_
Type: XAsyncBlock*
非同期処理を定義する XAsyncBlockXAsyncBlock を使用して、呼び出しの状態のポーリングと呼び出し結果の取得を行います。詳細については、XAsyncBlock を参照してください。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。

解説

現在実行中のゲームのパッケージ識別子を取得するには、XPackageGetCurrentProcessPackageIdentifier を使用するか、XPackageEnumeratePackages を使用して DLC および関連ゲームのパッケージ識別子を取得します。 利用可能な更新の一覧とこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreQueryPackageUpdatesResult を呼び出します。取得する更新の数を取得するには、この関数を呼び出した後に XStoreQueryPackageUpdatesResultCount を呼び出します。結果カウント関数は、結果関数に渡す適切な配列サイズを決定できるようにするため重要です。 次のコード スニペットは、指定されたパッケージのゲーム更新およびオプション更新を取得する例を示しています。

要件

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

関連概念ドキュメント

関連項目

XStore
XStoreQueryPackageUpdatesResult
XStoreQueryPackageUpdatesResultCount
最終更新日 2026年8月24日