次の方法で共有

XStoreDownloadPackageUpdatesAsync

  • [アーティクル]

指定されたパッケージのアップデートをダウンロードしますが、インストールは行いません。 これにより、ゲームはアップデートのインストールがいつ行われるかを制御でき、ユーザーのプレイ中にゲームがシャットダウンされないようにすることができます。

構文

HRESULT XStoreDownloadPackageUpdatesAsync(  
         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 パッケージの一意の ID 文字列です。 パッケージ識別子の詳細については、「ダウンロード可能なコンテンツ (DLC) の管理とライセンス」を参照してください。

packageIdentifiersCount _In_
型: size_t

packageIdentifiers 内の識別子の数。

async _Inout_
型: XAsyncBlock*

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

戻り値

型: HRESULT

正常に実行された場合は S_OK が返され、それ以外の場合はエラー コードが返されます。

解説

この関数は、ダウンロードと更新のみを行い、インストールは行いません。 1 回の呼び出しで更新プログラムをダウンロードしてインストールするには、XStoreDownloadAndInstallPackageUpdatesAsync 関数を使用します。 この関数の結果を取得するには、この関数を呼び出した後で XStoreDownloadPackageUpdatesResult を呼び出します。 使用例については、「XStoreQueryGameAndDlcPackageUpdatesAsync」を参照してください。

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

要件

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

ライブラリ: xgameruntime.lib

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

関連項目

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync