Skip to main content

XGameSaveSubmitUpdate

Envía una actualización al servicio XGameSave. Actualiza los blobs de un contenedor.

Sintaxis

Parámetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle
Identificador del XGameSaveUpdate que se va a actualizar.

Valor devuelto

Tipo: HRESULT Resultado de la función. Errores comunes
  • 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

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Debe llamar correctamente a XGameSaveCreateUpdate antes de realizar esta llamada. La parte de almacenamiento de esta API está diseñada para transferir fácilmente datos del juego al almacenamiento persistente de forma segura, fiable y transaccional. Queremos asegurarnos de que los datos de respaldo de un contenedor sean siempre coherentes y, por ello, queremos que toda la operación se realice correctamente o falle de forma atómica. No queremos tener una actualización parcial en la que algunos datos de blob sean incoherentes con otros datos del contenedor. Para ello, proporcionamos un contexto de actualización al que se envían las escrituras y eliminaciones de blobs y, cuando está listo, se envía todo el contexto. En la práctica, esto tiene el siguiente aspecto: Un XGameSaveUpdate se rellenará con acciones de escritura (Write) y eliminación (Delete) que se llevarán a cabo en los blobs del contenedor mediante XGameSaveSubmitBlobWrite y XGameSaveSubmitBlobDelete. Una actualización se completa llamando a XGameSaveSubmitUpdate. Cuando termine con un XGameSaveUpdate, ciérrelo mediante el método XGameSaveCloseUpdate. En el siguiente ejemplo de C++ se muestra una actualización sincrónica de XGameSave.

Requisitos

Encabezado: XGameSave.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
XGameSaveCloseUpdate Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026