PackageExtensionCatalog.RequestRemovePackageAsync(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した拡張機能パッケージをコンピューターから削除しようとします。
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)パラメーター
- packageFullName
-
String
Platform::String
winrt::hstring
削除するパッケージの名前。 PackageExtension.Package.Id.FullName から取得できます。
戻り値
パッケージの削除をユーザーに要求した場合は true を返します。それ以外の場合は false。
PackageExtensionCatalog インスタンスの拡張機能に関連付けられていないパッケージ名を使用しようとすると、この関数は false を返します。 戻り値には、パッケージが実際に削除されたかどうかは反映されません。 ユーザーがパッケージを削除するプロンプトを受け入れると、 PackageUninstalling イベントが発生します。
- 属性
注釈
ユーザーは、パッケージの削除を許可または拒否するように求められます。 呼び出し元の PackageExtensionCatalog インスタンスにある拡張機能を含むパッケージのみを削除できます。
PackageExtensions の展開単位は Package です。 PackageExtensions を削除することはできません。削除できるのはパッケージのみです。 パッケージ には、複数の PackageExtension が含まれている場合があります。
PackageExtensions と Packages の間、または PackageExtension とマシン上のアプリの間の関係をユーザーが理解できない場合があります (アプリは拡張機能としても機能するように設計されている可能性があるため)。 ユーザーは、拡張機能のみを削除していると考えてパッケージを削除する要求を受け入れる可能性がありますが、その後、お気に入りのアプリのいずれかがなくなったことがわかります。 PackageExtension がパッケージ内で唯一のものであることが確実である場合にのみ、このメソッドを使用します。
関連する拡張機能のエコシステムを制御しない場合は、この方法を使用しないでください。 この方法は、エンタープライズ環境など、拡張機能の閉鎖されたエコシステムでの利便性を目的としています。
デスクトップ ブリッジ拡張ホストは、このメソッドを直接使用できません。 デスクトップ ブリッジ拡張機能ホストでは、ユニバーサル Windows プラットフォーム コンポーネントを使用してパッケージ拡張機能を管理する必要があります。 詳細については、「コードからの MSIX パッケージの構築」を参照してください。