Skip to main content

XGameSaveSubmitUpdate

Envia uma atualização para o serviço XGameSave. Atualiza blobs dentro de um contêiner.

Sintaxe

Parâmetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle
Um identificador para o XGameSaveUpdate a ser atualizado.

Valor retornado

Tipo: HRESULT Resultado da função. Erros comuns
  • 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

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Você precisa chamar XGameSaveCreateUpdate com êxito antes de fazer esta chamada. A parte de armazenamento desta API foi projetada para transferir dados facilmente do jogo para o armazenamento persistente de maneira segura, confiável e transacional. Queremos garantir que os dados de suporte de um contêiner estejam sempre consistentes e, por isso, queremos que toda a operação seja bem-sucedida ou falhe atomicamente. Não queremos uma atualização parcial em que alguns dados de blob fiquem inconsistentes com outros dados dentro do contêiner. Para isso, fornecemos um contexto de atualização ao qual as gravações e exclusões de blobs são enviadas e, quando ele estiver pronto, todo o contexto é enviado. Na prática, isso funciona da seguinte forma: Um XGameSaveUpdate será preenchido com ações de gravação e exclusão a serem executadas em blobs dentro do contêiner por meio de XGameSaveSubmitBlobWrite e XGameSaveSubmitBlobDelete. Uma atualização é concluída chamando XGameSaveSubmitUpdate. Quando terminar de usar um XGameSaveUpdate, feche-o usando o método XGameSaveCloseUpdate. O exemplo de C++ a seguir demonstra uma atualização síncrona do XGameSave.

Requisitos

Cabeçalho: XGameSave.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
XGameSaveCloseUpdate Depuração de salvamentos de jogos
Last modified on October 6, 2026