PackageExtensionCatalog.RequestRemovePackageAsync(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Versucht, das angegebene Erweiterungspaket vom Computer zu entfernen.
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)Parameter
- packageFullName
-
String
Platform::String
winrt::hstring
Der Name des zu entfernenden Pakets, den Sie aus PackageExtension.Package.Id.FullName abrufen können.
Gibt zurück
Gibt true zurück, wenn die Anforderung an den Benutzer, das Paket zu entfernen, gestellt wurde; andernfalls false.
Diese Funktion gibt false zurück, wenn Sie versuchen, einen Paketnamen zu verwenden, der keiner Erweiterung im PackageExtensionCatalog-instance zugeordnet ist. Der Rückgabewert gibt nicht an, ob das Paket tatsächlich entfernt wurde oder nicht. Wenn der Benutzer die Aufforderung zum Entfernen des Pakets akzeptiert, wird ein PackageUninstalling-Ereignis ausgelöst.
- Attribute
Hinweise
Der Benutzer wird aufgefordert, das Entfernen des Pakets zuzulassen oder zu verweigern. Sie können nur Pakete entfernen, die Erweiterungen enthalten, die im PackageExtensionCatalog-instance Sie den Aufruf tätigen.
Die Bereitstellungseinheit für PackageExtensions ist das Paket. Sie können PackageExtensions nicht entfernen. Sie können nur Pakete entfernen. Pakete können mehrere PackageExtensions enthalten.
Der Benutzer versteht möglicherweise nicht die Beziehung zwischen PackageExtensions und Packages oder zwischen einer PackageExtension-App und einer App auf dem Computer (da eine App möglicherweise so konzipiert ist, dass sie auch als Erweiterung dient). Der Benutzer kann die Anforderung zum Entfernen eines Pakets annehmen, wenn er denkt, dass er nur eine Erweiterung entfernt, aber dann feststellen, dass eine seiner bevorzugten Apps jetzt nicht mehr vorhanden ist. Verwenden Sie diese Methode nur, wenn Sie sicher sind, dass PackageExtension das einzige Element im Paket ist.
Vermeiden Sie die Verwendung dieser Methode, wenn Sie das Ökosystem der beteiligten Erweiterungen nicht steuern. Diese Methode dient der Bequemlichkeit in einem geschlossenen Ökosystem von Erweiterungen, z. B. in einer Unternehmensumgebung.
Desktop-Brücke-Erweiterungshosts können diese Methode nicht direkt verwenden. Desktop-Brücke-Erweiterungshosts sollten ihre Universelle Windows-Plattform Komponente verwenden, um Paketerweiterungen zu verwalten. Weitere Informationen finden Sie unter Erstellen eines MSIX-Pakets aus Ihrem Code.