AppExtensionCatalog.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 AppExtension.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 AppExtensionCatalog-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 AppExtensionCatalog-instance Sie den Aufruf tätigen. Weitere Informationen finden Sie unter AppExtensionCatalog::Open .
Die Bereitstellungseinheit für AppExtensions ist das Paket. Sie können AppExtensions nicht entfernen. Sie können pakete nur entfernen. Pakete können mehrere AppExtensions enthalten.
Der Benutzer versteht möglicherweise nicht die Beziehung zwischen AppExtensions und Paketen oder zwischen einer AppExtension 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 appExtension 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 Einfachheit in einem geschlossenen Ökosystem von Erweiterungen, z. B. in einer Unternehmensumgebung.
Desktop-Brücke App-Erweiterungshosts können diese Methode nicht direkt verwenden. Desktop-Brücke App-Erweiterungshosts sollten ihre Universelle Windows-Plattform Komponente verwenden, um App-Erweiterungen zu verwalten. Weitere Informationen finden Sie unter Erstellen eines MSIX-Pakets aus Ihrem Code.