Skip to main content

XGameSaveInitializeProviderAsync

Fournit et initialise de façon asynchrone un handle de fournisseur XGameSave.

Syntaxe

Paramètres

requestingUser   _In_
Type : XUserHandle
Handle vers un utilisateur XBOX Live. configurationId   _In_z_
Type : char*
ID de configuration de service (SCID). syncOnDemand   _In_
Type : bool
Si la valeur est true, syncOnDemand télécharge des données du service uniquement si nécessaire. Ne fonctionne pas si l’appareil est hors ligne. La valeur true peut entraîner l’affichage d’une interface utilisateur de progression de la synchronisation. async   _In_
Type : XAsyncBlock*
Contient les informations de l’appel asynchrone. Cela comprend le contexte d’appel et un appel à la fonction XGameSaveInitializeProviderResult.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Cette fonction doit être appelée avec succès avant d’utiliser les autres API XGameSave.
L’API XGameSave exige que l’ID de titre et l’ID de configuration de service (SCID) de votre titre soient
correctement configurés pour fonctionner. Pour plus d’informations sur ces ID requis, consultez Configuration des bacs à sable pour le développement XBOX Live. Votre jeu doit être activé pour XBOX Live dans Partner Center.
Si vous ne configurez pas correctement votre SCID et votre ID de titre, vos appels à l’API XSaveGame échoueront avec le code d’erreur suivant : E_GS_NO_ACCESS - 0x80830002 - L’opération a échoué, car le titre n’a pas accès aux espaces de stockage des conteneurs. Le XGameSaveProviderHandle résultant est obtenu à partir de la fonction XGameSaveInitializeProviderResult. C’est le handle que vous utiliserez pour accéder à votre XGameSaveProvider. Lorsque cette API est appelée avec syncOnDemand défini à true, elle se comporte de la même façon du point de vue de l’appelant, mais elle entraîne certaines différences de comportement dans le reste de l’API. Le XGameSaveProvider SyncOnDemand télécharge des données du service uniquement si nécessaire, mais cela comporte aussi l’inconvénient que toute opération sur un conteneur peut alors être retardée, et ce délai peut entraîner l’affichage d’une interface utilisateur de progression de la synchronisation. L’utilisation de l’une des méthodes suivantes peut forcer une synchronisation : Un autre inconvénient est que, si l’appareil est hors ligne ou a des problèmes de connectivité, l’accès au conteneur est impossible. ##Exemple
Les jeux ne peuvent pas combiner l’utilisation de XGameSaveFiles et celle de XGameSave. Les jeux doivent choisir le système de sauvegarde infonuagique qu’ils veulent utiliser. Si le jeu utilise XGameSaveFiles et appelle ensuite XGameSaveInitializeProvider, une erreur E_GS_PROVIDER_MISMATCH se produit. De même, si le jeu utilisait XGameSave et appelle ensuite XGameSaveFilesGetFolderWithUiAsync, une erreur E_GS_PROVIDER_MISMATCH se produit également.

Configuration requise

En-tête : XGameSave.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XGameSave
XGameSaveInitializeProviderResult
XGameSaveInitializeProvider
Débogage des sauvegardes de jeu
Last modified on October 6, 2026