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

傳回 [XPersistentLocalStorageSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo) 結構，其中包含儲存空間詳細資料，例如
可用空間。

<a id="syntaxSection" />

## 語法

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

<a id="parametersSection" />

### 參數

*info*   \_Out\_\
類型：[XPersistentLocalStorageSpaceInfo\*](/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo)

用來儲存儲存空間詳細資料的 `XPersistentLocalStorageSpaceInfo` 結構。

<a id="retvalSection" />

### 傳回值

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

如果成功，則傳回 **S\_OK**；否則傳回錯誤碼。如需錯誤碼的清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

<a id="remarksSection" />

## 備註

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

儲存體詳細資料包含在 [XPersistentLocalStorageSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo) 結構中。

儲存體詳細資料包括使用中的空間量、遊戲可用的空間量，以及是否應提示使用者
釋放空間。

請注意，呼叫
[GetDiskFreeSpaceExW ](https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-getdiskfreespaceexw)
只會告訴遊戲 PLS 中剩餘的最大可用空間量，但不保證這些空間
可供使用。
[XPersistentLocalStorageGetSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo) 也會傳回
總可用空間以及實際可用的空間 (可用空間與基礎磁碟機上實際空間
兩者中的最小值)。

<a id="requirementsSection" />

## 需求

**標頭：** XPersistentLocalStorage.h

**程式庫：** xgameruntime.lib

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

<a id="seealsoSection" />

## 概念文件

* [XBOX 主機上的本機儲存體](/zh-TW/build/console-features/storage/local-storage)

## 另請參閱

[XPersistentLocalStorage](/zh-TW/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)\
[XPersistentLocalStorageSpaceInfo](/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo)


## Related topics

- [XPersistentLocalStorageGetSpaceInfo](/ja-jp/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStorageSpaceInfo](/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)