PackageExtensionCatalog.RequestRemovePackageAsync(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 PackageExtension.Package.Id.FullName.
Retornos
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 PackageExtensionCatalog . 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
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 PackageExtensionCatalog da qual você faz a chamada.
A unidade de implantação para PackageExtensions é o Pacote. Não é possível remover PackageExtensions; você só pode remover Pacotes. Os pacotes podem conter várias PackageExtensions.
O usuário pode não entender a relação entre PackageExtensions e Packages ou entre um PackageExtension 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 PackageExtension é 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 não podem usar esse método diretamente. Ponte de Desktop hosts de extensão devem usar seu componente Plataforma Universal do Windows para gerenciar extensões de pacote. Para obter mais informações, consulte Como criar um pacote MSIX a partir de seu código.