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

返回一个 [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md) 结构，其中包含存储空间详细信息，例如
可用空间。

## 语法

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

### 参数

*info*   \_Out\_\
类型：[XPersistentLocalStorageSpaceInfo\*](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)

`XPersistentLocalStorageSpaceInfo` 结构，用于存储存储空间详细信息。

### 返回值

类型：[HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

如果成功，则返回 **S\_OK**；否则返回错误代码。有关错误代码列表，请参阅[错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)。

## 备注

如果你的游戏使用可扩展永久本地存储 (GPLS)，请使用此函数来确定有多少可用存储空间。

存储详细信息包含在 [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md) 结构中。

存储详细信息包括已使用的空间量、游戏可用的空间量以及是否应提示用户
释放空间。

请注意，调用
[GetDiskFreeSpaceExW](https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-getdiskfreespaceexw)
只会告诉游戏 PLS 中剩余的最大可用空间量 —— 不保证这些空间
可用。
[XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md) 还将返回
总可用空间以及有效可用空间（可用空间与底层驱动器实际
空间中的最小值）。

## 要求

**头文件：** XPersistentLocalStorage.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [XBOX 主机上的本地存储](https://docs.xbox.com/zh-CN/build/console-features/storage/local-storage.md)

## 另请参阅

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


## Related topics

- [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStorage（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/zh-CN/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [Xbox 主机上的本地存储](https://docs.xbox.com/zh-CN/build/console-features/storage/local-storage.md)