Skip to main content

XGameSaveGetRemainingQuotaAsync

Retorna de forma assíncrona a quantidade de dados disponível para armazenamento usando a API XGameSave.

Sintaxe

Parâmetros

provider   _In_
Tipo: XGameSaveProviderHandle
Identificador para o XGameSaveProvider cujos dados restantes serão consultados. async   _In_
Tipo: XAsyncBlock*
AsyncBlock que contém o contexto de chamada e a função de retorno de chamada.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

O resultado e a cota restante são recuperados da função XGameSaveGetRemainingQuotaResult. Cada aplicativo tem uma cota de quantos dados pode salvar para um usuário; se ela for excedida, qualquer tentativa de salvar mais dados poderá falhar com E_GS_QUOTA_EXCEEDED. Como esse não é um tamanho fixo, expusemos o acesso à cota restante para que o aplicativo possa tentar evitar falhas E_GS_QUOTA_EXCEEDED. Para fornecer uma visão precisa, sempre garantimos que quaisquer gravações, atualizações ou exclusões pendentes sejam tratadas primeiro antes de retornar, pois qualquer uma delas pode alterar a cota restante.

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