StoreContext.GetAppAndOptionalStorePackageUpdatesAsync Méthode

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

Retours

Une opération asynchrone qui, en cas de réussite, retourne une collection d’objets StorePackageUpdate qui représentent les packages qui ont des mises à jour disponibles.

Attributs

RemoteAsyncAttribute

Exceptions

Remarques

Pour plus d’informations sur l’utilisation de cette méthode, notamment un exemple de code, consultez Télécharger et installer les mises à jour de package pour votre application.

Après avoir appelé GetAppAndOptionalStorePackageUpdatesAsync pour déterminer quels packages ont des mises à jour disponibles, vous pouvez appeler RequestDownloadStorePackageUpdatesAsync pour télécharger les packages mis à jour ou appeler RequestDownloadAndInstallStorePackageUpdatesAsync pour télécharger et installer les packages mis à jour.

Conditions préalables requises et configuration requise pour l’environnement

Pour que cette méthode fonctionne correctement, les conditions suivantes doivent être remplies :

• application Microsoft Store : l’application Microsoft Store doit être installée et fonctionnelle sur le système.
• compte Microsoft : bien qu’un compte Microsoft connecté ne soit pas strictement requis pour vérifier les mises à jour, certains scénarios peuvent nécessiter une authentification.
• services Store : les services de licence et de mise à jour Microsoft Store doivent être en cours d’exécution et accessibles.
• connectivité Network : une connexion Internet active est requise pour communiquer avec le service Microsoft Store.

Compatibilité du mode d’accès affecté

Cette méthode peut être utilisée en mode Accès affecté (plein écran), mais les considérations suivantes s’appliquent :

• Le compte d’accès affecté doit avoir l’autorisation d’accéder aux services Microsoft Store.
• L’accès réseau doit être configuré pour autoriser la communication avec des points de terminaison Microsoft Store.
• Certains éléments de l’interface utilisateur du Windows Store peuvent être restreints en fonction de la configuration d’accès attribuée.

Recommandations relatives à la gestion des erreurs

Lors de l’appel de cette méthode, il est recommandé d’implémenter une gestion des erreurs appropriée :

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é des mises à jour

Après avoir publié une mise à jour d’application dans l’Espace partenaires, il peut y avoir un court délai entre le moment où le package passe la certification et lorsque la méthode GetAppAndOptionalStorePackageUpdatesAsync reconnaît que la mise à jour est disponible. La plupart des mises à jour deviennent disponibles dans quelques heures, mais certaines étapes de publication et de distribution peuvent prendre plus de temps pour se terminer dans certains cas.

Fréquence de détection

Cette API limite la fréquence à laquelle elle recherche les nouvelles mises à jour. Lorsqu’une application appelle la méthode plus fréquemment que le taux autorisé, la méthode retourne le dernier état connu au lieu d’effectuer une nouvelle vérification.

Les limites actuelles sont :

• Pas plus d’une vérification toutes les 30 minutes.
• Pas plus de dix vérifications au cours d’une période de 24 heures.

Si une application dépasse ces limites, la méthode continue de retourner l’état précédent jusqu’à ce que la fenêtre de temps applicable passe.

Voir aussi

• Télécharger et installer des mises à jour de package pour votre application
• Création de packages facultatifs et d’ensembles associés