StoreContext.UninstallStorePackageByStoreIdAsync(String) メソッド

定義

ユーザーに通知 UI ダイアログを表示せずに、現在のアプリの指定されたダウンロード可能なコンテンツ (DLC) パッケージをアンインストールします。

public:
 virtual IAsyncOperation<StoreUninstallStorePackageResult ^> ^ UninstallStorePackageByStoreIdAsync(Platform::String ^ storeId) = UninstallStorePackageByStoreIdAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StoreUninstallStorePackageResult> UninstallStorePackageByStoreIdAsync(winrt::hstring const& storeId);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StoreUninstallStorePackageResult> UninstallStorePackageByStoreIdAsync(string storeId);
function uninstallStorePackageByStoreIdAsync(storeId)
Public Function UninstallStorePackageByStoreIdAsync (storeId As String) As IAsyncOperation(Of StoreUninstallStorePackageResult)

パラメーター

storeId
String

Platform::String

winrt::hstring

現在のアプリのアンインストールする DLC パッケージに対応するアドオンのストア ID。

戻り値

正常に完了すると、アンインストール操作に関する情報を提供する StoreUninstallStorePackageResult オブジェクトを返す非同期操作。

属性

Windows の要件

デバイス ファミリ
Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Services.Store.StoreContract (v3.0 で導入)
アプリの機能
storePackageManagement

注釈

この方法を使用すると、不要になった DLC パッケージをアンインストールすることでディスク領域を解放できます。 たとえば、シングル プレイヤー キャンペーンとマルチプレイヤー キャンペーンの両方を提供するゲームでは、ユーザーがそのキャンペーンを完了した後、ユーザーの要求に応じてこの方法を使用してシングル プレイヤー キャンペーンをアンインストールできます。

注意

DLC パッケージは、すべての開発者アカウントで使用できるわけではありません。

このメソッドを呼び出すと、OS は通知ダイアログを表示せずにパッケージをサイレント モードでアンインストールします。 このメソッドを実行するには、制限付き storePackageManagement 機能が必要です。 この制限付き機能にアクセスできない場合は、代わりに RequestUninstallStorePackageAsync メソッドまたは RequestUninstallStorePackageByStoreIdAsync メソッドを使用できます (これらのメソッドは、パッケージをアンインストールするためのユーザーのアクセス許可を要求する通知ダイアログを表示します)。

注意

制限付き storePackageManagement 機能は、デスクトップ ブリッジを使用するデスクトップ アプリケーションとゲーム、および XVC パッケージを使用し、ID@Xbox プログラムなどのマネージド パートナー プログラムの一部として開発された Xbox ゲームでのみ使用できます。 これらのアプリケーションとゲームには、既定でこの機能があります。

アドオンのストア ID はパートナー センターで使用でき、アドオンを表す StoreProduct の StoreId プロパティによっても返されます。 詳細については、「 ストア ID」を参照してください。

適用対象

こちらもご覧ください