通过


AppInstallManager 类

定义

提供以编程方式安装应用的成员,包括启动应用安装并获取当前正在进行的应用安装列表。

public ref class AppInstallManager sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AppInstallManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class AppInstallManager final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AppInstallManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class AppInstallManager
function AppInstallManager()
Public NotInheritable Class AppInstallManager
继承
Object Platform::Object IInspectable AppInstallManager
属性

Windows 要求

要求 说明
设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能
runFullTrust

注解

重要

访问此 API 受专用功能保护,该功能仅限于由Microsoft开发的应用。

注释

避免在Windows“开箱即用体验”(OOBE)期间调用 AppInstallManager.StartProductInstallAsyncAppInstallManager.StartProductInstallForUserAsync

在 OOBE 完成之前发出的安装请求可能无法按预期方式执行,因为应用商店相关服务可能尚未完全初始化。

为了获得最佳结果,在首次用户登录后调用这些方法。

版本历史记录

Windows 版本 SDK 版本 已添加值
1511 10586 Cancel(字符串,字符串)
1511 10586 GetIsAppAllowedToInstallAsync(String,String,String,String,String)
1511 10586 Pause(字符串,字符串)
1511 10586 Restart(String,String)
1511 10586 SearchForAllUpdatesAsync(String)
1511 10586 SearchForUpdatesAsync(String,String,String,String)
1511 10586 StartAppInstallAsync(String,String,Boolean,Boolean,String,String,String,String)
1511 10586 UpdateAppByPackageFamilyNameAsync(String,String)
1607 14393 GetIsAppAllowedToInstallForUserAsync
1607 14393 GetIsApplicableForUserAsync
1607 14393 MoveToFrontOfDownloadQueue
1607 14393 SearchForAllUpdatesForUserAsync(User,String)
1607 14393 SearchForUpdatesForUserAsync(User,String,String,String,String,String)
1607 14393 StartProductInstallAsync(String,String,String,String,Boolean,Boolean,String,String,PackageVolume)
1607 14393 StartProductInstallForUserAsync(User,String,String,String,String,Boolean,Boolean,Boolean,String,String,PackageVolume)
1607 14393 UpdateAppByPackageFamilyNameForUserAsync
1703 15063 AppInstallItemsWithGroupSupport
1703 15063 GetFreeDeviceEntitlementAsync
1703 15063 GetFreeUserEntitlementAsync
1703 15063 GetFreeUserEntitlementForUserAsync
1803 17134 GetIsPackageIdentityAllowedToInstallAsync
1803 17134 GetIsPackageIdentityAllowedToInstallForUserAsync
1803 17134 SearchForAllUpdatesAsync(String,String,AppUpdateOptions)
1803 17134 SearchForAllUpdatesForUserAsync(User,String,String,AppUpdateOptions)
1803 17134 SearchForUpdatesAsync(String,String,String,AppUpdateOptions)
1803 17134 SearchForUpdatesForUserAsync(User,String,String,String,String,String,AppUpdateOptions)
1803 17134 StartProductInstallAsync(String,String,String,String,AppInstallOptions)
1803 17134 StartProductInstallForUserAsync(User,String,String,String,String,AppInstallOptions)
1809 17763 CanInstallForAllUsers

构造函数

名称 说明
AppInstallManager()

创建并初始化 AppInstallManager 类的新实例。

属性

名称 说明
AcquisitionIdentity

获取或设置与应用安装关联的用户标识。

AppInstallItems

检索有关当前位于安装队列中的所有应用的信息。

AppInstallItemsWithGroupSupport

检索属于当前安装队列中单个应用捆绑包的所有应用的相关信息。

AutoUpdateSetting

获取或设置当前计算机或设备上的应用的自动更新设置。

CanInstallForAllUsers

获取或设置一个值,该值指示调用应用是否具有提升的管理权限,以确保为所有用户安装应用将成功。

方法

名称 说明
Cancel(String, String)

取消指定应用的安装,并可以选择生成遥测数据。

Cancel(String)

取消指定应用的安装。

GetFreeDeviceEntitlementAsync(String, String, String)

向当前设备上的所有用户授予指定应用的免费权利。

GetFreeUserEntitlementAsync(String, String, String)

向当前用户授予指定应用的免费权利。

GetFreeUserEntitlementForUserAsync(User, String, String, String)

向指定用户授予指定应用的免费权利。

GetIsAppAllowedToInstallAsync(String, String, String, String)

确定指定的应用是否有权在当前计算机或设备上安装,以及用于生成遥测数据的选项。

GetIsAppAllowedToInstallAsync(String)

确定指定的应用是否有权在当前计算机或设备上安装。

GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String)

确定指定应用是否具有在当前计算机或设备上为指定用户安装的权限,以及用于生成遥测数据的选项。

GetIsApplicableAsync(String, String)

确定指定的应用是否可以安装在当前计算机或设备上。

GetIsApplicableForUserAsync(User, String, String)

确定指定应用是否可以安装在指定用户的当前计算机或设备上。

GetIsPackageIdentityAllowedToInstallAsync(String, String, String)

返回一个值,该值指示是否允许在当前设备上安装具有指定标识信息的包。

GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String)

返回一个值,该值指示是否允许在指定用户的当前设备上安装具有指定标识信息的包。

IsStoreBlockedByPolicyAsync(String, String)

确定指定的应用是由当前计算机或设备上的策略阻止的。

MoveToFrontOfDownloadQueue(String, String)

将指定的应用移到下载队列的前面。

Pause(String, String)

使用用于生成遥测数据的选项暂停指定应用的安装。

Pause(String)

暂停指定应用的安装。

Restart(String, String)

使用生成遥测数据的选项重启指定应用的安装。

Restart(String)

重启指定应用的安装。

SearchForAllUpdatesAsync()

搜索当前计算机或设备上安装的应用的所有可用更新。

SearchForAllUpdatesAsync(String, String, AppUpdateOptions)

搜索当前计算机或设备上安装的应用的所有可用更新,并能够允许强制应用重启以及生成遥测数据的选项。

SearchForAllUpdatesAsync(String)

使用生成遥测数据的选项搜索当前计算机或设备上安装的应用的所有可用更新。

SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions)

搜索当前计算机或设备上为指定用户安装的应用的所有可用更新,并能够允许强制应用重启以及生成遥测数据的选项。

SearchForAllUpdatesForUserAsync(User, String)

使用生成遥测数据的选项搜索当前计算机或设备上安装的应用的所有可用更新。

SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions)

搜索指定应用的更新,并能够允许强制应用重启和生成遥测数据的选项。

SearchForUpdatesAsync(String, String, String, String)

搜索指定应用的更新,并选择生成遥测数据。

SearchForUpdatesAsync(String, String)

搜索指定应用的更新。

SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions)

搜索指定应用和用户的更新,并能够允许强制应用重启以及生成遥测数据的选项。

SearchForUpdatesForUserAsync(User, String, String, String, String)

使用生成遥测数据的选项搜索指定应用和用户的更新。

StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String)

注释

请注意,该方法 AppInstallManager.StartAppInstallAsync 已正式停用。 有关所需的备用 API,请参阅 AppInstallManager 文档。

使用生成遥测数据的选项开始安装指定的应用。

StartAppInstallAsync(String, String, Boolean, Boolean)

注释

请注意,该方法 AppInstallManager.StartAppInstallAsync 已正式停用。 有关所需的备用 API,请参阅 AppInstallManager 文档。

启动指定应用的安装。

StartProductInstallAsync(String, String, String, String, AppInstallOptions)

启动指定应用或应用捆绑包的安装,并能够指定其他安装选项,例如是否允许强制应用重启。

注释

避免在Windows“开箱即用体验”(OOBE)期间调用 AppInstallManager.StartProductInstallAsyncAppInstallManager.StartProductInstallForUserAsync

在 OOBE 完成之前发出的安装请求可能无法按预期方式执行,因为应用商店相关服务可能尚未完全初始化。

为了获得最佳结果,在首次用户登录后调用这些方法。

StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume)

开始安装指定的应用或应用捆绑包。

StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions)

为指定用户启动指定应用或应用捆绑包的安装,并能够指定其他安装选项,例如是否允许强制应用重启。

注释

避免在Windows“开箱即用体验”(OOBE)期间调用 AppInstallManager.StartProductInstallAsyncAppInstallManager.StartProductInstallForUserAsync

在 OOBE 完成之前发出的安装请求可能无法按预期方式执行,因为应用商店相关服务可能尚未完全初始化。

为了获得最佳结果,在首次用户登录后调用这些方法。

StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume)

开始为指定用户安装指定的应用或应用捆绑包。

UpdateAppByPackageFamilyNameAsync(String, String)

使用生成遥测数据的选项,启动由包系列名称指定的应用的更新。

UpdateAppByPackageFamilyNameAsync(String)

启动由包系列名称指定的应用的更新。

UpdateAppByPackageFamilyNameForUserAsync(User, String, String)

使用生成遥测数据的选项,为包系列名称指定的给定用户启动应用更新。

活动

名称 说明
ItemCompleted

在应用完成安装后发生。

ItemStatusChanged

在安装队列中应用的状态已更改时发生。

适用于