StoreContext.GetAppAndOptionalStorePackageUpdatesAsync Metodo

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))

Valori restituiti

Operazione asincrona che, al completamento corretto, restituisce una raccolta di oggetti StorePackageUpdate che rappresentano i pacchetti con aggiornamenti disponibili.

Attributi

RemoteAsyncAttribute

Eccezioni

Commenti

Per altre informazioni sull'uso di questo metodo, incluso un esempio di codice, vedere Scaricare e installare gli aggiornamenti dei pacchetti per l'app.

Dopo aver chiamato GetAppAndOptionalStorePackageUpdatesAsync per determinare quali pacchetti hanno aggiornamenti disponibili, è possibile chiamare RequestDownloadStorePackageUpdatesAsync per scaricare i pacchetti aggiornati oppure chiamare RequestDownloadAndInstallStorePackageUpdatesAsync per scaricare e installare i pacchetti aggiornati.

Prerequisiti e requisiti dell'ambiente

Per il corretto funzionamento di questo metodo, è necessario soddisfare le condizioni seguenti:

• Microsoft Store app: l'app Microsoft Store deve essere installata e funzionante nel sistema.
• account Microsoft: mentre un account Microsoft connesso non è strettamente necessario per verificare la disponibilità di aggiornamenti, alcuni scenari potrebbero richiedere l'autenticazione.
• servizi Store: i servizi di gestione delle licenze e degli aggiornamenti Microsoft Store devono essere in esecuzione e accessibili.
• Connettivitànetwork: per comunicare con il servizio di Microsoft Store è necessaria una connessione Internet attiva.

Compatibilità della modalità di accesso assegnata

Questo metodo può essere usato in modalità Accesso assegnato (chiosco multimediale), ma si applicano le considerazioni seguenti:

• L'account di accesso assegnato deve disporre dell'autorizzazione per accedere ai servizi di Microsoft Store.
• L'accesso alla rete deve essere configurato per consentire la comunicazione con gli endpoint Microsoft Store.
• Alcuni elementi dell'interfaccia utente dello Store possono essere limitati a seconda della configurazione dell'accesso assegnato.

Consigli sulla gestione degli errori

Quando si chiama questo metodo, è consigliabile implementare una corretta gestione degli errori:

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
}

Disponibilità aggiornamenti

Dopo aver pubblicato un aggiornamento dell'app nel Centro per i partner, può verificarsi un breve ritardo tra il passaggio della certificazione del pacchetto e quando il metodo GetAppAndOptionalStorePackageUpdatesAsync riconosce che l'aggiornamento è disponibile. La maggior parte degli aggiornamenti diventa disponibile entro un paio di ore, ma alcuni passaggi di pubblicazione e distribuzione potrebbero richiedere più tempo per terminare in determinati casi.

Frequenza di rilevamento

Questa API limita la frequenza con cui controlla la presenza di nuovi aggiornamenti. Quando un'app chiama il metodo più frequentemente della frequenza consentita, il metodo restituisce l'ultimo stato noto anziché eseguire un nuovo controllo.

I limiti correnti sono:

• Non più di un controllo ogni 30 minuti.
• Non più di dieci controlli entro un periodo di 24 ore.

Se un'app supera questi limiti, il metodo continua a restituire lo stato precedente fino al termine dell'intervallo di tempo applicabile.

Vedi anche

• Scaricare e installare gli aggiornamenti dei pacchetti per l'app
• Pacchetti facoltativi e creazione di set correlati