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

# XPersistentLocalStorageGetSpaceInfo

> XPersistentLocalStorageGetSpaceInfo

# XPersistentLocalStorageGetSpaceInfo

Retorna um struct [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md) com detalhes do espaço de armazenamento, como o
espaço disponível.

## Sintaxe

```cpp theme={null}
HRESULT XPersistentLocalStorageGetSpaceInfo(
         XPersistentLocalStorageSpaceInfo* info
)
```

### Parâmetros

*info*   \_Out\_\
Tipo: [XPersistentLocalStorageSpaceInfo\*](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)

A estrutura `XPersistentLocalStorageSpaceInfo`, usada para armazenar detalhes do espaço de armazenamento.

### 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](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

Use esta função para determinar quanto espaço de armazenamento está disponível se o seu título usar o Armazenamento Local Persistente Expansível (GPLS).

Os detalhes do armazenamento estão contidos na estrutura [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md).

Os detalhes do armazenamento incluem a quantidade de espaço em uso, quanto está disponível para o título e se o usuário deve ser solicitado
a liberar espaço.

Observe que chamar
[GetDiskFreeSpaceExW ](https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-getdiskfreespaceexw)
informará aos títulos apenas a quantidade máxima de espaço livre restante no PLS; não há garantia de que esse espaço estará
disponível.
[XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md) também retornará o
espaço livre total, bem como o espaço livre disponível (o mínimo entre o que está livre e o espaço
real na unidade subjacente).

## 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](https://docs.xbox.com/pt-BR/build/console-features/storage/local-storage.md)

## Confira também

[XPersistentLocalStorage](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)\
[XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)


## Related topics

- [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [XPersistentLocalStorage (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [Armazenamento local no console Xbox](https://docs.xbox.com/pt-BR/build/console-features/storage/local-storage.md)