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

XStoreDownloadPackageUpdatesAsync

XBOX では更新はダウンロードされると同時にインストールされるため、この API は意図したとおりに動作しません。 更新がゲームのものである場合、ゲームは終了します。 更新が DLC のものである場合、その DLC パッケージが現在マウントされていると、ゲームは終了します。代わりに XStoreDownloadAndInstallPackageUpdatesAsync を使用してください。
指定されたパッケージの更新を、インストールせずにダウンロードします。これにより、ゲームで更新のインストールのタイミングを制御できるため、ユーザーのプレイ中にゲームがシャットダウンされるのを防ぐことができます。

構文

パラメーター

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

戻り値

Type: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

解説

この関数は更新をダウンロードするだけで、インストールは行いません。1 回の呼び出しで更新のダウンロードとインストールを行うには、XStoreDownloadAndInstallPackageUpdatesAsync 関数を使用します。この関数の結果を取得するには、この関数を呼び出した後に XStoreDownloadPackageUpdatesResult を呼び出します。使用例については、XStoreQueryGameAndDlcPackageUpdatesAsync を参照してください。 この API を実行中のゲームから呼び出すと、ダウンロードは高優先度として扱われ、この API の storeIds パラメーターで指定された順序でキューの先頭に配置されます。

要件

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

関連項目

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
最終更新日 2026年10月19日