次の方法で共有

XStoreDownloadAndInstallPackageUpdatesAsync

  • [アーティクル]

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

構文

HRESULT XStoreDownloadAndInstallPackageUpdatesAsync(  
         const XStoreContextHandle storeContextHandle,  
         const char** packageIdentifiers,  
         size_t packageIdentifiersCount,  
         XAsyncBlock* async  
)

パラメーター

storeContextHandle _In_
型: XStoreContextHandle

XStoreCreateContext によって返されるユーザーの Microsoft Store コンテキスト ハンドル。

packageIdentifiers _In_z_count_(packageIdentifiersCount)
型: char**

パッケージ ID 文字列のリスト。 パッケージ ID は、Microsoft Store からパッケージを一意に識別します。 パッケージ識別子の詳細については、「ダウンロード可能なコンテンツ (DLC) の管理とライセンス」を参照してください。

packageIdentifiersCount _In_
型: size_t

packageIdentifiers 内の識別子の数。

async _Inout_
型: XAsyncBlock*

行われている非同期処理が定義されている XAsyncBlock。 XAsyncBlock を使用して、呼び出しのステータスをポーリングし、呼び出しの結果を取得できます。 詳細については、「XAsyncBlock」を参照してください。

戻り値

型: HRESULT

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

解説

この関数は、指定された Microsoft Store パッケージの更新をダウンロードしてインストールします。 インストールせずに更新をダウンロードする場合は、XStoreDownloadPackageUpdatesAsync を呼び出します。 インストールせずにダウンロードすることは、ゲームの実行中にゲームプレイの邪魔にならないようにする場合に役立ちます。 更新のダウンロードとインストールの結果を取得するには、この関数を呼び出した後で、XStoreDownloadAndInstallPackageUpdatesResult を呼び出します。 使用例については、「XStoreQueryGameAndDlcPackageUpdatesAsync」を参照してください。

この API が実行中のゲームから呼び出される場合、ダウンロードは高い優先順位とみなされ、この API の storeIds パラメーターで指定された順序でキューの先頭に置かれます。

要件

ヘッダー: XStore.h (XGameRuntime.h に含まれます)

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XStore
XStoreDownloadAndInstallPackageUpdatesResult
XStoreDownloadPackageUpdatesAsync