AppExtensionCatalog.RequestRemovePackageAsync(String) Méthode

Définition

Espace de noms:

Windows.ApplicationModel.AppExtensions

Tente de supprimer le package d’extension spécifié de l’ordinateur.

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)

Paramètres

packageFullName

String

Platform::String

winrt::hstring

Nom du package à supprimer, que vous pouvez obtenir à partir de AppExtension.Package.Id.FullName.

Retours

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Retourne true si la demande de suppression du package adressée à l’utilisateur a été effectuée ; sinon, false.

Cette fonction retourne false si vous essayez d’utiliser un nom de package qui n’est pas associé à une extension dans le instance AppExtensionCatalog. La valeur de retour ne reflète pas si le package a été réellement supprimé ou non. Si l’utilisateur accepte l’invite à supprimer le package, un événement PackageUninstalling est déclenché.

Attributs

RemoteAsyncAttribute

Remarques

L’utilisateur est invité à autoriser ou à refuser la suppression du package. Vous pouvez uniquement supprimer les packages qui contiennent des extensions trouvées dans le instance AppExtensionCatalog à partir duquel vous effectuez l’appel. Pour plus d’informations , consultez AppExtensionCatalog ::Open .

L’unité de déploiement pour AppExtensions est le package. Vous ne pouvez pas supprimer AppExtensions ; vous pouvez uniquement supprimer des packages. Les packages peuvent contenir plusieurs AppExtensions.

L’utilisateur peut ne pas comprendre la relation entre AppExtensions et Packages, ou entre un AppExtension et une application sur l’ordinateur (car une application peut être conçue pour servir également d’extension). L’utilisateur peut accepter la demande de suppression d’un package en pensant qu’il ne supprime qu’une extension, mais qu’il constate ensuite que l’une de ses applications favorites a maintenant disparu. Utilisez cette méthode uniquement si vous êtes certain que AppExtension est la seule chose du package.

Évitez d’utiliser cette méthode si vous ne contrôlez pas l’écosystème des extensions impliquées. Cette méthode est destinée à faciliter la vie dans un écosystème fermé d’extensions, par exemple dans un environnement d’entreprise.

Pont du bureau hôtes d’extension d’application ne peuvent pas utiliser cette méthode directement. Pont du bureau hôtes d’extension d’application doivent utiliser leur composant plateforme Windows universelle pour gérer les extensions d’application. Pour plus d’informations, consultez Création d’un package MSIX à partir de votre code.

Voir aussi

• Génération d’un package MSIX à partir de votre code