XStoreDownloadPackageUpdatesAsync
指定されたパッケージの更新をダウンロードしますが、インストールは行いません。これにより、ゲームは更新のインストールが発生するタイミングを制御でき、ユーザーのプレイ中にゲームがシャットダウンするのを防ぐことができます。構文
パラメーター
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 本体関連項目
XStoreXStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync