StoreContext.RequestDownloadAndInstallStorePackagesAsync メソッド

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 オブジェクトが生成されます。

属性

RemoteAsyncAttribute

例外

注釈

このメソッドを使用して、現在のアプリの新しい DLC パッケージをダウンロードしてインストールします。 このメソッドを呼び出すと、OS によってダイアログが表示され、アプリ パッケージがダウンロードおよびインストール可能であることをユーザーに通知し、操作の続行をユーザーのアクセス許可に求めます。 ユーザーがアクセス許可を付与しない場合、StorePackageUpdateResult の戻り値の OverallState プロパティの値は Canceled になります。 通知ダイアログを表示せずにアプリ パッケージをサイレント インストールするには、 DownloadAndInstallStorePackagesAsync を使用します (このメソッドでは、制限された機能へのアクセスが必要です)。

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

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

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

こちらもご覧ください

• DownloadAndInstallStorePackagesAsync(IIterable<String>)
• オプション パッケージと関連セットの作成

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)

パラメーター

戻り値

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

属性

OverloadAttribute RemoteAsyncAttribute

例外

Windows の要件

注釈

このメソッドを使用して、現在のアプリの新しい DLC パッケージをダウンロードしてインストールします。 このオーバーロードでは、storePackageInstallOptions パラメーターの AllowForcedAppRestart プロパティを設定することで、DLC パッケージをインストールした後に OS がアプリの再起動を強制できるかどうかを指定するオプションが提供されます。

このメソッドを呼び出すと、OS によってダイアログが表示され、アプリ パッケージがダウンロードおよびインストール可能であることをユーザーに通知し、操作の続行をユーザーのアクセス許可に求めます。 ユーザーがアクセス許可を付与しない場合、StorePackageUpdateResult の戻り値の OverallState プロパティの値は Canceled になります。 通知ダイアログを表示せずにアプリ パッケージをサイレント インストールするには、 DownloadAndInstallStorePackagesAsync を使用します (このメソッドでは、制限された機能へのアクセスが必要です)。

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

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

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

こちらもご覧ください

• DownloadAndInstallStorePackagesAsync(IIterable<String>)
• オプション パッケージと関連セットの作成