> ## 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.

# XPersistentLocalStorageGetSpaceInfo

> XPersistentLocalStorageGetSpaceInfo

# XPersistentLocalStorageGetSpaceInfo

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*info*   \_Out\_\
Tipo: [XPersistentLocalStorageSpaceInfo\*](/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo)

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

<a id="retvalSection" />

### 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).

<a id="remarksSection" />

## 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](/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo).

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](/pt-BR/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo) 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).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XPersistentLocalStorage.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## 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)\
[XPersistentLocalStorageSpaceInfo](/pt-BR/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo)


## Related topics

- [XPersistentLocalStorageGetSpaceInfo](/ja-jp/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStorageSpaceInfo](/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStorage](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)