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的部署單位是套件。 您無法移除 AppExtensions;您只能移除 套件。 套件 可能包含多個 AppExtensions。

使用者可能無法瞭解 AppExtensions 與 Packages之間的關聯性，或 AppExtension 與電腦上應用程式之間的關聯性， (因為應用程式可能設計為也做為延伸模組) 。 使用者可能會接受移除套件的要求，認為他們只是移除延伸模組，但發現其中一個慣用的應用程式現在已消失。 如果您確定 AppExtension 是唯一在套件中的唯一專案，才使用這個方法。

如果您未控制涉及的延伸模組生態系統，請避免使用此方法。 此方法適用于擴充功能封閉式生態系統中的便利性，例如在企業環境中。

傳統型橋接器應用程式擴充功能主機無法直接使用此方法。 傳統型橋接器應用程式擴充功能主機應該使用其通用 Windows 平臺元件來管理應用程式延伸模組。 如需詳細資訊，請參閱 從程式碼建置 MSIX 套件。

另請參閱

• 從程式碼建置 MSIX 套件