StoreContext.DownloadAndInstallStorePackagesAsync 方法

定义

从 Microsoft Store 下载并安装当前应用的指定可下载内容 (DLC) 包,而无需向用户显示通知 UI 对话框。

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>

加载项的应用商店 ID,对应于要为当前应用安装的 DLC 包。

返回

一个 对象,调用方可以观察该对象来跟踪操作的进度和完成情况。 成功完成后,结果为 StorePackageUpdateResult 对象,该对象提供有关包更新的信息。

属性

Windows 要求

设备系列
Windows 10, version 1803 (在 10.0.17134.0 中引入)
API contract
Windows.Services.Store.StoreContract (在 v3.0 中引入)
应用功能
storePackageManagement

注解

使用此方法下载并安装当前应用的新 DLC 包。 调用此方法时,OS 会以无提示方式下载并安装包,而不会显示通知对话框。 此方法需要受限的 storePackageManagement 功能才能执行此操作。 如果无权访问此受限功能,则可以改用 RequestDownloadAndInstallStorePackagesAsync 方法, (这些方法显示一个通知对话框,请求用户) 安装包的权限。

注意

DLC 包并非对所有开发人员帐户都可用。

注意

受限 storePackageManagement 功能仅适用于使用 桌面桥 的桌面应用程序和游戏,以及使用 XVC 程序包且作为托管合作伙伴计划的一部分开发的 Xbox 游戏,例如ID@Xbox计划。 默认情况下,这些应用程序和游戏具有此功能。

加载项的应用商店 ID 在合作伙伴中心中提供,并且它也由代表 DLC 加载项的 StoreProduct 的 StoreId 属性返回。 有关详细信息,请参阅 应用商店 ID

此操作不会阻止。 此方法返回的 IAsyncOperationWithProgress 对象将在下载并安装包后完成。

对于此请求中每个包的下载和安装过程中的每个步骤,将调用分配给处理 进度 通知的方法一次。 Progress 处理程序接收 StorePackageUpdateStatus 参数,该参数提供有关引发进度通知的包的信息。

适用于

另请参阅