StoreContext.DownloadAndInstallStorePackagesAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Services.Store
編集

ユーザーに通知 UI ダイアログを表示せずに、Microsoft Store から現在のアプリの指定されたダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールします。

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ DownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = DownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function downloadAndInstallStorePackagesAsync(storeIds)
Public Function DownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

パラメーター

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

現在のアプリ用にインストールする DLC パッケージに対応するアドオンのストア ID。

戻り値

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

操作の進行状況と完了を追跡するために呼び出し元が観察できるオブジェクト。 正常に完了すると、結果はパッケージの更新に関する情報を提供する StorePackageUpdateResult オブジェクトになります。

属性
RemoteAsyncAttribute

Windows の要件

デバイス ファミリ
Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Services.Store.StoreContract (v3.0 で導入)
アプリの機能
storePackageManagement

注釈

現在のアプリの新しい DLC パッケージをダウンロードしてインストールするには、この方法を使用します。 このメソッドを呼び出すと、OS は通知ダイアログを表示せずにパッケージをサイレント モードでダウンロードしてインストールします。 このメソッドを実行するには、制限付き storePackageManagement 機能が必要です。 この制限された機能にアクセスできない場合は、代わりに RequestDownloadAndInstallStorePackagesAsync メソッドを使用できます (これらのメソッドには、パッケージをインストールするためのユーザーのアクセス許可を要求する通知ダイアログが表示されます)。

Note

DLC パッケージは、すべての開発者アカウントで使用できるわけではありません。

Note

制限付き storePackageManagement 機能は、デスクトップ ブリッジを使用するデスクトップ アプリケーションとゲーム、および XVC パッケージを使用し、ID@Xbox プログラムなどのマネージド パートナー プログラムの一部として開発された Xbox ゲームでのみ使用できます。 これらのアプリケーションとゲームには、既定でこの機能があります。

アドオンのストア ID はパートナー センターで使用でき、DLC アドオンを表す StoreProduct の StoreId プロパティによっても返されます。 詳細については、「 ストア ID」を参照してください。

この操作はブロックされません。 このメソッドによって返される IAsyncOperationWithProgress オブジェクトは、パッケージをダウンロードしてインストールした後に完了します。

進行状況通知を処理するために割り当てるメソッドは、この要求の各パッケージのダウンロードおよびインストール プロセスの各ステップに対して 1 回呼び出されます。 Progress ハンドラーは、 進行状況 通知を発生させたパッケージに関する情報を提供する StorePackageUpdateStatus 引数を受け取ります。

適用対象

こちらもご覧ください