AppExtensionCatalog.RequestRemovePackageAsync(String) Método

Definição

Namespace:

Windows.ApplicationModel.AppExtensions

Tenta remover o pacote de extensão especificado do computador.

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)

Parâmetros

packageFullName

String

Platform::String

winrt::hstring

O nome do pacote a ser removido, que você pode obter de AppExtension.Package.Id.FullName.

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Retorna true se a solicitação para o usuário remover o pacote foi feita; caso contrário, false.

Essa função retornará false se você tentar usar um nome de pacote que não esteja associado a uma extensão na instância AppExtensionCatalog . O valor retornado não reflete se o pacote foi realmente removido ou não. Se o usuário aceitar o prompt para remover o pacote, um evento PackageUninstalling será gerado.

Atributos

RemoteAsyncAttribute

Comentários

O usuário é solicitado a permitir ou negar a remoção do pacote. Você só pode remover pacotes que contêm extensões encontradas na instância AppExtensionCatalog da qual você faz a chamada. Consulte AppExtensionCatalog::Open para obter mais detalhes.

A unidade de implantação para AppExtensions é o Pacote. Não é possível remover AppExtensions; você só pode remover Pacotes. Os pacotes podem conter várias AppExtensions.

O usuário pode não entender a relação entre AppExtensions e Packages ou entre um AppExtension e um aplicativo no computador (porque um aplicativo pode ser projetado para também servir como uma extensão). O usuário pode aceitar a solicitação para remover um pacote pensando que está apenas removendo uma extensão, mas, em seguida, descobrir que um de seus aplicativos favoritos já se foi. Use esse método somente se tiver certeza de que AppExtension é a única coisa no pacote.

Evite usar esse método se você não controlar o ecossistema de extensões envolvidas. Esse método destina-se à conveniência em um ecossistema fechado de extensões, como em um ambiente empresarial.

Ponte de Desktop hosts de extensão de aplicativo não podem usar esse método diretamente. Ponte de Desktop hosts de extensão de aplicativo devem usar seu componente Plataforma Universal do Windows para gerenciar extensões de aplicativo. Para obter mais informações, consulte Como criar um pacote MSIX a partir de seu código.

Confira também

• Criar um pacote do MSIX com base em seu código