> ## 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-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md) 結構，其中包含儲存空間詳細資料，例如
可用空間。

## 語法

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

### 參數

*info*   \_Out\_\
類型：[XPersistentLocalStorageSpaceInfo\*](https://docs.xbox.com/zh-TW/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-TW/reference/errorcodes.md)。

## 備註

如果您的遊戲使用可成長的永續性本機儲存體 (GPLS)，請使用此函式來判斷有多少可用的儲存空間。

儲存體詳細資料包含在 [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-TW/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-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md) 也會傳回
總可用空間以及實際可用的空間 (可用空間與基礎磁碟機上實際空間
兩者中的最小值)。

## 需求

**標頭：** XPersistentLocalStorage.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [XBOX 主機上的本機儲存體](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)

## 另請參閱

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


## Related topics

- [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [XPersistentLocalStorage (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStoragePromptUserForSpaceAsync](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceasync.md)
- [Xbox 主機上的本機儲存空間](https://docs.xbox.com/zh-TW/build/console-features/storage/local-storage.md)