Skip to main content

XGameSaveSubmitUpdate

Soumet une mise à jour au service XGameSave. Met à jour les blobs d’un conteneur.

Syntaxe

Paramètres

updateContext   _In_
Type : XGameSaveUpdateHandle
Handle vers le XGameSaveUpdate à mettre à jour.

Valeur de retour

Type : HRESULT Résultat de la fonction. Erreurs courantes
  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_OUT_OF_LOCAL_STORAGE
  • E_GS_UPDATE_TOO_BIG
  • E_GS_QUOTA_EXCEEDED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Vous devez avoir appelé avec succès XGameSaveCreateUpdate avant d’effectuer cet appel. La partie stockage de cette API est conçue pour transférer facilement les données du jeu vers un stockage persistant de manière sûre, fiable et transactionnelle. Nous voulons garantir que les données sous-jacentes d’un conteneur restent toujours cohérentes ; c’est pourquoi l’opération entière doit réussir ou échouer de manière atomique. Nous ne voulons pas de mise à jour partielle dans laquelle certaines données de blob seraient incohérentes avec d’autres données du conteneur. Pour ce faire, nous fournissons un contexte de mise à jour auquel les écritures et suppressions de blobs sont soumises, puis, lorsqu’il est prêt, le contexte entier est soumis. En pratique, cela se présente comme suit : Un XGameSaveUpdate est rempli d’actions d’écriture (Write) et de suppression (Delete) à effectuer sur les blobs du conteneur au moyen de XGameSaveSubmitBlobWrite et XGameSaveSubmitBlobDelete. Une mise à jour est finalisée en appelant XGameSaveSubmitUpdate. Lorsque vous avez terminé avec un XGameSaveUpdate, fermez-le à l’aide de la méthode XGameSaveCloseUpdate. L’exemple C++ suivant illustre une mise à jour XGameSave synchrone.

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
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
XGameSaveCloseUpdate Débogage des sauvegardes de jeu
Last modified on October 6, 2026