Partager via


PackageExtensionCatalog.RequestRemovePackageAsync(String) Méthode

Définition

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 PackageExtension.Package.Id.FullName.

Retours

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

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

Attributs

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 packageExtensionCatalog instance à partir de laquelle vous effectuez l’appel.

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

L’utilisateur peut ne pas comprendre la relation entre PackageExtensions et Packages, ou entre un PackageExtension 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 constater ensuite que l’une de ses applications préférées a maintenant disparu. Utilisez cette méthode uniquement si vous êtes certain que PackageExtension est la seule chose dans le 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 à des raisons pratiques dans un écosystème fermé d’extensions, par exemple dans un environnement d’entreprise.

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

S’applique à

Voir aussi