StoreContext.RequestDownloadStorePackageUpdatesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Microsoft Store から現在のアプリの指定されたパッケージ更新プログラムのダウンロードを試みます。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。
重要
このメソッドは、UI スレッドで呼び出す必要があります。
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)パラメーター
- storePackageUpdates
ダウンロードする更新されたパッケージを表す StorePackageUpdate オブジェクトのセット。
戻り値
操作の進行状況と完了を追跡するために呼び出し元が観察できるオブジェクト。 正常に完了すると、結果はパッケージの更新に関する情報を提供する StorePackageUpdateResult オブジェクトになります。
- 属性
例外
例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドでメソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。
注釈
更新プログラムが利用可能なパッケージの一覧を取得するには、 GetAppAndOptionalStorePackageUpdatesAsync メソッドを 使用します。 パッケージをダウンロードしたら、 RequestDownloadAndInstallStorePackageUpdatesAsync メソッドを使用してパッケージをインストールできます。 コード例など、このメソッドの使用方法の詳細については、「 アプリのパッケージ更新プログラムをダウンロードしてインストールする」を参照してください。
この操作はブロックされません。 このメソッドによって返される IAsyncOperationWithProgress オブジェクトは、更新プログラム パッケージのダウンロード後に完了します。
このメソッドを呼び出すと、アプリの更新プログラムがダウンロード可能であることをユーザーに通知するダイアログが OS に表示され、ダウンロードを続行するためのアクセス許可がユーザーに求められます。 ユーザーがダウンロードを開始するアクセス許可を付与しない場合、StorePackageUpdateResult 戻り値の OverallState プロパティの値は Canceled になります。
Progress 通知を処理するために割り当てるメソッドは、この要求の各パッケージのダウンロード プロセスの各ステップに対して 1 回呼び出されます。 Progress ハンドラーは、 進行状況 通知を発生させた更新プログラム パッケージに関する情報を提供する StorePackageUpdateStatus 引数を受け取ります。