Skip to main content

XStoreDownloadAndInstallPackagesAsync

指定されたストア パッケージをダウンロードしてインストールします。

構文

パラメーター

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

戻り値

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

解説

この関数のダウンロードおよびインストール結果を取得するには、この関数を呼び出した後に XStoreDownloadAndInstallPackagesResult を呼び出します。ダウンロードおよびインストールされた項目の数を取得するには、この関数を呼び出した後に XStoreDownloadAndInstallPackagesResultCount を呼び出します。結果カウント関数は、結果関数に渡す適切な配列サイズを決定できるようにするため重要です。 この API が実行中のゲームから呼び出されると、ダウンロードは高優先度と見なされ、この API の storeIds パラメーターで指定された順序でキューの先頭に配置されます。 次のコード スニペットは、ストア パッケージをダウンロードしてインストールする例を示しています。

要件

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

関連概念ドキュメント

関連項目

XStore
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
最終更新日 2026年8月24日