> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPersistentLocalStoragePromptUserForSpaceAsync

> XPersistentLocalStoragePromptUserForSpaceAsync

# 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

```cpp theme={null}
HRESULT XPersistentLocalStoragePromptUserForSpaceAsync(  
         uint64_t requestedBytes,  
         XAsyncBlock* asyncBlock  
)  
```

### 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](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

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](/pt-BR/reference/errorcodes).

## Comentários

Antes da chamada, os títulos devem verificar a disponibilidade de espaço livre usando [XPersistentLocalStorageGetSpaceInfo](/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo).

O resultado da solicitação deve ser verificado na função de retorno de chamada chamando [XPersistentLocalStoragePromptUserForSpaceResult](/pt-BR/reference/system/xpersistentlocalstorage/functions/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](/pt-BR/reference/system/xpersistentlocalstorage/functions/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

* [Armazenamento local no console XBOX](/pt-BR/build/console-features/storage/local-storage)

## Confira também

[XPersistentLocalStorage](/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)


## Related topics

- [XPersistentLocalStoragePromptUserForSpaceResult](/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStorageSpaceInfo](/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStorage](/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [Armazenamento local](/pt-BR/build/console-features/storage/local-storage.md)
- [Wrappers de API C# do Unity para o GDK](/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)