Skip to main content

XGameSaveSubmitBlobDelete

Adiciona uma ação de exclusão a um XGameSaveUpdate de salvamento de jogo.

Sintaxe

Parâmetros

updateContext   _In_
Tipo: XGameSaveUpdateHandle
Identificador para o XGameSaveUpdate em que o blob será excluído. blobName   _In_z_
Tipo: char*
Nome do blob a ser excluído.

Valor retornado

Tipo: HRESULT Resultado da função

Comentários

Não é seguro chamar esta função em uma 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 facilmente dados do jogo para o armazenamento persistente de maneira segura, confiável e transacional. Queremos garantir que os dados de suporte de um contêiner sejam sempre consistentes e, por isso, queremos que toda a operação seja bem-sucedida ou falhe atomicamente. Não queremos ter uma atualização parcial em que alguns dados de blob sejam inconsistentes com outros dados dentro do contêiner. Para fazer isso, fornecemos um contexto de atualização ao qual as gravações e exclusões de blob são enviadas e, quando 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. Confira os exemplos de XGameSaveCreateUpdate para saber como usar.

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
XGameSaveSubmitUpdate
XGameSaveSubmitBlobWrite
Depuração de salvamentos de jogos
Last modified on October 6, 2026