StoreContext.RequestDownloadAndInstallStorePackagesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Microsoft Store から、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
指定したインストール オプションを使用して、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージを Microsoft Store からダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Microsoft Store から、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージをダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。
重要
このメソッドは UI スレッドで呼び出す必要があります。
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function requestDownloadAndInstallStorePackagesAsync(storeIds)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)パラメーター
戻り値
呼び出し元が操作の進行状況と完了を追跡するために観察できるオブジェクト。 正常に完了すると、パッケージの更新に関する情報を提供する StorePackageUpdateResult オブジェクトが生成されます。
- 属性
例外
例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。
注釈
このメソッドを使用して、現在のアプリの新しい DLC パッケージをダウンロードしてインストールします。 このメソッドを呼び出すと、OS によってダイアログが表示され、アプリ パッケージがダウンロードおよびインストール可能であることをユーザーに通知し、操作の続行をユーザーのアクセス許可に求めます。 ユーザーがアクセス許可を付与しない場合、StorePackageUpdateResult の戻り値の OverallState プロパティの値は Canceled になります。 通知ダイアログを表示せずにアプリ パッケージをサイレント インストールするには、 DownloadAndInstallStorePackagesAsync を使用します (このメソッドでは、制限された機能へのアクセスが必要です)。
DLC アドオンのストア ID はパートナー センターで使用でき、DLC アドオンを表す StoreProduct の StoreId プロパティによっても返されます。 詳細については、「 ストア ID」を参照してください。
この操作はブロックされません。 このメソッドによって返される IAsyncOperationWithProgress オブジェクトは、パッケージのダウンロードとインストール後に完了します。
進行状況通知を処理するために割り当てるメソッドは、この要求の各パッケージのダウンロードおよびインストール プロセスの各ステップに対して 1 回呼び出されます。 Progress ハンドラーは、進行状況通知を発生させたパッケージに関する情報を提供する StorePackageUpdateStatus 引数を受け取ります。
注意
ダウンロード可能なコンテンツ (DLC) パッケージは、すべての開発者アカウントで使用できるわけではありません。
こちらもご覧ください
適用対象
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
指定したインストール オプションを使用して、現在のアプリの指定したダウンロード可能コンテンツ (DLC) パッケージを Microsoft Store からダウンロードしてインストールしようとします。 このメソッドは、操作のアクセス許可を要求する UI ダイアログも表示します。
重要
このメソッドは UI スレッドで呼び出す必要があります。
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)パラメーター
- storePackageInstallOptions
- StorePackageInstallOptions
操作のインストール オプションを指定する オブジェクト。
戻り値
呼び出し元が操作の進行状況と完了を追跡するために観察できるオブジェクト。 正常に完了すると、パッケージの更新に関する情報を提供する StorePackageUpdateResult オブジェクトが生成されます。
- 属性
例外
例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。
Windows の要件
| デバイス ファミリ |
Windows 10, version 1803 (10.0.17134.0 で導入)
|
| API contract |
Windows.Services.Store.StoreContract (v3.0 で導入)
|
注釈
このメソッドを使用して、現在のアプリの新しい DLC パッケージをダウンロードしてインストールします。 このオーバーロードでは、storePackageInstallOptions パラメーターの AllowForcedAppRestart プロパティを設定することで、DLC パッケージをインストールした後に OS がアプリの再起動を強制できるかどうかを指定するオプションが提供されます。
このメソッドを呼び出すと、OS によってダイアログが表示され、アプリ パッケージがダウンロードおよびインストール可能であることをユーザーに通知し、操作の続行をユーザーのアクセス許可に求めます。 ユーザーがアクセス許可を付与しない場合、StorePackageUpdateResult の戻り値の OverallState プロパティの値は Canceled になります。 通知ダイアログを表示せずにアプリ パッケージをサイレント インストールするには、 DownloadAndInstallStorePackagesAsync を使用します (このメソッドでは、制限された機能へのアクセスが必要です)。
DLC アドオンのストア ID はパートナー センターで使用でき、DLC アドオンを表す StoreProduct の StoreId プロパティによっても返されます。 詳細については、「 ストア ID」を参照してください。
この操作はブロックされません。 このメソッドによって返される IAsyncOperationWithProgress オブジェクトは、パッケージのダウンロードとインストール後に完了します。
進行状況通知を処理するために割り当てるメソッドは、この要求の各パッケージのダウンロードおよびインストール プロセスの各ステップに対して 1 回呼び出されます。 Progress ハンドラーは、進行状況通知を発生させたパッケージに関する情報を提供する StorePackageUpdateStatus 引数を受け取ります。
注意
DLC パッケージは、すべての開発者アカウントで使用できるわけではありません。