StoreContext.GetAppAndOptionalStorePackageUpdatesAsync メソッド

public:
 virtual IAsyncOperation<IVectorView<StorePackageUpdate ^> ^> ^ GetAppAndOptionalStorePackageUpdatesAsync() = GetAppAndOptionalStorePackageUpdatesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

function getAppAndOptionalStorePackageUpdatesAsync()

Public Function GetAppAndOptionalStorePackageUpdatesAsync () As IAsyncOperation(Of IReadOnlyList(Of StorePackageUpdate))

返品

正常に完了すると、更新プログラムが利用可能なパッケージを表す StorePackageUpdate オブジェクトのコレクションを返す非同期操作。

属性

RemoteAsyncAttribute

例外

注釈

コード例を含め、このメソッドの使用方法の詳細については、「 アプリのパッケージ更新プログラムをダウンロードしてインストールする」を参照してください。

GetAppAndOptionalStorePackageUpdatesAsync を呼び出して、利用可能な更新プログラムを持つパッケージを特定した後、 RequestDownloadStorePackageUpdatesAsync を呼び出して更新されたパッケージをダウンロードするか 、RequestDownloadAndInstallStorePackageUpdatesAsync を呼び出して更新されたパッケージをダウンロードしてインストールできます。

前提条件と環境の要件

このメソッドを正しく機能させるには、次の条件を満たす必要があります。

• Microsoft Store app: Microsoft Store アプリをシステムにインストールして機能する必要があります。
• Microsoft アカウント: サインインMicrosoft アカウントが更新プログラムを確認するために厳密に必要なわけではありませんが、一部のシナリオでは認証が必要になる場合があります。
• Store サービス: Microsoft Storeライセンスサービスと更新サービスが実行され、アクセス可能である必要があります。
• Network 接続: Microsoft Store サービスと通信するには、アクティブなインターネット接続が必要です。

割り当てられたアクセス モードの互換性

この方法は割り当てアクセス (キオスク) モードで使用できますが、次の考慮事項が適用されます。

• 割り当てられたアクセス アカウントには、Microsoft Store サービスにアクセスするためのアクセス許可が必要です。
• Microsoft Store エンドポイントとの通信を許可するようにネットワーク アクセスを構成する必要があります。
• 一部のストア UI 要素は、割り当てられたアクセス構成に応じて制限される場合があります。

エラー処理に関する推奨事項

このメソッドを呼び出すときは、適切なエラー処理を実装することをお勧めします。

try
{
    var updates = await storeContext.GetAppAndOptionalStorePackageUpdatesAsync();
    // Process updates
}
catch (System.Runtime.InteropServices.COMException ex)
{
    // Handle COM-related errors (e.g., threading issues)
}
catch (System.Exception ex)
{
    // Handle Store service errors (e.g., service unavailable)
    // Log the error and implement appropriate retry logic
}

更新の可用性

パートナー センターでアプリの更新プログラムを発行した後、パッケージが認定に合格してから、GetAppAndOptionalStorePackageUpdatesAsync メソッドが更新プログラムが利用可能であると認識するまでに、少し時間がかかる場合があります。 ほとんどの更新プログラムは 2 時間以内に利用可能になりますが、一部の公開と配布の手順は、特定のケースで完了するまでに時間がかかる場合があります。

検出頻度

この API は、新しい更新プログラムをチェックする頻度を制限します。 アプリが許可されたレートよりも頻繁にメソッドを呼び出すと、メソッドは新しいチェックを実行するのではなく、最後の既知の状態を返します。

現在の制限は次のとおりです。

• 30 分ごとに複数のチェックを行う必要はありません。
• 24 時間以内に 10 回以下のチェックを行います。

アプリがこれらの制限を超えた場合、メソッドは、該当する時間枠が経過するまで前の状態を返し続けます。

こちらもご覧ください

• アプリのパッケージ更新プログラムをダウンロードしてインストールする
• オプション パッケージと関連セットの作成