Skip to main content

​
XPersistentLocalStoragePromptUserForSpaceAsync

Permite que os títulos solicitem aos usuários que liberem um número total solicitado de bytes do Armazenamento Local Persistente Expansível.

​
Sintaxe

​
Parâmetros

requestedBytes   _In_
Tipo: uint64_t A quantidade total de espaço que o título deseja que seja disponibilizada para uso. asyncBlock   _Inout_
Tipo: XAsyncBlock* Um XAsyncBlock para monitorar o status da chamada assíncrona.

​
Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedida; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

​
Comentários

Antes da chamada, os títulos devem verificar a disponibilidade de espaço livre usando XPersistentLocalStorageGetSpaceInfo. O resultado da solicitação deve ser verificado na função de retorno de chamada chamando XPersistentLocalStoragePromptUserForSpaceResult. Isso não garante que o usuário liberou o número de bytes solicitado; apenas que o usuário realizou uma ação. Seu jogo deve consultar novamente o espaço livre usando XPersistentLocalStorageGetSpaceInfo quando o usuário tentar novamente a operação que resultou na solicitação de espaço. O resultado da operação assíncrona será E_ABORT se o usuário optar por não liberar espaço. O Armazenamento Local Persistente não é implementado em plataformas PC. Embora presente, este método não deve ser usado no PC. Isso está desabilitado em servidores de streaming de datacenter. Sempre retornará E_ABORT quando chamado em servidores de streaming de datacenter.

​
Requisitos

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

​
Documentação conceitual

​
Confira também

XPersistentLocalStorage
Last modified on October 6, 2026