AppExtensionCatalog.RequestRemovePackageAsync(String) 方法

定义

命名空间:

Windows.ApplicationModel.AppExtensions

尝试从计算机中删除指定的扩展包。

public:
 virtual IAsyncOperation<bool> ^ RequestRemovePackageAsync(Platform::String ^ packageFullName) = RequestRemovePackageAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> RequestRemovePackageAsync(winrt::hstring const& packageFullName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> RequestRemovePackageAsync(string packageFullName);

function requestRemovePackageAsync(packageFullName)

Public Function RequestRemovePackageAsync (packageFullName As String) As IAsyncOperation(Of Boolean)

参数

packageFullName

String

Platform::String

winrt::hstring

要删除的包的名称，可从 AppExtension.Package.Id.FullName 获取。

返回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

如果向用户发出删除包的请求，则返回 true ;否则为 false。

如果尝试使用与 AppExtensionCatalog 实例中的扩展不关联的包名称，此函数将返回 false。 返回值不反映包是否实际被删除。 如果用户接受删除包的提示，则会引发 PackageUninstalling 事件。

属性

RemoteAsyncAttribute

注解

系统会提示用户允许或拒绝删除包。 只能删除包含从其进行调用的 AppExtensionCatalog 实例中找到的扩展的包。 有关详细信息，请参阅 AppExtensionCatalog：：Open 。

AppExtensions 的部署单元是 Package。 不能删除 AppExtensions;只能删除 包。 包 可能包含多个 AppExtension。

用户可能不了解 AppExtensions 和 Packages 之间的关系，或者无法理解 AppExtension 与计算机上的应用之间的关系 (，因为应用可能设计为同时用作扩展) 。 用户可能会接受删除包的请求，认为他们只是删除了一个扩展，但随后发现他们最喜欢的应用之一现已消失。 仅当确定 AppExtension 是包中唯一的内容时，才使用此方法。

如果不控制所涉及的扩展生态系统，请避免使用此方法。 此方法旨在方便扩展的封闭生态系统，例如在企业环境中。

桌面桥应用扩展主机不能直接使用此方法。 桌面桥应用扩展主机应使用其通用 Windows 平台组件来管理应用扩展。 有关详细信息，请参阅从代码生成 MSIX 包。

另请参阅

• 基于代码生成 MSIX 程序包