AppExtensionCatalog.RequestRemovePackageAsync(String) メソッド

定義

名前空間:

Windows.ApplicationModel.AppExtensions

指定した拡張機能パッケージをコンピューターから削除しようとします。

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

削除するパッケージの名前。 AppExtension.Package.Id.FullName から取得できます。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

パッケージの削除要求が行われた場合は true を返します。それ以外の場合は false。

AppExtensionCatalog インスタンスの拡張機能に関連付けられていないパッケージ名を使用しようとすると、この関数は false を返します。 戻り値には、パッケージが実際に削除されたかどうかは反映されません。 ユーザーがパッケージを削除するプロンプトを受け入れると、 PackageUninstalling イベントが発生します。

属性

RemoteAsyncAttribute

注釈

ユーザーは、パッケージの削除を許可または拒否するように求められます。 削除できるのは、呼び出し元の AppExtensionCatalog インスタンスにある拡張機能を含むパッケージのみです。 詳細については、「 AppExtensionCatalog::Open」 を参照してください。

AppExtensions のデプロイの単位は Package です。 AppExtensions を削除することはできません。削除できるのはパッケージのみです。 パッケージ には、複数の AppExtension が含まれている場合があります。

AppExtensions とパッケージの間、または AppExtension とマシン上のアプリの間の関係をユーザーが理解できない場合があります (アプリは拡張機能としても機能するように設計されている可能性があるため)。 ユーザーは、拡張機能のみを削除していると考えてパッケージを削除する要求を受け入れる場合がありますが、お気に入りのアプリのいずれかがなくなったことがわかります。 このメソッドは、 AppExtension がパッケージ内の唯一のものであると確信している場合にのみ使用してください。

関係する拡張機能のエコシステムを制御しない場合は、この方法を使用しないでください。 この方法は、エンタープライズ環境など、拡張機能の閉じたエコシステムの利便性を目的としています。

デスクトップ ブリッジアプリ拡張機能ホストは、このメソッドを直接使用できません。 アプリ拡張機能デスクトップ ブリッジホストは、ユニバーサル Windows プラットフォーム コンポーネントを使用してアプリ拡張機能を管理する必要があります。 詳細については、「コードからの MSIX パッケージの構築」を参照してください。

こちらもご覧ください

• コードからの MSIX パッケージの構築